開始方法

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.6.0.min.jsのようにCDNターゲットに追加します。https://cdn.adjust.com/adjust-latest.min.jsのように、adjust-latestパッケージをターゲットにすることで、最新版を入手することができます。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。

ヒント:
SDKのファイルは、迅速なサービスを実現するためにキャッシュされます。このキャッシュは30分ごとに更新されます。強制的に最新バージョンに更新する場合は、ヘッダーで特定のバージョンをターゲットにしてください。

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

<script type="application/javascript">
!function(t,e,a,r,n,s,d,l,o,i,u){t.Adjust=t.Adjust||{},t.Adjust_q=t.Adjust_q||[];for(var c=0;c<l.length;c++)o(t.Adjust,t.Adjust_q,l[c]);i=e.createElement(a),u=e.getElementsByTagName(a)[0],i.async=!0,i.src="https://cdn.adjust.com/adjust-latest.min.js",i.onload=function(){for(vare=0;e<t.Adjust_q.length;e++)t.Adjust[t.Adjust_q[e][0]].apply(t.Adjust,t.Adjust_q[e][1]);t.Adjust_q=[]},u.parentNode.insertBefore(i,u)}(window,document,"script",0,0,0,0,["initSdk","getAttribution","getWebUUID","setReferrer","trackEvent","addGlobalCallbackParameters","addGlobalPartnerParameters","removeGlobalCallbackParameter","removeGlobalPartnerParameter","clearGlobalCallbackParameters","clearGlobalPartnerParameters","switchToOfflineMode","switchBackToOnlineMode","stop","restart","gdprForgetMe","disableThirdPartySharing","initSmartBanner","showSmartBanner","hideSmartBanner"],(function(t,e,a){t[a]=function(){e.push([a,arguments])}}));
</script>

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

サブリソース完全性

クロスサイトスクリプティング(XSS)攻撃を緩和するためにサブリソース完全性チェックを使用する場合、次の呼び出しを使用すると、パッケージが実行される前に検証することができます。

<script type="application/javascript">
!function(t,e,a,r,n,s,o,d,l,i,u){t.Adjust=t.Adjust||{},t.Adjust_q=t.Adjust_q||[];for(var c=0;c<d.length;c++)l(t.Adjust,t.Adjust_q,d[c]);i=e.createElement(a),u=e.getElementsByTagName(a)[0],i.async=!0,i.src="https://cdn.adjust.com/adjust-latest.min.js",i.crossOrigin="anonymous",i.integrity=s,i.onload=function(){for(vare=0;e<t.Adjust_q.length;e++)t.Adjust[t.Adjust_q[e][0]].apply(t.Adjust,t.Adjust_q[e][1]);t.Adjust_q=[]},u.parentNode.insertBefore(i,u)}(window,document,"script",0,0,"sha384-BqbTn9xyk5DPznti1ZP8ksxKiOFhKufLBFWm5eNMCnZABFSG1eqQfcu5dsiZJHu5",0,["initSdk","getAttribution","getWebUUID","setReferrer","trackEvent","addGlobalCallbackParameters","addGlobalPartnerParameters","removeGlobalCallbackParameter","removeGlobalPartnerParameter","clearGlobalCallbackParameters","clearGlobalPartnerParameters","switchToOfflineMode","switchBackToOnlineMode","stop","restart","gdprForgetMe","disableThirdPartySharing","initSmartBanner","showSmartBanner","hideSmartBanner"],(function(t,e,a){t[a]=function(){e.push([a,arguments])}}));
</script>

npmを使用する

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

NPM
yarn
pnpm
$ npm install @adjustcom/adjust-web-sdk --save

2. SDKの初期化

SDKをインストールしたら、初期化する必要があります。これを行うには、initSdkメソッドを呼び出します。このメソッドは、アプリでのSDKの動作をカスタマイズするいくつかのパラメーターを取ります。

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

  • appToken:お客様のAdjustアプリトークン
  • environment:アプリの実行環境。アプリをローカルでテストするには、これをsandboxに設定します。
Javascript
Adjust.initSdk({
  appToken: 'YOUR_APP_TOKEN',
  environment: 'sandbox'
});

Adjust SDKの設定をさらにカスタマイズするには、設定機能セクションのガイドをご覧ください。