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
post_score
purchase
refund
remove_from_cart
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
page_view

アクション

アクション名	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	セッションが開始されたタイムスタンプ。
エンゲージメント時間	ページがフォーカスされている間、またはアプリ画面が前面にある間にユーザーが過ごす時間。

ユーザー提供データ

ユーザー提供データを構成する際には、User ID パラメーターを構成する必要があります。

パラメーター	説明
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	パーソナライズされた広告のための同意を構成します。

デバイス情報

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

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

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

パラメーター	説明
Category	デバイスのカテゴリ。例：`desktop`, `tablet`, `mobile`, `smart TV`。
Language	ISO 639-1形式の言語。例：`en` または `en-US`。
Screen Resolution	デバイスの解像度、`WIDTHxHEIGHT` 形式で表記。例：`1280x2856`。
Operating System	オペレーティングシステムまたはプラットフォーム。例：`MacOS`。
Operating System Version	オペレーティングシステムまたはプラットフォームのバージョン。例：`13.5`。
Model	デバイスのモデル。例：`Pixel 9 Pro` または `Samsung Galaxy S24`。
Brand	デバイスのブランド。例：`Google` または `Samsung`。
Browser	ブラウザのブランドまたはタイプ。例：`Chrome` または `Firefox`。
Browser Version	ブラウザのバージョン。例：`136.0.7103.60` または `5.0`。

地理情報

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

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

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

パラメーター	説明
City	訪問の市名。
Region ID	訪問のISO 3166国および地域。例：`US-CA`, `US-AR`, `CA-BC`, `GB-LND`, `CN-HK`。
Country ID	訪問の国のISO 3166-1 alpha-2形式。例：`US`, `AU`, `ES`, `FR`。
Subcontinent ID	訪問のサブ大陸のUN M49形式。例：`011`, `021`, `030`, `039`。
Continent ID	訪問の大陸のUN M49形式。例：`002`, `019`, `142`, `150`。

Firebaseイベントの送信

本文パラメーター

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

その他のパラメーターについては、Send Event (gtag.js) を参照してください。

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

Send 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中にこのエンドポイントを使用し、イベントデータの検証に関する洞察を提供します。APIコールのHTTPレスポンスコンテンツ内でGoogle Analytics 4 測定プロトコルの検証メッセージを表示できます。