---
title: Google Analytics 4 測定プロトコルコネクタ構成ガイド
description: この記事では、Google Analytics 4 測定プロトコルコネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/google-analytics-4-measurement-protocol-connector/
---
Google Analytics 4 測定プロトコルは、gtag、GTM、または Firebase を使用して収集された既存のイベントを補完することを目的としています。一部のイベント名とパラメータ名は自動収集用に予約されており、測定プロトコルでは送信できません。Google Analytics 4 測定プロトコルコネクタを使用すると、gtag、GTM、または Firebase を使用せずにイベントを Google Analytics に送信できますが、部分的なレポートのみが利用可能になる場合があります。

## 構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。

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

* **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` の同意構成時には、同意が許可されているか拒否されているかのいずれかです。

### イベント名

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

利用可能なイベントの詳細およびリストについては、[イベント](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events)を参照してください。

* `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) 廃止予定 | ✓ | ✓ |


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


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

詳細については、[Google: Google Analytics に測定プロトコルイベントを送信する](https://developers.google.com/analytics/devguides/collection/protocol/ga4/sending-events?client_type=gtag)を参照してください。

### イベント送信 (gtag.js)

#### 本文パラメータ

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


#### イベントパラメータ

| **パラメータ** | **説明** |
| --- | --- |
| 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 測定プロトコル：地理情報](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference?client_type=gtag#payload_geo_info)を参照してください。

| **パラメータ** | **説明** |
| --- | --- |
| 市区町村 | 訪問の市区町村名。 |
| 地域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 測定プロトコル：地理情報](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference?client_type=gtag#payload_geo_info)を参照してください。 |

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

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


<blockquote>
**ページビューイベントの送信**アクションは非推奨です。`page_view`イベントを送信するには、[イベントの送信 (gtag.js) アクション](#send-event-gtagjs)を使用してください。
</blockquote>


#### 本文パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| クライアントID | (必須) クライアントの一意の識別子。詳細については、[クライアントIDのマッピング](#mapping-client-id)を参照してください。 |
| 測定IDオーバーライド | Google Analyticsデータストリームの識別子。Google Analytics UIの**管理 > データストリーム > ストリームを選択 > 測定ID**で見つかります。この構成は**構成**セクションの**測定ID**を上書きします。 |
| APIシークレットオーバーライド | データストリームの測定プロトコルAPIシークレット。この構成は**構成**セクションの**APIシークレット**を上書きします。 |
| ユーザーID | ユーザーの一意の識別子。この識別子についての詳細は、[GA4ヘルプ: ユーザーIDによるクロスプラットフォーム分析](https://support.google.com/analytics/answer/9213390)を参照してください。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 測定プロトコルは、イベントの検証を行うために以下のエンドポイントを提供しています：

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

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