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 値を取得できます。

• 正しくフォーマットされたクライアント ID 値を提供する場合、コネクタはこの値を使用します。
• イベントに _ga クッキーの完全な値が client_id マッピングに含まれている場合、コネクタは自動的にクライアント ID 部分のみを解析して抽出します。
• イベントデータに cp.utag_main__ga が含まれており、正しい形式でクライアント ID が含まれている場合、コネクタは自動的にこの値を client_id にマッピングします。

同意

コネクタはデフォルトで同意信号を送信しません。同意を指定しない場合、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
イベント送信 (gtag.js)	✓	✓
Firebase イベント送信	✓	✓
ページビューイベント送信 (gtag.js) 廃止予定	✓	✓

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

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

詳細については、Google: Google Analytics に測定プロトコルイベントを送信するを参照してください。

イベント送信 (gtag.js)

本文パラメータ

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

イベントパラメータ

パラメータ	説明
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	カスタムイベント名です。
Engagement Time	訪問がウェブページやアプリ画面をフォーカスまたは前面に表示している時間です。
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)	投稿するスコアです。
Screen Class	画面のクラスです。
Screen Name	閲覧中の画面の名前です。
Search Term	検索された用語です。
Session ID	セッションが開始されたタイムスタンプです。
Shipping (number)	取引に関連する送料です。
Shipping Tier	購入したアイテムの配送に選択された配送層です（例：地上、空中、翌日）。
Source	キャンペーンのトラフィックソースです。
Tax (number)	取引に関連する税金です。
Term	支払い検索で使用されるキャンペーン用語で、広告のキーワードを提供します。
Transaction ID	取引の一意識別子です。
Value (number)	イベントの金銭的価値です。
Virtual Currency Name	仮想通貨の名前です。
Session ID	セッションが開始されたタイムスタンプです。
Engagement Time	ウェブページやアプリ画面をフォーカスまたは前面に表示している時間です。

ユーザー提供データ

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は、可能な限り多くのデバイス属性を提供することを推奨しています。最低限、カテゴリーを提供する必要があります。

パラメータ	説明
カテゴリー	デバイスのカテゴリー。例：デスクトップ、タブレット、モバイル、スマートTV。
言語	ISO 639-1形式の言語。例：enまたはen-US。
画面解像度	デバイスの解像度、幅x高さの形式。例：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 測定プロトコル：地理情報を参照してください。

パラメータ	説明
市区町村	訪問の市区町村名。
地域ID	訪問のISO 3166国および地域。例：US-CA、US-AR、CA-BC、GB-LND、CN-HK。
国ID	訪問の国をISO 3166-1アルファ2形式で。例：US、AU、ES、FR。
大陸ID	訪問の大陸をUN M49形式で。例：002、019、142、150。

Firebaseイベントの送信

本文パラメータ

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

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

ページビューイベントの送信 (gtag.js)

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

本文パラメータ

パラメータ	説明
クライアントID	(必須) クライアントの一意の識別子。詳細については、クライアント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ハッシュでハッシュ化します。
住所情報：市区町村	ユーザーの住所の市区町村。
住所情報：州	ユーザーの住所の州コード。
住所情報：郵便番号	ユーザーの住所の郵便番号。
住所情報：国	ユーザーの住所の国のISO 3166-1アルファ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にユーザーデータを送信するための同意を構成します。
広告のパーソナライゼーション	パーソナライズされた広告のための同意を構成します。

デバッグ

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

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

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