開始方法
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
パッケージをターゲットにすることで、最新版を入手することができます。このパッケージは自動的にアップデートされるため、ターゲットファイルを変更する必要はありません。
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でも提供されています。パッケージをプロジェクトに追加するには、好みのパッケージマネージャーを使用します。
2. SDKの初期化
SDKをインストールしたら、初期化する必要があります。これを行うには、initSdk
メソッドを呼び出します。このメソッドは、アプリでのSDKの動作をカスタマイズするいくつかのパラメーターを取ります。
SDKを初期化するには、initSdk
呼び出しに次の引数を追加する必要があります。
appToken
:お客様のAdjustアプリトークン。environment
:アプリの実行環境。アプリをローカルでテストするには、これをsandbox
に設定します。
Adjust SDKの設定をさらにカスタマイズするには、設定機能セクションのガイドをご覧ください。