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

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

構成

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

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

• API シークレット（必須）
  Google Analytics UI で生成された API シークレット。シークレットを作成するには、管理 > データストリーム > ストリームを選択 > 測定プロトコル > 作成に移動します。
• 測定 ID（オプション）
  ストリームに関連付けられた測定 ID。Google Analytics UI の 管理 > データストリーム > ストリームを選択 > 測定 ID の下にあります。
• Firebase アプリ ID（オプション）
  Firebase アプリ ID。Firebase アプリの識別子。Firebase コンソールの プロジェクト構成 > 一般 > アプリ > アプリ ID の下にあります。

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

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

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

同意

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

イベント名

イベント名を選択します。他のマッピングは選択したイベント名に依存するため、まずイベントを選択し、関連するマッピングを適用します。

利用可能なイベントの詳細とリストについては、イベントを参照してください。

• add_payment_info
• add_shipping_info
• add_to_cart
• add_to_wishlist
• begin_checkout
• custom_event
• campaign_details
• earn_virtual_currency
• generate_lead
• join_group
• level_up
• login
• page_view
• post_score
• purchase
• refund
• remove_from_cart
• screen_view
• search
• select_content
• select_item
• select_promotion
• share
• sign_up
• spend_virtual_currency
• tutorial_begin
• tutorial_complete
• unlock_achievement
• view_cart
• view_item
• view_item_list
• view_promotion
• view_search_results

アクション

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

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

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

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

Send Event (gtag.js)

本文パラメータ

パラメータ	説明
クライアント ID	(必須) クライアントの一意の識別子。
測定 ID オーバーライド	Google Analytics データストリームの識別子。Google Analytics UI の 管理 > データストリーム > ストリームを選択 > 測定 ID の下にあります。この構成は 構成 セクションの 測定 ID を上書きします。
API シークレット オーバーライド	データストリームの測定プロトコル API シークレット。この構成は 構成 セクションの API シークレット を上書きします。
ユーザー ID	ユーザーの一意の識別子。
タイムスタンプ マイクロ秒	イベントに関連付ける時間の Unix タイムスタンプ（マイクロ秒単位）。
非パーソナライズ広告	これらのイベントをパーソナライズされた広告に使用しないことを示すために true に構成します。
ユーザーエージェント	リクエストのデバイス情報を導出するために Google Analytics が使用するデバイスのユーザーエージェント。
IP オーバーライド	訪問の IP アドレス。地理的マッピングを使用しない場合はこのマッピングを使用します。詳細については、Google Analytics 測定プロトコル: 地理情報を参照してください。

イベントパラメータ

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

ユーザー提供データ

User 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に広告目的でユーザーデータを送信するための同意を構成します。
広告のパーソナライゼーション	パーソナライズされた広告のための同意を構成します。

デバイス情報

イベントのリクエストにデバイス情報を提供するには、ユーザーエージェントまたはデバイスレベルの属性を使用します。 デバイス属性をマッピングする場合、ユーザーエージェントは無視されます。

デバイスまたはユーザーエージェントのいずれも指定されていない場合、Google AnalyticsはクライアントIDを使用してタグ付けイベントからデバイス情報を導出します。

Googleは、最小限の要件としてカテゴリを含むできるだけ多くのデバイス属性を提供することを推奨します。

パラメータ	説明
カテゴリ	デバイスのカテゴリ。例えば、デスクトップ、タブレット、モバイル、スマートTV。
言語	ISO 639-1形式の言語。例えば、en や en-US。
画面解像度	デバイスの解像度、WIDTHxHEIGHT 形式でフォーマットされます。例えば、1280x2856。
オペレーティングシステム	オペレーティングシステムまたはプラットフォーム。例えば、MacOS。
オペレーティングシステムバージョン	オペレーティングシステムまたはプラットフォームのバージョン。例えば、13.5。
モデル	デバイスのモデル。例えば、Pixel 9 Pro や Samsung Galaxy S24。
ブランド	デバイスのブランド。例えば、Google や Samsung。
ブラウザ	ブラウザのブランドまたはタイプ。例えば、Chrome や Firefox。
ブラウザバージョン	ブラウザのバージョン。例えば、136.0.7103.60 や 5.0。

地理情報

位置属性をマッピングする場合、IPオーバーライドマッピングは無視されます。

Googleは、最小限の要件として国IDと地域IDを含むできるだけ多くの属性を提供することを推奨します。

詳細については、Google Analytics Measurement Protocol: 地理情報を参照してください。

パラメータ	説明
市	訪問の市名。
地域ID	訪問のISO 3166国および地域。例えば、US-CA、US-AR、CA-BC、GB-LND、または CN-HK。
国ID	訪問の国のISO 3166-1 alpha-2形式。例えば、US、AU、ES、または FR。
大陸ID	訪問の大陸のUN M49形式。例えば、002、019、142、150。
亜大陸ID	訪問の亜大陸のUN M49形式。例えば、011、021、030、039。

Firebaseイベントの送信

本文パラメータ

パラメータ	説明
アプリインスタンスID	（必須）Firebaseアプリの特定のインストールを一意に識別する値。この値はFirebase SDKを通じて取得する必要があります。
FirebaseアプリIDオーバーライド	Firebaseアプリの識別子。この構成は構成セクションのFirebaseアプリIDをオーバーライドします。
APIシークレットオーバーライド	データストリームのMeasurement Protocol APIシークレット。この構成は構成セクションのAPIシークレットをオーバーライドします。
ユーザーID	ユーザーの一意の識別子。
タイムスタンプマイクロ秒	イベントに関連付ける時間のUnixタイムスタンプ（マイクロ秒単位）。
非パーソナライズ広告	これらのイベントがパーソナライズされた広告に使用されないことを示すために true に構成します。
ユーザーエージェント	リクエストのデバイス情報を導出するためにGoogle Analyticsが使用するデバイスユーザーエージェント。
IPオーバーライド	訪問のIPアドレス。地理的マッピングを使用しない場合、このマッピングを使用します。詳細については、Google Analytics Measurement Protocol: 地理情報を参照してください。

その他のパラメータについては、イベントの送信 (gtag.js) を参照してください。

PageView イベントの送信 (gtag.js)

PageView イベントの送信 アクションは非推奨です。page_view イベントを送信するには、Send Event (gtag.js) アクションを使用してください。

ボディパラメータ

パラメータ	説明
クライアントID	(必須) クライアントの一意の識別子です。
測定IDオーバーライド	Google Analyticsのデータストリームの識別子です。Google Analytics UIの 管理 > データストリーム > ストリームを選択 > 測定ID で見つけることができます。この構成は 構成 セクションの 測定ID を上書きします。
APIシークレットオーバーライド	データストリームの測定プロトコルAPIシークレットです。この構成は 構成 セクションの APIシークレット を上書きします。
ユーザーID	ユーザーの一意の識別子です。詳細については GA4ヘルプ: ユーザーIDによるクロスプラットフォーム分析 を参照してください。utf-8文字のみを含むことができます。
タイムスタンプマイクロ秒	イベントに関連付ける時間のUnixタイムスタンプ（マイクロ秒単位）。
非パーソナライズ広告	これらのイベントをパーソナライズされた広告に使用しないことを示すために true に構成します。

イベントパラメータ

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

ユーザー提供データ

ユーザー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デバッグエンドポイントを使用します。この動作を上書きするためにブール値をマッピングします。

同意

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

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

デバッグ

Google Analytics 4 測定プロトコルは、イベントの検証に以下のエンドポイントを提供します：

https://google-analytics.com/debug/mp/collect?

Tealium Google Analytics 4 測定プロトコルコネクタは、Trace中にこのエンドポイントを使用し、イベントデータの検証に関する洞察を提供します。Trace内のAPIコールのHTTPレスポンスコンテンツでGoogle Analytics 4 測定プロトコルの検証メッセージを確認することができます。