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

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

コネクタアクション

アクション名	AudienceStream	EventStream
ページビューイベントの送信 (gtag.js) 廃止予定	✓	✓
イベントの送信 (gtag.js)	✓	✓
Firebaseイベントの送信	✓	✓

ページビューイベントの送信アクションは現在、廃止予定です。page_viewイベントを送信するためにイベント送信アクションを使用してください。

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 Secret。新しいシークレットを作成するには、次の場所に移動します：Admin > Data Streams > ストリームを選択 > Measurement Protocol > Create。
• Measurement ID (オプション)
  ストリームに関連付けられた測定ID。Google Analytics UIの次の場所で見つけることができます：Admin > Data Streams > ストリームを選択 > Measurement ID。
• Firebase App ID (オプション)
  Firebase App ID。Firebaseアプリの識別子。Firebaseコンソールの次の場所で見つけることができます：Project Settings > General > Your Apps > App ID。

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

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

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

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

クライアントIDは、ウェブクライアントのユーザーインスタンスを一意に識別するための必須パラメータです。

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

詳細については、以下を参照してください：

• Google tag API reference: get.
• Google Analytics Measurement Protocol > Parameter Reference > Client ID.

同意

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

アクション - ページビューイベントの送信 (gtag.js)

ページビューイベントの送信アクションは現在、廃止予定です。page_viewイベントを送信するためにイベント送信アクションを使用してください。

パラメータ

パラメータ	説明
クライアントID	必須。クライアントの一意の識別子。
測定IDの上書き	必須。データストリームの識別子。この構成はConfigurationセクションで使用される測定IDを上書きします。
API Secretの上書き	データストリームの測定プロトコルAPI Secret。この構成はConfigurationセクションで使用されるAPI Secretを上書きします。
ユーザー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ハッシュでハッシュ化します。
住所情報：市区町村	ユーザーの住所の市区町村。
住所情報：州	ユーザーの住所の州コード。
住所情報：郵便番号	ユーザーの住所の郵便番号。
住所情報：国	ユーザーの住所のISO 3166-1 alpha-2形式の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に構成します。
イベントタイプ	イベントタイプを選択します。利用可能なイベントの一覧と詳細については、イベントを参照してください。

イベントパラメータ

パラメータ	説明
アチーブメント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でハッシュ化済み）	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化したE164標準に従った電話番号を提供します。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供し、コネクタはすべての非数字記号を削除し、番号の前にプラス記号（+）を付け、空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
住所情報：名（既にSHA256でハッシュ化済み）	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化した名前を提供します。
住所情報：名（SHA256ハッシュを適用）	プレーンテキストの名前を提供し、コネクタは空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
住所情報：姓（既にSHA256でハッシュ化済み）	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化した姓を提供します。
住所情報：姓（SHA256ハッシュを適用）	プレーンテキストの姓を提供し、コネクタは空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
住所情報：通りの住所（既にSHA256でハッシュ化済み）	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化した通りの住所を提供します。
住所情報：通りの住所（SHA256ハッシュを適用）	プレーンテキストの通りの住所を提供し、コネクタは空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
住所情報：市区町村	ユーザーの住所の市区町村。
住所情報：州	ユーザーの住所の州コード。
住所情報：郵便番号	ユーザーの住所の郵便番号。
住所情報：国	ユーザーの住所のISO 3166-1 alpha-2形式の2文字の国コード。

ユーザープロパティ

パラメータ	説明
ユーザープロパティ	ユーザープロパティは、言語の構成や地理的な位置など、ユーザーベースのセグメントを記述します。

アイテムデータ

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

追加パラメータ

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

同意

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

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

パラメータ

パラメータ	説明
App Instance ID	必須。
Firebase App ID Override	必須。Firebaseアプリの識別子。この構成は、構成セクションで使用されるFirebase App IDを上書きします。
API Secret Override	データストリームのMeasurement Protocol API Secret。この構成は、構成セクションで使用されるAPI Secretを上書きします。
ユーザーID	ユーザーの一意の識別子。
Timestamp Micros	イベントに関連付ける時間のUnixタイムスタンプ（マイクロ秒単位）。
非パーソナライズ広告	これらのイベントがパーソナライズされた広告に使用されないことを示すためにtrueに構成します。
イベントタイプ	イベントタイプを選択します。利用可能なイベントの一覧と詳細については、イベントを参照してください。

イベントパラメータ

パラメータ	説明
Achievement ID	解除された実績のID。
Affiliation	供給会社または実店舗の場所を指定するための製品提携。
Campaign ID	キャンペーンID。
Campaign	特定のプロモーションや戦略的キャンペーンを識別するために使用される名前。
Character	スコアを達成したキャラクター。
Content	A/Bテストやコンテンツターゲティング広告用のキャンペーンコンテンツ。同じURLを指す広告やリンクを区別するために使用されます。
Content Type	選択されたコンテンツのタイプ。
Coupon	イベントに関連付けられたクーポンの名前/コード。
Creative Name	プロモーションクリエイティブの名前。
Creative Slot	イベントに関連付けられたプロモーションクリエイティブスロットの名前。
Currency	イベントに関連付けられたアイテムの通貨、3文字のISO 4217形式。
Custom Event Name	カスタムイベント名。
Group ID	グループのID。
Item ID	選択されたアイテムまたは共有されたアイテムの識別子。
Item List ID	アイテムがユーザーに提示されたリストのID。
Item List Name	アイテムがユーザーに提示されたリストの名前。
Item Name	仮想通貨が使用されるアイテムの名前。
Level (number)	キャラクターのレベル。
Location ID	場所のID。
Medium	キャンペーンの媒体。
Method	ログイン/サインアップ/共有に使用された方法。
Payment Type	選択された支払い方法。
Promotion ID	イベントに関連付けられたプロモーションのID。
Promotion Name	イベントに関連付けられたプロモーションの名前。
Score (number)	投稿するスコア。
Search Term	検索された用語。
Shipping (number)	トランザクションに関連付けられた送料。
Shipping Tier	購入したアイテムの配送に選択された配送層（例：地上、航空、翌日）。
Source	キャンペーンのトラフィックソース。
Tax (number)	トランザクションに関連付けられた税金。
Term	広告のキーワードを供給するために有料検索と共に使用されるキャンペーン用語。
Transaction ID	トランザクションの一意の識別子。
Value (number)	イベントの金額価値。
Virtual Currency Name	仮想通貨の名前。

ユーザー提供データ

パラメータ	説明
Email Address (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化されたメールアドレスを提供します。gmail.comおよびgooglemail.comのメールアドレスで、ドメイン名の前にあるすべてのピリオド（.）をハッシュ化する前に削除します。
Email Address (apply SHA256 hash)	プレーンテキストのメールアドレスを提供し、コネクタはgmail.comおよびgooglemail.comのメールアドレスで、ドメイン名の前にあるすべてのピリオド（.）を削除し、空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
Phone Number (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化されたE164標準に従った電話番号を提供します。
Phone Number (apply SHA256 hash)	プレーンテキストの電話番号を提供し、コネクタはすべての非数字記号を削除し、番号の前にプラス記号（+）を付け、空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
Address Info: First Name (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された名前を提供します。
Address Info: First Name (apply SHA256 hash)	プレーンテキストの名前を提供し、コネクタは空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
Address Info: Last Name (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された姓を提供します。
Address Info: Last Name (apply SHA256 hash)	プレーンテキストの姓を提供し、コネクタは空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
Address Info: Street Address (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された通りの住所を提供します。
Address Info: Street Address (apply SHA256 hash)	プレーンテキストの通りの住所を提供し、コネクタは空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
Address Info: City	ユーザーの住所の市区町村。
Address Info: State	ユーザーの住所の州のコード。
Address Info: Postal Code	ユーザーの住所の郵便番号。
Address Info: Country	ユーザーの住所のISO 3166-1 alpha-2形式の2文字の国コード。

ユーザープロパティ

パラメータ	説明
User Properties	ユーザープロパティは、言語の構成や地理的な位置など、ユーザーベースのセグメントを記述します。

アイテムデータ

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

追加パラメータ

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

同意

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