このガイドでは、読み込み、初期化、イベントの計測など、Google タグマネージャー(GTM)でAdjust Web SDKを使用する方法を説明します。
Web SDKの読み込みと初期化
以下の手順で、Adjust Web SDKを読み込み、初期化する単一のGTMタグを作成します。
1.カスタムHTMLタグを作成
タグにはわかりやすい名前を付けてください。例:Adjust Web SDK - Load and Initialize
2.SDKローダースニペットを追加
GTMのカスタムHTMLタグ内に、次のローダースニペットのいずれかを追加します。
SDKを自動アップデートする場合
常にAdjust Web SDKの最新バージョンを取得するには、adjust-latest.min.js
を使用します。
手順: 以下のSDKローダースニペットをコピーして、GTMのカスタムHTMLタグに貼り付けます。
<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]||[];var p=function(a,n,r){a[r]=function(){n.push([r,arguments])}};for(var g=0;g<l.length;g++)p(t[i],t[f],l[g]);for(var v=0;v<c.length;v++){var y,E=c[v][0],_=[].slice.call(c[v][1]);t[i][E]=function(){var e=arguments;return y=this,t[m].push(function(){y[s]=new(Function.prototype.bind.apply(t[i][E],[null].concat(Array.prototype.slice.call(e))))}),y};for(var g=0;g<_.length;g++){(function(e){t[i][E].prototype[e]=function(){var n=arguments;t[m].push(function(){y[s][e].apply(y[s],n)})}})(_[g])}}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]&&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");</script>
サブリソース完全性(SRI)で特定のSDKバージョンを使用する場合
特定のSDKバージョンを読み込み、サブリソース完全性(Subresource Integrity、SRI)を使用します。integrity
ハッシュと crossOrigin
アトリビュートを含む、バージョン固有のsrc
URLを使用します。これらの要素により、ブラウザーはスクリプトが改ざんされていないことを検証できます。この方法では、新しいSDKバージョンを手動で更新する必要があります。
手順: 以下のSDKローダースニペットをコピーして、GTMのカスタムHTMLタグに貼り付けます。
<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]||[];var p=function(a,n,r){a[r]=function(){n.push([r,arguments])}};for(var g=0;g<l.length;g++)p(t[i],t[f],l[g]);for(var v=0;v<c.length;v++){var y,E=c[v][0],_=[].slice.call(c[v][1]);t[i][E]=function(){var e=arguments;return y=this,t[m].push(function(){y[s]=new(Function.prototype.bind.apply(t[i][E],[null].concat(Array.prototype.slice.call(e))))}),y};for(var g=0;g<_.length;g++){(function(e){t[i][E].prototype[e]=function(){var n=arguments;t[m].push(function(){y[s][e].apply(y[s],n)})}})(_[g])}}h=r.createElement(e),u=r.getElementsByTagName(e)[0],h.async=!0,h.src="https://cdn.adjust.com/adjust-5.7.2.min.js",o&&(h.crossOrigin="anonymous",h.integrity=o),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]&&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,"sha384-3BJePftWPBpqzii4G4Z1wjO/OaXCIpqAZ/4hbIB8KGBvrmSwZQLUflAaqRa2poWO","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");</script>
今後SDKのバージョンを更新する場合
- 新しいSDKバージョン番号(例:
adjust-5.7.2.min.js
)を使用してsrc
アトリビュートを更新します。 integrity
ハッシュを更新します。この値は、Adjust Web SDKのGitHubリリースに対応するINTEGRITY
ハッシュファイルに記載されています。
3.SDK初期化コードを追加
GTMのカスタムHTMLタグ内にローダースニペットを追加したら、続けて以下の初期化コードを追加してください。
<script> // --- Initialize the Adjust SDK --- Adjust.initSdk({ appToken: "YOUR_APP_TOKEN", // Required: Replace with your Adjust App Token environment: "sandbox", // "sandbox" for testing, "production" for live });</script>
完全なカスタムHTMLタグを完成させるには、選択したSDKローダースニペットのすぐ下に、この初期化スニペットを含める必要があります。
4.タグ呼び出しオプションとトリガーを設定
- GTMのタグ設定で「 詳細設定(Advanced Settings) 」を開き、「 タグ呼び出しオプション(Tag firing options) 」で「 1ページにつき一度(Once per page) 」を選択します。
- 「 トリガー(Triggering) 」セクションをクリックし、「 すべてのページ(ページビュー)(All Pages (Page View)) 」のトリガーを選択します。
- タグを 保存(Save) します。
タグは以下のようにしてください。
これで、選択した方法とトリガーでAdjust Web SDKを読み込み、初期化できるようになります。
trackEvent
1.新しいカスタムHTMLタグを作成
- GTMコンテナで、「 タグ(Tags) 」に移動し、「 新規(New) 」をクリックします。
- タグに分かりやすい名前を付けてください(例:「Adjust Event - User Registration」)。
- 「 タグの設定(Tag Configuration) 」をクリックし、「 カスタムHTML(Custom HTML) 」を選択します。
2. イベントトラッキングスニペットを追加
以下のスニペットをHTMLフィールドに追加します。
<script> Adjust.trackEvent({ // Required: Replace "EVENT_TOKEN" with your specific Adjust event token. eventToken: "EVENT_TOKEN",
// Optional for revenue/currency: uncomment lines below. // revenue: {{DLV - Transaction Revenue}}, // currency: {{DLV - Transaction Currency}} });</script>
3.トリガーを設定
特定のユーザーアクションに基づいて、このイベントタグを呼び出すトリガーを設定します。以下に、一般的な例を2つ示します。
例:フォームの送信を計測(ユーザー登録など)
- 新しいトリガーを作成し、名前を付けます(例:「Registration form submitted」)。
- トリガータイプとして「 フォーム送信(Form Submission) 」を選択します。
- 「 このトリガーの発生場所(This trigger fires on) 」で、「 一部のフォーム(Some Forms) 」を選択します。
- フォームを識別する条件を定義します(例:
Form ID
equals
registration-form
)。 - トリガーを 保存(Save) します。
例:データレイヤーによって計測されるイベント(例:収益を伴う購入)を計測
これは、データレイヤーに情報をプッシュすることでWebサイトから通知される、購入などのイベントに使用されます。
- 新しいトリガーを作成し、名前を付けます (例: 「Purchase completed」)。
- トリガーのタイプとして「 カスタムイベント(Custom Event) 」を選択します。
- 「 イベント名(Event name) 」フィールドに、開発チームから提供された正確な名前を入力します(例:
purchase_completed
)。 - 「 このトリガーの発生場所(This trigger fires on) 」で「 すべてのカスタムイベント(All Custom Events) 」を選択します。
- トリガーを 保存(Save) します。
以下は、ユーザー登録イベントのトリガー設定例です。
4.タグの順序付けを設定する
- イベントタグの「 詳細設定(Advanced Settings) 」で「 タグの順序付け(Tag Sequencing)」 」を見つけます。
- 「 [イベントタグ名]が発効する前にタグを配信(Fire a tag before [Your Event Tag Name] fires) 」を有効にします。
- 「 設定タグ(Setup Tag) 」には、「Adjust Web SDK - Load and Initialize」タグを選択します。これにより、イベントの計測前にSDKが確実に読み込まれます。
- イベントタグを 保存(Save) します。
以下は、ユーザー登録イベントのタグの設定例です。
動的データのGTM変数を設定
イベントに収益などの動的データが含まれている場合は、GTM変数を使用して、Webサイトのデータレイヤーから値を読み取ることができます。ただし、このようなデータを提供するようにデータレイヤーを事前に構成する必要があります。詳細については、Googleのドキュメントで開発者向けの情報を参照してください。
GTMでデータレイヤー変数を作成するには:
- 「 変数(Variables) 」に移動し、「 ユーザー定義変数(User-Defined Variables) 」の下にある「 新規(New) 」をクリックします。
- 変数に名前を付けます(例:
DLV - Transaction Revenue
)。これはタグスニペットで使用される名前です(例:{{DLV - Transaction Revenue}}
)。 - 「 変数タイプ(Data Layer Variable) 」として「 データレイヤー変数(Variable Type) 」を選択します。
- 「 データレイヤー変数名(Data Layer Variable Name) 」フィールドに、データレイヤーで使用されている正確なキー名を入力します(例:
transaction_total
)。 - 「 データレイヤーのバージョン(Data Layer Version) 」は「 バージョン2(Version 2) 」のままにしてください。
- (オプション)変数が存在しない場合は、 デフォルト値(Default Value) を設定します。
- 変数を 保存(Save) します。
動的データごとにこの手順を繰り返してください。作成後、Adjustのイベントタグでそれらを使用できます。
以下は変数設定の例です。