adjust-icon

Web SDK 連携ガイド

Adjust Web SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをWebアプリで記録できます。このガイドでは、Adjust SDKをアプリに実装する方法をご紹介します。

1. プロジェクトにSDKを追加する

まずは、WebアプリにSDKを追加します。Adjust SDKは、CommonJSとAMD（Asynchronous Module Definition）の両方の環境で動作します。CDN（Content Delivery Network）を利用して読み込むと、グローバルのAdjust名前空間を介してアクセスできます。

CDNを使用する

CDNを利用してSDKを読み込むときは、本番用ビルドには縮小バージョンを使用する必要があります。

  • バージョンを指定するには、https://cdn.adjust.com/adjust-5.7.0.min.jsのようにCDNターゲットに追加します。
  • 最新バージョンを読み込むには、次のようにadjust-latestパッケージを使用してください：https://cdn.adjust.com/adjust-latest.min.js 。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。

CDNを利用してSDKを読み込むには、Webアプリの<head>タグ間に次のスニペットを追加します。

<script type="application/javascript">
!function(t,r,e,a,n,o,i,l,c,s,d,h,u){var f=i+"_q",m=i+"_c";t[i]=t[i]||{},t[f]=t[f]||[],t[m]=t[m]||[];for(let r=0;r<l.length;r++)d(t[i],t[f],l[r]);for(let r=0;r<c.length;r++){var g,b=c[r][0],p=c[r][1];t[i][b]=function(...r){return g=this,t[m].push((function(){g[s]=new t[i][b](...r)})),g};for(let r=0;r<p.length;r++){const e=p[r];t[i][b].prototype[e]=function(...r){t[m].push((function(){g[s][e](...r)}))}}}h=r.createElement(e),u=r.getElementsByTagName(e)[0],h.async=!0,h.src="https://cdn.adjust.com/adjust-latest.min.js",h.onload=function(){for(var r=0;r<t[m].length;r++)t[m][r]();t[m]=[];for(r=0;r<t[f].length;r++)t[f][r][1][0][s]?t[i][t[f][r][0]](t[f][r][1][0][s]):t[i][t[f][r][0]].apply(t[i],t[f][r][1]);t[f]=[]},u.parentNode.insertBefore(h,u)}(window,document,"script",0,0,0,"Adjust",["initSdk","getAttribution","getWebUUID","waitForAttribution","waitForWebUUID","setReferrer","trackEvent","addGlobalCallbackParameters","addGlobalPartnerParameters","removeGlobalCallbackParameter","removeGlobalPartnerParameter","clearGlobalCallbackParameters","clearGlobalPartnerParameters","switchToOfflineMode","switchBackToOnlineMode","stop","restart","gdprForgetMe","disableThirdPartySharing","trackThirdPartySharing","initSmartBanner","showSmartBanner","hideSmartBanner"],[["ThirdPartySharing",["addGranularOption","addPartnerSharingSetting"]]],"__realObj",(function(t,r,e){t[e]=function(){r.push([e,arguments])}}));
</script>

Adjust SDKはページごとに読み込まれ、ページの読み込みごとに1回起動されます。

サブリソース完全性

XSS（クロスサイトスクリプティング）攻撃を緩和するために、サブリソース完全性チェックを使用します。実行前にパッケージを検証するには、次のコールを使用します（追加のcrossOrigin、 integrity、およびエンコードされたハッシュにご留意ください）。

<script type="application/javascript">
!function(t,r,e,a,n,o,i,l,s,c,d,h,u){var f=i+"_q",g=i+"_c";t[i]=t[i]||{},t[f]=t[f]||[],t[g]=t[g]||[];for(let r=0;r<l.length;r++)d(t[i],t[f],l[r]);for(let r=0;r<s.length;r++){var m,b=s[r][0],p=s[r][1];t[i][b]=function(...r){return m=this,t[g].push((function(){m[c]=new t[i][b](...r)})),m};for(let r=0;r<p.length;r++){const e=p[r];t[i][b].prototype[e]=function(...r){t[g].push((function(){m[c][e](...r)}))}}}h=r.createElement(e),u=r.getElementsByTagName(e)[0],h.async=!0,h.src="https://cdn.adjust.com/adjust-latest.min.js",o&&(h.crossOrigin="anonymous",h.integrity=o),h.onload=function(){for(var r=0;r<t[g].length;r++)t[g][r]();t[g]=[];for(r=0;r<t[f].length;r++)t[f][r][1][0][c]?t[i][t[f][r][0]](t[f][r][1][0][c]):t[i][t[f][r][0]].apply(t[i],t[f][r][1]);t[f]=[]},u.parentNode.insertBefore(h,u)}(window,document,"script",0,0,"sha384-WE6fJqvcE0mjcC/fPYooIQAOhsHpTDVYjC52i6Asn3LECEpjHyI5zUwD8/5esthg","Adjust",["initSdk","getAttribution","getWebUUID","waitForAttribution","waitForWebUUID","setReferrer","trackEvent","addGlobalCallbackParameters","addGlobalPartnerParameters","removeGlobalCallbackParameter","removeGlobalPartnerParameter","clearGlobalCallbackParameters","clearGlobalPartnerParameters","switchToOfflineMode","switchBackToOnlineMode","stop","restart","gdprForgetMe","disableThirdPartySharing","trackThirdPartySharing","initSmartBanner","showSmartBanner","hideSmartBanner"],[["ThirdPartySharing",["addGranularOption","addPartnerSharingSetting"]]],"__realObj",(function(t,r,e){t[e]=function(){r.push([e,arguments])}}));
</script>

npmを使用する

Adjust SDKはnpmでも提供されています。パッケージをプロジェクトに追加するには、好みのパッケージマネージャーを使用します。

2. SDKを初期化する

SDKをインストールしたら初期化する必要があります。これを行うには、initSdkメソッドを呼び出してください。このメソッドには、アプリでのSDKの動作をカスタマイズするために使用できる引数があります。

SDKを初期化するには、 initSdkの呼び出しに次の引数を追加する必要があります。

  • appToken （string）：お客様のAdjustアプリトークン。
  • environment （string）：SDKを実行したい環境。
    • SDKをテストモードで実行するには、 sandboxをパスします。
    • リリースの本番用モードでSDKを実行するには、 productionをパスします。
Adjust.initSdk({
   appToken: "YOUR_APP_TOKEN",
   environment: "sandbox",
});