Google Analytics 4 測定プロトコルコネクタ構成ガイド | サーバーサイドコネクター

Google Analytics 4 測定プロトコルは、gtag、GTM、または Firebase を使用して収集された既存のイベントを補完することを目的としています。一部のイベント名とパラメータ名は自動収集用に予約されており、測定プロトコルでは送信できません。Google Analytics 4 測定プロトコルコネクタを使用して、gtag、GTM、または Firebase を使用せずにイベントを Google Analytics に送信することができますが、部分的なレポートのみが利用可能になる場合があります。

コネクタアクション

アクション名	AudienceStream	EventStream
Send PageView Event (gtag.js) Deprecated	✓	✓
Send Event (gtag.js)	✓	✓
Send Firebase Event	✓	✓

Send PageView Event アクションは現在非推奨です。page_view イベントを送信するには Send Event アクションを使用してください。

Google Analytics 4 測定プロトコルは、イベントの検証に使用する次のエンドポイントを提供しています：https://google-analytics.com/debug/mp/collect?。Tealium Google Analytics 4 測定プロトコルコネクタは、Trace中にこのエンドポイントを使用し、イベントデータの検証に関する洞察を提供します。Google Analytics 4 測定プロトコルの検証メッセージは、Trace内のAPIコールのHTTPレスポンスコンテンツで確認できます。

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、About Connectorsを参照してください。

コネクタを追加した後、次の構成を構成します：

API Secret (必須)
Google Analytics UIで生成されたAPIシークレット。新しいシークレットを作成するには、管理 > データストリーム > ストリームを選択 > 測定プロトコル > 作成に移動します。
Measurement ID (オプション)
ストリームに関連付けられた測定ID。Google Analytics UIの管理 > データストリーム > ストリームを選択 > 測定IDの下で見つけることができます。
Firebase App ID (オプション)
Firebase App ID。Firebaseアプリの識別子。Firebaseコンソールのプロジェクト構成 > 一般 > アプリ > アプリIDの下で見つけることができます。

アクション構成 - パラメータとオプション

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

詳細については、Google: Send Measurement Protocol events to Google Analyticsを参照してください。

クライアントIDのマッピング

クライアントIDは、Webベースのイベントに固有のユーザーインスタンスを一意に識別するために必要なパラメータです。

Google Analyticsは、クライアントIDを _ga という名前のクッキーに保存します。このクッキーの形式は GA1.2.12349876.1500644855 で、クライアントIDは 12349876.150064485 です。Google Analyticsトラッカーから直接 clientId 値を取得する必要があります。

同意

コネクタはデフォルトで同意信号を送信しません。同意を指定しない場合、Google Analyticsはクライアントインスタンスの対応するオンラインインタラクションからの同意構成を使用します。ad_user_data および ad_personalization の同意構成は、構成時に許可または拒否されます。

アクション - Send PageView Event (gtag.js)

Send PageView Event アクションは現在非推奨です。page_view イベントを送信するには Send Event アクションを使用してください。

パラメータ

パラメータ	説明
クライアントID	必須。クライアントの一意の識別子です。
測定IDオーバーライド	必須。データストリームの識別子です。この構成は構成セクションで使用される測定IDを上書きします。
APIシークレットオーバーライド	データストリームの測定プロトコルAPIシークレットです。この構成は構成セクションで使用されるAPIシークレットを上書きします。
ユーザーID	ユーザーの一意の識別子です。
タイムスタンプマイクロ秒	イベントに関連付ける時間のUnixタイムスタンプ（マイクロ秒単位）。
非パーソナライズ広告	これらのイベントをパーソナライズされた広告に使用しないことを示すために `true` に構成します。

イベントパラメータ

パラメータ	説明
ページタイトル	ページのタイトルです。
ページロケーション	必須。ページの完全なURLです。

ユーザー提供データ

パラメータ	説明
メールアドレス（既にSHA256ハッシュ化されています）	すでに空白トリム、小文字化、SHA256ハッシュ化されたメールアドレスを提供します。`gmail.com`および`googlemail.com`のメールアドレスでドメイン名の前にあるすべてのピリオド（`.`）をハッシュ化する前に削除します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクタは`gmail.com`および`googlemail.com`のメールアドレスでドメイン名の前にあるすべてのピリオド（`.`）を削除し、空白トリム、小文字化、SHA256ハッシュを使用してこの値をハッシュ化します。
電話番号（既にSHA256ハッシュ化されています）	E164形式で、すでに空白トリム、小文字化、SHA256ハッシュ化された電話番号を提供します。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供し、コネクタはすべての非数字記号を削除し、プラス記号（+）で番号の先頭に付け、空白トリム、小文字化し、SHA256ハッシュを使用してこの値をハッシュ化します。
住所情報：名（既にSHA256ハッシュ化されています）	すでに空白トリム、小文字化、SHA256ハッシュ化された名前を提供します。
住所情報：名（SHA256ハッシュを適用）	プレーンテキストの名前を提供し、コネクタは空白トリム、小文字化し、SHA256ハッシュを使用してこの値をハッシュ化します。
住所情報：姓（既にSHA256ハッシュ化されています）	すでに空白トリム、小文字化、SHA256ハッシュ化された姓を提供します。
住所情報：姓（SHA256ハッシュを適用）	プレーンテキストの姓を提供し、コネクタは空白トリム、小文字化し、SHA256ハッシュを使用してこの値をハッシュ化します。
住所情報：住所（既にSHA256ハッシュ化されています）	すでに空白トリム、小文字化、SHA256ハッシュ化された住所を提供します。
住所情報：住所（SHA256ハッシュを適用）	プレーンテキストの住所を提供し、コネクタは空白トリム、小文字化し、SHA256ハッシュを使用してこの値をハッシュ化します。
住所情報：市区町村	ユーザーの住所の市区町村です。
住所情報：州	ユーザーの住所の州コードです。
住所情報：郵便番号	ユーザーの住所の郵便番号です。
住所情報：国	ユーザーの住所の国の2文字の国コード（ISO 3166-1 alpha-2形式）。

ユーザープロパティ

パラメータ	説明
ユーザープロパティ	ユーザーベースのセグメントを説明するユーザープロパティです。例えば、言語の好みや地理的な位置などです。

アイテムデータ

パラメータ	説明
アイテムID	アイテムのIDです。
アイテム名	アイテムの名前です。
所属	供給会社または実店舗の所在地を指定するための商品所属です。
クーポン	アイテムに関連付けられたクーポン名/コードです。
通貨	3文字のISO 4217形式の通貨です。
割引	アイテムに関連付けられた金額の割引値です。
インデックス	リスト内のアイテムの位置/インデックスです。
アイテムブランド	アイテムのブランドです。
アイテムカテゴリ	アイテムのカテゴリです。カテゴリ階層または分類法の一部として使用される場合、これが最初のカテゴリになります。
アイテムカテゴリ2	アイテムの第二カテゴリ階層または追加の分類法です。
アイテムカテゴリ3	アイテムの第三カテゴリ階層または追加の分類法です。
アイテムカテゴリ4	アイテムの第四カテゴリ階層または追加の分類法です。
アイテムカテゴリ5	アイテムの第五カテゴリ階層または追加の分類法です。
アイテムリストID	ユーザーに提示されたリストのIDです。
アイテムリスト名	ユーザーに提示されたリストの名前です。
アイテムバリアント	アイテムのバリアントまたは追加のアイテム詳細/オプションのためのユニークなコードまたは説明です。
ロケーションID	アイテムに関連付けられた場所です。関連するアイテムに対応するGoogle Place IDを使用することをお勧めします。カスタムロケーションIDも使用できます。
価格	指定された通貨単位のアイテムの金額です。
数量	アイテムの数量です。

追加パラメータ

パラメータ	説明
デバッグ	このコネクタはデフォルトでTraceを使用する際にGA4デバッグエンドポイントを使用します。この動作をオーバーライドするためにブール値をマッピングします。

同意

同意状態は granted（許可）または denied（拒否）です。同意を指定しない場合、Google Analyticsはクライアントインスタンスの対応するオンラインインタラクションの同意構成を使用します。

パラメータ	説明
広告ユーザーデータ	広告目的でGoogleにユーザーデータを送信するための同意を構成します。
広告のパーソナライズ	パーソナライズされた広告のための同意を構成します。

アクション - イベント送信 (gtag.js)

パラメータ

パラメータ	説明
クライアントID	クライアントのユニークな識別子が必要です。
測定IDオーバーライド	データストリームの識別子が必要です。この構成は構成セクションで使用される測定IDをオーバーライドします。
APIシークレットオーバーライド	データストリームの測定プロトコルAPIシークレットです。この構成は構成セクションで使用されるAPIシークレットをオーバーライドします。
ユーザーID	ユーザーのユニークな識別子です。
タイムスタンプマイクロ秒	イベントに関連付ける時間のUnixタイムスタンプ（マイクロ秒単位）です。
非パーソナライズ広告	これらのイベントがパーソナライズされた広告に使用されないことを示すために `true` に構成します。
イベントタイプ	イベントタイプを選択します。利用可能なイベントのリストと詳細については、Google: Eventsを参照してください。

イベントパラメータ

パラメータ	説明
実績ID	解除された実績のIDです。
所属	供給会社または実店舗の所在地を指定するための商品所属です。
キャンペーンID	キャンペーンのIDです。
キャンペーン	特定のプロモーションや戦略的キャンペーンを識別するために使用される名前です。
キャラクター	スコアを達成したキャラクターです。
コンテンツ	A/Bテストやコンテンツターゲティング広告のためのキャンペーンコンテンツです。同じURLを指す広告やリンクを区別するために使用されます。
コンテンツタイプ	選択されたコンテンツのタイプです。
クーポン	イベントに関連付けられたクーポン名/コードです。
クリエイティブ名	プロモーションクリエイティブの名前です。
クリエイティブスロット	イベントに関連付けられたプロモーションクリエイティブスロットの名前です。
通貨	イベントに関連するアイテムの通貨で、3文字のISO 4217形式です。
カスタムイベント名	カスタムイベントの名前です。
グループID	グループのIDです。
アイテムID	選択または共有されたアイテムの識別子です。
アイテムリストID	ユーザーに提示されたリストのIDです。
アイテムリスト名	ユーザーに提示されたリストの名前です。
アイテム名	仮想通貨が使用されるアイテムの名前です。
レベル（数値）	キャラクターのレベルです。
ロケーションID	場所のIDです。
ミディアム	キャンペーンの媒体です。
方法	ログイン/サインアップ/共有に使用された方法です。
支払いタイプ	選択された支払い方法です。
プロモーションID	イベントに関連付けられたプロモーションのIDです。
プロモーション名	イベントに関連付けられたプロモーションの名前です。
スコア（数値）	投稿するスコアです。
検索語	検索された用語です。
配送料（数値）	取引に関連する配送料です。
配送層	購入されたアイテムの配送に選択された配送層です（例：地上、空中、翌日）。
ソース	キャンペーンのトラフィックソースです。
税金（数値）	取引に関連する税金のコストです。
用語	支払い検索で使用されるキャンペーン用語で、広告のキーワードを提供します。
トランザクションID	トランザクションのユニークな識別子です。
価値（数値）	イベントの金銭的価値です。
仮想通貨名	仮想通貨の名前です。

ユーザー提供データ

パラメータ	説明
メールアドレス（既にSHA256ハッシュ化）	すでに空白トリム、小文字化、SHA256ハッシュ化されたメールアドレスを提供します。ハッシュ化する前に、`gmail.com`および`googlemail.com`のメールアドレスでドメイン名の前にあるすべてのピリオド（.）を削除します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクタは`gmail.com`および`googlemail.com`のメールアドレスでドメイン名の前にあるすべてのピリオド（.）を削除し、空白トリム、小文字化し、この値をSHA256ハッシュでハッシュ化します。
電話番号（既にSHA256ハッシュ化）	E164形式で既に空白トリム、小文字化、SHA256ハッシュ化された電話番号を提供します。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供し、コネクタはすべての非数字記号を削除し、プラス記号（+）で番号をプレフィックスし、空白トリム、小文字化し、この値をSHA256ハッシュでハッシュ化します。
住所情報：名（既にSHA256ハッシュ化）	すでに空白トリム、小文字化、SHA256ハッシュ化された名を提供します。
住所情報：名（SHA256ハッシュを適用）	プレーンテキストの名を提供し、コネクタは空白トリム、小文字化し、この値をSHA256ハッシュでハッシュ化します。
住所情報：姓（既にSHA256ハッシュ化）	すでに空白トリム、小文字化、SHA256ハッシュ化された姓を提供します。
住所情報：姓（SHA256ハッシュを適用）	プレーンテキストの姓を提供し、コネクタは空白トリム、小文字化し、この値をSHA256ハッシュでハッシュ化します。
住所情報：住所（既にSHA256ハッシュ化）	すでに空白トリム、小文字化、SHA256ハッシュ化された住所を提供します。
住所情報：住所（SHA256ハッシュを適用）	プレーンテキストの住所を提供し、コネクタは空白トリム、小文字化し、この値をSHA256ハッシュでハッシュ化します。
住所情報：市区町村	ユーザーの住所の市区町村です。
住所情報：州	ユーザーの住所の州コードです。
住所情報：郵便番号	ユーザーの住所の郵便番号です。
住所情報：国	ユーザーの住所の国の2文字の国コード（ISO 3166-1 alpha-2形式）です。

ユーザープロパティ

パラメータ	説明
ユーザープロパティ	ユーザーベースのセグメントを記述するユーザープロパティです。例えば、言語の好みや地理的な位置などです。

アイテムデータ

パラメータ	説明
アイテムID	アイテムのIDです。
アイテム名	アイテムの名前です。
所属	供給会社または実店舗の所在地を指定するための商品所属です。
クーポン	アイテムに関連付けられたクーポン名/コードです。
通貨	3文字のISO 4217形式の通貨です。
割引	アイテムに関連付けられた金額の割引値です。
インデックス	リスト内のアイテムの位置/インデックスです。
アイテムブランド	アイテムのブランドです。
アイテムカテゴリ	アイテムのカテゴリです。カテゴリ階層または分類法の一部として使用される場合、これが最初のカテゴリになります。
アイテムカテゴリ2	アイテムの第二カテゴリ階層または追加の分類法です。
アイテムカテゴリ3	アイテムの第三カテゴリ階層または追加の分類法です。
アイテムカテゴリ4	アイテムの第四カテゴリ階層または追加の分類法です。
アイテムカテゴリ5	アイテムの第五カテゴリ階層または追加の分類法です。
アイテムリストID	ユーザーに提示されたリストのIDです。
アイテムリスト名	ユーザーに提示されたリストの名前です。
アイテムバリアント	アイテムのバリアントまたはユニークコード、追加のアイテム詳細/オプションの説明です。
ロケーションID	アイテムに関連付けられた場所です。関連するアイテムに対応するGoogle Place IDの使用を推奨します。カスタムロケーションIDも使用できます。
価格	指定された通貨単位のアイテムの金額です。
数量	アイテムの数量です。

追加パラメータ

パラメータ	説明
デバッグ	このコネクタはデフォルトでTraceを使用する際にGA4デバッグエンドポイントを使用します。この動作をオーバーライドするためにブール値をマッピングします。

同意

パラメータ	説明
広告ユーザーデータ	Googleに広告目的でユーザーデータを送信するための同意を構成します。
広告のパーソナライズ	パーソナライズされた広告のための同意を構成します。

アクション - Firebaseイベントの送信

パラメータ

パラメータ	説明
アプリインスタンスID	必須です。
FirebaseアプリIDオーバーライド	必須です。Firebaseアプリの識別子です。この構成は構成セクションで使用されるFirebaseアプリIDをオーバーライドします。
APIシークレットオーバーライド	データストリームの測定プロトコルAPIシークレットです。この構成は構成セクションで使用されるAPIシークレットをオーバーライドします。
ユーザーID	ユーザーの一意の識別子です。
タイムスタンプマイクロ秒	イベントに関連付ける時間のUnixタイムスタンプ（マイクロ秒単位）です。
非パーソナライズ広告	これらのイベントがパーソナライズされた広告に使用されないことを示すために`true`に構成します。
イベントタイプ	イベントタイプを選択します。利用可能なイベントのリストと詳細については、Google: Eventsを参照してください。

イベントパラメータ

パラメータ	説明
実績ID	解除された実績のIDです。
所属	供給会社または実店舗の所在地を指定するための商品所属です。
キャンペーンID	キャンペーンのIDです。
キャンペーン	特定のプロモーションや戦略的キャンペーンを識別するために使用される名前です。
キャラクター	スコアを達成したキャラクターです。
コンテンツ	A/Bテストとコンテンツターゲティング広告のためのキャンペーンコンテンツです。同じURLを指す広告やリンクを区別するために使用されます。
コンテンツタイプ	選択されたコンテンツのタイプです。
クーポン	イベントに関連付けられたクーポン名/コードです。
クリエイティブ名	プロモーションクリエイティブの名前です。
クリエイティブスロット	イベントに関連付けられたプロモーションクリエイティブスロットの名前です。
通貨	イベントに関連するアイテムの通貨で、3文字のISO 4217形式です。
カスタムイベント名	カスタムイベントの名前です。
グループID	グループのIDです。
アイテムID	選択または共有されたアイテムの識別子です。
アイテムリストID	ユーザーに提示されたリストのIDです。
アイテムリスト名	ユーザーに提示されたリストの名前です。
アイテム名	仮想通貨が使用されるアイテムの名前です。
レベル（数値）	キャラクターのレベルです。
ロケーションID	場所のIDです。
ミディアム	キャンペーンの媒体です。
方法	ログイン/サインアップ/共有に使用された方法です。
支払いタイプ	選択された支払い方法です。
プロモーションID	イベントに関連付けられたプロモーションのIDです。
プロモーション名	イベントに関連付けられたプロモーションの名前です。
スコア（数値）	投稿するスコアです。
検索語	検索された用語です。
配送料（数値）	トランザクションに関連する配送料です。
配送層	購入されたアイテムの配送に選択された配送層です（例：地上、空中、翌日）。
ソース	キャンペーンのトラフィックソースです。
税金（数値）	トランザクションに関連する税金のコストです。
用語	支払い検索で使用されるキャンペーン用語で、広告のキーワードを提供します。
トランザクションID	トランザクションの一意の識別子です。
価値（数値）	イベントの金鍵値です。
仮想通貨名	仮想通貨の名前です。

ユーザー提供データ

パラメータ	説明
メールアドレス（既にSHA256ハッシュ化）	すでに空白トリム、小文字化、SHA256ハッシュ化されたメールアドレスを提供します。ハッシュ化する前に、`gmail.com`および`googlemail.com`のメールアドレスのドメイン名の前にあるすべてのピリオド（.）を削除します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクタは`gmail.com`および`googlemail.com`のメールアドレスのドメイン名の前にあるすべてのピリオド（.）を削除し、空白トリム、小文字化し、この値をSHA256ハッシュでハッシュ化します。
電話番号（既にSHA256ハッシュ化）	E164形式で、すでに空白トリム、小文字化、SHA256ハッシュ化された電話番号を提供します。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供し、コネクタはすべての非数字シンボルを削除し、プラス記号（+）を番号の前に付け、空白トリム、小文字化し、この値をSHA256ハッシュでハッシュ化します。
住所情報：名（既にSHA256ハッシュ化）	すでに空白トリム、小文字化、SHA256ハッシュ化された名を提供します。
住所情報：名（SHA256ハッシュを適用）	プレーンテキストの名を提供し、コネクタは空白トリム、小文字化し、この値をSHA256ハッシュでハッシュ化します。
住所情報：姓（既にSHA256ハッシュ化）	すでに空白トリム、小文字化、SHA256ハッシュ化された姓を提供します。
住所情報：姓（SHA256ハッシュを適用）	プレーンテキストの姓を提供し、コネクタは空白トリム、小文字化し、この値をSHA256ハッシュでハッシュ化します。
住所情報：住所（既にSHA256ハッシュ化）	すでに空白トリム、小文字化、SHA256ハッシュ化された住所を提供します。
住所情報：住所（SHA256ハッシュを適用）	プレーンテキストの住所を提供し、コネクタは空白トリム、小文字化し、この値をSHA256ハッシュでハッシュ化します。
住所情報：市区町村	ユーザーの住所の市区町村です。
住所情報：州	ユーザーの住所の州コードです。
住所情報：郵便番号	ユーザーの住所の郵便番号です。
住所情報：国	ユーザーの住所の国の2文字の国コード（ISO 3166-1 alpha-2形式）です。

ユーザープロパティ

パラメータ	説明
ユーザープロパティ	ユーザーベースのセグメントを記述するユーザープロパティです。例えば、言語の好みや地理的な位置などです。

アイテムデータ

パラメータ	説明
アイテムID	アイテムのIDです。
アイテム名	アイテムの名前です。
所属	供給会社または実店舗の所在地を指定するための製品所属です。
クーポン	アイテムに関連付けられたクーポン名/コードです。
通貨	3文字のISO 4217形式の通貨です。
割引	アイテムに関連付けられた金額の割引値です。
インデックス	リスト内のアイテムの位置/インデックスです。
アイテムブランド	アイテムのブランドです。
アイテムカテゴリ	アイテムのカテゴリです。カテゴリ階層または分類法の一部として使用される場合、これが最初のカテゴリになります。
アイテムカテゴリ2	アイテムの第二カテゴリ階層または追加の分類法です。
アイテムカテゴリ3	アイテムの第三カテゴリ階層または追加の分類法です。
アイテムカテゴリ4	アイテムの第四カテゴリ階層または追加の分類法です。
アイテムカテゴリ5	アイテムの第五カテゴリ階層または追加の分類法です。
アイテムリストID	ユーザーに提示されたリストのIDです。
アイテムリスト名	ユーザーに提示されたリストの名前です。
アイテムバリアント	アイテムのバリアントまたは追加のアイテム詳細/オプションのためのユニークコードまたは説明です。
ロケーションID	アイテムに関連付けられた場所です。関連するアイテムに対応するGoogle Place IDの使用が推奨されます。カスタムロケーションIDも使用できます。
価格	指定された通貨単位のアイテムの金額です。
数量	アイテムの数量です。

追加パラメータ

パラメータ	説明
デバッグ	このコネクタはデフォルトでTraceを使用する際にGA4デバッグエンドポイントを使用します。この動作をオーバーライドするためにブール値をマッピングします。

同意

パラメータ	説明
広告ユーザーデータ	広告目的でGoogleにユーザーデータを送信するための同意を構成します。
広告のパーソナライゼーション	パーソナライズされた広告のための同意を構成します。