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

コネクタのアクション

アクション名	AudienceStream	EventStream
Send PageView Event (gtag.js) 廃止予定	✓	✓
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 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の同意を構成するとき、同意状態は許可または拒否のいずれかになります。

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

パラメータ

パラメータ	説明
Client ID	必須。クライアントの一意の識別子。
Measurement ID Override	必須。データストリームの識別子。この構成はConfigurationセクションで使用されるMeasurement IDを上書きします。
API Secret Override	データストリームのMeasurement Protocol API Secret。この構成はConfigurationセクションで使用されるAPI Secretを上書きします。
User ID	ユーザーの一意の識別子。
Timestamp Micros	イベントに関連付ける時間のUnixタイムスタンプ（マイクロ秒単位）。
Non Personalized Ads	これらのイベントをパーソナライズされた広告に使用しないことを示すためにtrueに構成します。

イベントパラメータ

パラメータ	説明
Page Title	ページのタイトル。
Page Location	必須。ページへの完全なURL。

ユーザー提供データ

パラメータ	説明
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)	E164標準に従った電話番号を提供し、すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化されています。
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	ユーザーの住所の2文字の国コード（ISO-3166-1 alpha-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 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デバッグエンドポイントを使用します。この動作をオーバーライドするために、ブール値をマップします。

同意

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

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

パラメータ

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

イベントパラメータ

パラメータ	説明
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	ユーザーの住所の国の2文字の国コード、ISO-3166-1 alpha-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	アイテムの数量。

追加パラメータ

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

同意

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