広告主向け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タグマネージャーで変数を作成するGoogleタグマネージャーで変数を作成する への直接リンク
- Googleタグマネージャーコンテナにログインします。
- 変数をクリックします。
- ユーザー定義変数の下で、新規をクリックします。
- 変数の名前を入力します。
- **設定を開始するには変数タイプを選択...**をクリックします。
- ページ変数の下でデータレイヤ変数を選択します。
- データレイヤ変数名を入力します。データレイヤ構造に基づいて変数名を特定するための例を参照してください。
- 保存をクリックします。
Roktは、Roktに送信する予定の属性に対して変数を作成することを推奨します。例えば:
emailfirstnamelastnamemobileconversiontypeconfirmationrefbillingzipcodeamountpaymenttypecountrylanguagecurrency
初期化とページビューのログタグを設定する初期化とページビューのログタグを設定する への直接リンク
mParticle by Rokt - 初期化とページビューのログタグは以下を行うことができます:
- Rokt SDKの初期化
- ページビューのログ
これらの手順を使用して初期化とページビューのログタグを作成します:
- コンテナの左側のナビゲーションでタグをクリックし、新規をクリックします。

- タグ設定を選択します。
- コミュニティテンプレートギャラリーでさらに多くのタグタイプを発見するを選択します。

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

- このGTMタグのトリガーを設定します。次の手順は、サイトがマルチページアプリケーション(MPA)かシングルページアプリケーション(SPA)かによって異なります:
- マルチページアプリケーションのトリガー設定
- リストからすべてのページを選択します。
- シングルページアプリケーションのトリガー設定
- リストからすべてのページと履歴の変更を選択します。
初期化とページビューのログタグはすべてのページで読み込まれるべきです。正確なトリガー設定は実装によって異なる場合があります。実装戦略について質問がある場合は、Roktアカウントマネージャーにお問い合わせください。
- トリガーの説明的な名前を入力します(例:すべてのページまたは履歴の変更)。
- 必要に応じて例外を追加します。
- 保存をクリックします。
初期化とページビューのログタグの実行の一環として、カスタムイベントroktInitCompleteが初期化完了時にデータレイヤにプッシュされます。後続のmParticle by Rokt - Eventsタグのために、イベント名roktInitCompleteを持つGTMカスタムイベントトリガーを使用することを強く推奨します。
イベントタグの設定イベントタグの設定 への直接リンク
mParticle by Rokt - Events タグは以下を行うことができます:
- ユーザーの識別
- コンバージョンイベントのログ記録
- ユーザーおよびイベント属性をRoktに送信
1つのイベントタグで複数のアクションを有効にすることはできますが、いくつかの実装ではアクションごとに1つのGTMタグが必要です(例:Identity用に1つのタグ、Log Event用に1つのタグ)。実装戦略について質問がある場合は、Roktのアカウントマネージャーにお問い合わせください。
初期化とページビューのログタグが、イベントタグの前に実行されることを確認してください。トリガーで roktInitComplete データレイヤーイベントを使用し、イベントタグが初期化後にのみ発火するようにします。
新しいイベントタグを作成するたびに、以下の手順を使用します(例:Identity用に1つ、Log Event用に1つ):
- コンテナの左側のナビゲーションからタグをクリックし、新規をクリックします。

- タグ設定を選択します。
- コミュニティテンプレートギャラリーで他のタグタイプを探すを選択します。

Roktを検索し、mParticle by Rokt - Eventsを選択します。
- タグの説明的な名前を入力します(例:
[Rokt] Identify user、[Rokt] Log conversion)。
1つのイベントタグで1つまたは複数のアクション(Identity、Log Event、および/またはSelect Placements)を有効にすることができます。このタグインスタンスに必要なすべてのアクションを最初に設定し、完了したら保存をクリックします。
タグを複数回発火させる必要がある場合(例:ユーザーを識別するために1回、後でイベントをログするために1回)、同じイベントテンプレートを使用して複数のGTMタグを作成します。
ユーザーの識別ユーザーの識別 への直接リンク
Roktは、現在のユーザーを識別すること(例:メールによって)を推奨しています。これにより、コンバージョンイベントを正確に帰属させることができます。このタグを、ユーザーのメールがデータレイヤーで利用可能になったときに発火するように設定します。
- mParticle by Rokt - Events タグで、Identity セクションに移動し、Enable Identity を選択します。
- IDSync Method ドロップダウンで、Identify を選択します。
- Identity Type の下で、Add Row をクリックし、希望するアイデンティティタイプを選択します:
- 生のメールアドレスを送信する場合、Key ドロップダウンから
Emailを選択し、生のメール用のGTM変数を入力します。
- ハッシュ化されたメール値を送信する場合、Key ドロップダウンから
Otherを選択し、ハッシュ化されたメール用のGTM変数を入力します。
- 生のメールアドレスを送信する場合、Key ドロップダウンから
- (オプション) Hash Raw Email? を選択すると、タグが生のメール値をRoktに送信する前にハッシュ化します。

- トリガー設定を行い、タグが初期化後、かつメール値が利用可能なときにのみ発火するようにします。
- 例(メールがすでにチェックアウトページのロード時に存在する場合):
- トリガー設定で、+ をクリックして新しいトリガーを作成します。
- トリガー設定の下で、カスタムイベントを選択します。
- イベント名を
roktInitCompleteに設定します。 - トリガーを一部のカスタムイベントで発火するように設定します。
- 実装に一致する条件を追加します。例:
- ページURLが
checkoutを含む {{User Email}}正規表現に一致.+@.+\..+
- ページURLが
- トリガーを保存するには、保存をクリックします。
- 例(メールがすでにチェックアウトページのロード時に存在する場合):
6. このイベントタグにアクションを追加し終えたら、保存をクリックします。
コンバージョンイベントをログに記録するコンバージョンイベントをログに記録する への直接リンク
ログイベントアクションは、コンバージョンイベントをRoktに送信します。このタグを、購入確認や「ありがとう」ページなど、コンバージョン後に発生するページ(またはイベント)で発火するように設定します。
- mParticle by Rokt - Events タグで、Log Event セクションに移動し、Enable Log Event を選択します。
- Configuration の下で、
conversionを Event Name として入力し、Transactionを Event Type として選択します。 - (オプション)必要に応じて、Custom Flags の下にカスタムフラグを追加します。
- カスタムフラグ は、通常は技術パートナーに特有の情報を含むキー/バリューペアです(例:
SnapchatConversions.ClickId)。カスタムフラグは、意図された特定のパートナーにのみ送信され、カスタム属性とは異なります。
- カスタムフラグ は、通常は技術パートナーに特有の情報を含むキー/バリューペアです(例:
4. このGTMタグのトリガーを設定します。次のステップは、サイトがマルチページアプリケーション(MPA)かシングルページアプリケーション(SPA)かによって異なります。
- マルチページアプリケーションのトリガー設定
- リストから Custom Event を選択します。
- イベント名として
roktInitCompleteを入力します。 - トリガー発火ルールを Some Custom Events に変更します。
- タグを発火させるべき各ユニークページを識別するURLパラメータを入力します。例えば、確認ページが
example.com/cart/payment/confirmationの場合、識別パラメータはcart、payment、またはconfirmationのいずれかにできます。

- シングルページアプリケーションのトリガー設定
- リストから History Change を選択します。
- トリガー発火ルールを Some History Changes に変更します。
- タグを発火させるべきページを識別するURLパラメータを入力します。例えば、確認ページが
example.com/cart/payment/confirmationの場合、識別パラメータはcart、payment、またはconfirmationのいずれかにできます。
- Save をクリックしてトリガーを保存します。
- このEventsタグにアクションを追加し終えたら、Save をクリックします。
属性の追加属性の追加 への直接リンク
ユーザーを識別しコンバージョンイベントをログに記録することに加えて、Roktはキャンペーンの最適化を向上させるために追加の属性を送信することを推奨します。
- mParticle by Rokt - Events タグで、Attributes セクションに移動します。
- ユーザーまたはイベントに関連する利用可能な属性をできるだけ多く入力します。定義済みの属性については、Roktが自動的にそれらをユーザー属性またはイベント属性として分類します。以下に示すように。

事前定義された属性事前定義された属性 への直接リンク
| 属性キー | 例の値 | ユーザー属性 | 備考 |
|---|---|---|---|
| 名 | John | ✓ | 顧客の名。 |
| 姓 | Doe | ✓ | 顧客の姓。 |
| 携帯電話 | 3125551515 | ✓ | 電話番号は 1112345678 または +1 (222) 345-6789 の形式でフォーマットできます。 |
| 年齢 | 33 | ✓ | 顧客の年齢。 |
| 生年月日 | 19900717 | ✓ | 生年月日。 yyyymmdd の形式でフォーマット。 |
| 性別 | M | ✓ | 顧客の性別。例えば、M、Male、F、または Female。 |
| 支払いタイプ | Credit Card | 取引に使用された支払い方法。例えば、Credit Card、PayPal、Apple Pay。 | |
| 確認参照/取引ID | ORD-123456 | 購入のためのユニークな取引または確認参照ID。 | |
| 金額 | 52.25 | 総取引金額。 | |
| コンバージョンタイプ | Purchase | コンバージョンイベントのタイプ。例えば、Purchase、Signup、Lead。 | |
| パスバックコンバージョントラッキングID | TRACK-789 | RoktクリックID。 | |
| 住所1行目 | 123 Main Street | ✓ | 顧客の主要な住所行。 |
| 住所2行目 | Apt 4B | ✓ | 顧客の二次的な住所行(アパート、スイートなど)。 |
| 市 | Brooklyn | ✓ | 顧客の市。 |
| 州 | NY | ✓ | 顧客の州または県。 |
| 郵便番号 | 11201 | ✓ | 顧客の郵便番号または郵便コード。 |
| 国 | US | ✓ | 顧客の国。 |
| 敬称 | Mr | ✓ | 顧客の敬称。例えば、Mr、Mrs、Ms、Dr。 |
| 言語 | en | ✓ | 顧客または購入に関連する言語。 |
Conversion Type と Confirmation Reference/Transaction ID の属性は、Roktがキャンペーンを効果的に最適化し、イベントとコンバージョンを適切に重複排除するために必要です。これらは必須のローンチ属性です。
統合を完了する前に、Roktアカウントマネージャーと属性を確認してください。
- 既に定義されていない追加の属性を送信したい場合は、カスタム属性の下で 行を追加 をクリックします。
- 属性名 と 属性値 の下に属性名と値を入力します。
- 属性がユーザー(コンバージョンイベントではない)に関連している場合は、ユーザー属性 を選択します。

- このイベントタグにアクションの追加が完了したら、保存 をクリックします。