広告主向けGoogleタグマネージャー統合

このページでは、Rokt AdsをGoogleタグマネージャーと連携させて、コンバージョンをキャンペーンにリンクさせる方法を説明します。コンバージョンを広告のエンゲージメントにリンクさせることで、より正確なアトリビューション、リアルタイムの最適化、およびキャンペーンの測定が可能になります。

次のことを学びます:

• サイトのデータレイヤーから値を読み取るGTM変数を作成する方法
• Rokt SDKを初期化し、ユーザーを識別し、コンバージョンイベントを記録するGTMタグを作成する方法

始める前に

次のものを用意してください:

• サイトの正しいGoogleタグマネージャーコンテナへのアクセス
• サイトにすでに実装されているデータレイヤー（通常は開発者が行います）
• Rokt APIキー（Roktアカウントマネージャーから提供されます）

データレイヤーの理解

開発者がサイトにデータレイヤーを実装する必要があります。

データレイヤーは、Googleタグマネージャー（GTM）と共有したい情報をすべて含むオブジェクトです。イベントや変数などの情報をデータレイヤーを介してGoogleタグマネージャーに共有することができ、変数の値に基づいてトリガーをGoogleタグマネージャーで設定することができます（例：purchase_total > $100の場合にリマーケティングタグを発火させる）または特定のイベントに基づいて設定することができます。変数の値は他のタグに渡すこともできます（例：purchase_totalをタグのvalueフィールドに追加する）。

データレイヤーの動作についての詳細は、GoogleのGTM開発者ガイドを参照してください。

データレイヤーの例:

window.dataLayer = window.dataLayer || [];

window.dataLayer.push({
  email: "jenny.smith@rokt.com",
  user: {
    firstname: "Jenny",
    lastname: "Smith",
  },
  ecommerce: {
    transaction: {
      amount: "12.36",
    },
  },
  event: "gtm.transactionComplete",
});

変数名を特定する

変数はGTMアカウントで設定され、データレイヤーと一致します。変数についての詳細は、GTM開発者ガイドを参照してください。

ページ上のデータレイヤーの構造は、GTMでのデータレイヤー変数名に影響を与えます。

データレイヤースクリプトの例 1:

window.dataLayer.push({
  email: "jenny.smith@rokt.com",
});

データレイヤー変数名: email

データレイヤースクリプトの例 2:

window.dataLayer.push({
  user: {
    firstname: "Jenny",
  },
});

データレイヤー変数名: user.firstname

データレイヤースクリプトの例 3:

window.dataLayer.push({
  ecommerce: {
    transaction: {
      amount: "12.36",
    },
  },
});

データレイヤー変数名: ecommerce.transaction.amount

Google Tag Managerで変数を作成する

1. Google Tag Manager コンテナにログインします。
2. 変数 をクリックします。
3. ユーザー定義変数 の下にある 新規 をクリックします。
4. 変数の名前を入力します。
5. セットアップを開始するには変数タイプを選択... をクリックします。
6. ページ変数 の下で データレイヤ変数 を選択します。
7. データレイヤ変数名 を入力します。データレイヤ構造に基づいて変数名を特定するには、上記の例を参照してください。
8. 保存 をクリックします。

Roktは、Roktに送信する予定の属性に対して変数を作成することを推奨します。例えば:

• email
• firstname
• lastname
• mobile
• conversiontype
• confirmationref
• billingzipcode
• amount
• paymenttype
• country
• language
• currency

初期化とログページビュータグの設定

mParticle by Rokt - 初期化とログページビュー タグは以下を行うことができます:

• Rokt SDKの初期化
• ページビューのログ記録

初期化とログページビュータグを作成する手順は以下の通りです:

1. コンテナの左側のナビゲーションから タグ をクリックし、新規 をクリックします。
2. タグ設定 を選択します。
3. コミュニティテンプレートギャラリーでさらに多くのタグタイプを発見 を選択します。
4. Rokt を検索し、mParticle by Rokt - 初期化とログページビュー を選択します。
5. タグの説明的な名前を入力します（例: [Rokt] Initialize and Log Page Views）。
6. 設定を入力します:
   • APIキー: RoktのAPIキーを入力します（これはRoktアカウントマネージャーから提供されます）。
   • 開発モード: 統合をテストしている場合は、開発モード ボックスをチェックします。本番でタグを使用する準備ができたら、このボックスのチェックを外します。
   • ページビューのログ記録: ページビューのログ記録は、各ページが読み込まれるとすぐに、screen_name、url、referring-pageなどの属性を持つページビューイベントを記録します。
     • ページビューイベントの属性は、サイト上の属性に対応します（例: "payment"画面にいる場合、screen_name は payment になります）。
     • ユーザーのトランザクションジャーニーの各ページが読み込まれるとすぐに、ページビューをログに記録する必要があります。
   • ログレベル: ドロップダウンから希望するログレベルを選択します（詳細、警告、なし）。
   • 機能的なクッキーを許可しない: 機能的なクッキーは、サイトやアプリの使いやすさとパフォーマンスを向上させるために使用されます。詳細は、クッキープリファレンスを参照してください。
   • ターゲティングクッキーを許可しない: ターゲティングクッキーは、広告、リターゲティング、マーケティングのパーソナライズを可能にするために使用されます。詳細は、クッキープリファレンスを参照してください。
   • クッキーストレージを使用する: SDK統合のクッキーストレージは、識別子や同意状態などのキー値を永続化するために使用され、SDKがページやセッションをまたいで継続性を維持できるようにします。

7. このGTMタグのトリガーを設定します。次の手順は、サイトがマルチページアプリケーション（MPA）かシングルページアプリケーション（SPA）かによって異なります:

• マルチページアプリケーションのトリガー設定
  1. リストから すべてのページ を選択します。
• シングルページアプリケーションのトリガー設定
  1. リストから すべてのページ と 履歴変更 を選択します。

注記

初期化とログページビュータグは すべてのページ に読み込まれるべきです。正確なトリガー設定は、実装に応じて異なる場合があります。実装戦略について質問がある場合は、Roktアカウントマネージャーにお問い合わせください。

8. トリガーの説明的な名前を入力します（例: すべてのページ または 履歴変更）。
9. 必要に応じて例外を追加します。
10. 保存 をクリックします。

注記

初期化とログページビュータグの実行の一環として、初期化が完了するとカスタムイベント roktInitComplete がデータレイヤにプッシュされます。後続の mParticle by Rokt - Events タグには、イベント名 roktInitComplete を持つGTM カスタムイベント トリガーを使用することを 強く推奨 します。

イベントタグの設定

mParticle by Rokt - Events タグは以下を行うことができます：

• ユーザーを識別
• コンバージョンイベントを記録
• ユーザーおよびイベント属性をRoktに送信

1つのイベントタグで複数のアクションを有効にすることができますが、いくつかの実装ではアクションごとに1つのGTMタグが必要です（例：Identity用に1つのタグ、Log Event用に1つのタグ）。実装戦略について質問がある場合は、Roktのアカウントマネージャーにお問い合わせください。

注意

Initialization & Log Page Viewタグがすべてのイベントタグの前に実行されることを確認してください。トリガーでroktInitCompleteデータレイヤーイベントを使用し、イベントタグが初期化後にのみ発火するようにします。

新しいイベントタグを作成するたびに、以下の手順を使用します（例：Identity用に1つ、Log Event用に1つ）：

1. コンテナの左側のナビゲーションからタグをクリックし、新規をクリックします。
2. タグ設定を選択します。
3. コミュニティテンプレートギャラリーで他のタグタイプを発見を選択します。
4. Roktを検索し、mParticle by Rokt - Eventsを選択します。
5. タグに説明的な名前を入力します（例：[Rokt] Identify user、[Rokt] Log conversion）。

注記

1つのイベントタグで1つ以上のアクションを有効にすることができます（Identity、Log Event、および/またはSelect Placements）。このタグインスタンスに必要なすべてのアクションを最初に設定し、完了したら保存をクリックします。

タグを複数回発火させる必要がある場合（例：ユーザーを識別するために1回、後でイベントを記録するためにもう1回）、同じイベントテンプレートを使用して複数のGTMタグを作成してください。

ユーザーの識別

Roktは、現在のユーザーを識別することを推奨しています（例：メールによって）。これにより、コンバージョンイベントを正確に帰属させることができます。このタグは、ユーザーのメールがデータレイヤーで利用可能になったらすぐに発火するように設定してください。

1. mParticle by Rokt - Events タグで、Identity セクションに移動し、Enable Identity を選択します。
2. IDSync Method ドロップダウンからIdentifyを選択します。
3. Identity Type の下で、Add Row をクリックし、希望するアイデンティティタイプを選択します：
   • 生のメールアドレスを送信する場合、Key ドロップダウンからEmailを選択し、生のメール用のGTM変数を入力します。
   • ハッシュ化されたメール値を送信する場合、Key ドロップダウンからOtherを選択し、ハッシュ化されたメール用のGTM変数を入力します。
4. (オプション) 生のメール値をRoktに送信する前にハッシュ化したい場合は、Hash Raw Email? を選択します。
5. Triggering を設定し、タグが初期化後、かつメール値が利用可能なときにのみ発火するようにします。
   • 例（メールがすでにチェックアウトページの読み込み時に存在する場合）：
     1. Triggering で、+ をクリックして新しいトリガーを作成します。
     2. Trigger Configuration の下で、Custom Event を選択します。
     3. Event name をroktInitCompleteに設定します。
     4. トリガーをSome Custom Eventsで発火するように設定します。
     5. 実装に一致する条件を追加します。例：
        • Page URL がcheckoutを含む
        • {{User Email}} がRegExに一致 .+@.+\..+
     6. トリガーを保存するために保存をクリックします。

6. このイベントタグにアクションを追加し終えたら、保存をクリックします。

コンバージョンイベントをログに記録する

ログイベントアクションは、コンバージョンイベントをRoktに送信します。このタグを、購入確認や「ありがとう」ページなど、コンバージョン後に発生するページ（またはイベント）で発火するように設定します。

1. mParticle by Rokt - Events タグで、Log Event セクションに移動し、Enable Log Event を選択します。
2. Configuration の下で、Event Name に conversion を入力し、Event Type として Transaction を選択します。
3. （オプション）必要なカスタムフラグを Custom Flags の下に追加します。
   • カスタムフラグ は、ページ/イベントに関する情報を含むキー/バリューペアで、通常は特定のテクノロジーパートナーに特化しています（例：SnapchatConversions.ClickId）。カスタムフラグは、意図された特定のパートナーにのみ送信され、カスタム属性とは異なります。

4. このGTMタグのトリガーを設定します。次のステップは、サイトがマルチページアプリケーション（MPA）かシングルページアプリケーション（SPA）かによって異なります：

• マルチページアプリケーションのトリガー設定
  1. リストから Custom Event を選択します。
  2. イベント名として roktInitComplete を入力します。
  3. トリガーの発火ルールを Some Custom Events に変更します。
  4. タグを発火させるべき各ユニークなページを識別するURLパラメータを入力します。例えば、確認ページが example.com/cart/payment/confirmation の場合、識別パラメータは cart、payment、または confirmation のいずれかにできます。

• シングルページアプリケーションのトリガー設定
  1. リストから History Change を選択します。
  2. トリガーの発火ルールを Some History Changes に変更します。
  3. タグを発火させるべきページを識別するURLパラメータを入力します。例えば、確認ページが example.com/cart/payment/confirmation の場合、識別パラメータは cart、payment、または confirmation のいずれかにできます。

5. Save をクリックしてトリガーを保存します。
6. このEventsタグにアクションを追加し終えたら、Save をクリックします。

属性の追加

ユーザーを識別し、コンバージョンイベントをログに記録するのに加えて、Roktはキャンペーンの最適化を向上させるために追加の属性を送信することを推奨します。

1. mParticle by Rokt - Events タグで、Attributes セクションに移動します。
2. ユーザーまたはイベントに関連する利用可能な属性をできるだけ多く入力します。定義済みの属性については、Roktが自動的にそれをユーザー属性またはイベント属性として分類します。以下に示します。

定義済み属性

属性キー	例の値	ユーザー属性	備考
名	John	✓	顧客の名。
姓	Doe	✓	顧客の姓。
携帯電話	3125551515	✓	電話番号は 1112345678 または +1 (222) 345-6789 の形式でフォーマットできます。
年齢	33	✓	顧客の年齢。
生年月日	19900717	✓	生年月日。yyyymmdd の形式でフォーマット。
性別	M	✓	顧客の性別。例：M、Male、F、Female。
支払いタイプ	クレジットカード		取引に使用された支払い方法。例：クレジットカード、PayPal、Apple Pay。
確認参照/取引ID	ORD-123456		購入のためのユニークな取引または確認参照ID。
金額	52.25		総取引金額。
コンバージョンタイプ	購入		コンバージョンイベントのタイプ。例：購入、サインアップ、リード。
パスバックコンバージョントラッキングID	TRACK-789		RoktクリックID。
住所1行目	123 Main Street	✓	顧客の主要住所行。
住所2行目	Apt 4B	✓	顧客の二次住所行（アパート、スイートなど）。
市	Brooklyn	✓	顧客の市。
州	NY	✓	顧客の州または省。
郵便番号	11201	✓	顧客の郵便番号または郵便コード。
国	US	✓	顧客の国。
タイトル	Mr	✓	顧客のタイトル。例：Mr、Mrs、Ms、Dr。
言語	en	✓	顧客または購入に関連する言語。

注記

コンバージョンタイプ と 確認参照/取引ID 属性は、Roktがキャンペーンを効果的に最適化し、イベントとコンバージョンを適切に重複排除するために必要です。これらは必須のローンチ属性です。

統合を完了する前に、Roktアカウントマネージャーと属性を確認してください。

3. 既に定義されていない追加の属性を送信したい場合は、カスタム属性の下の 行を追加 をクリックします。
4. 属性名 と 属性値 の下に属性名と値を入力します。
5. 属性がユーザー（コンバージョンイベントではない）に関連している場合は、ユーザー属性 を選択します。
6. このイベントタグにアクションを追加し終えたら、保存 をクリックします。