---
title: Tealium + Google Analytics 4 測定プロトコル統合ガイド
description: この記事では、Tealiumと一緒にGoogle Analytics 4 測定プロトコルタグとコネクタを構成し使用する方法について説明します。
url: https://docs.tealium.com/ja/partners-and-industries/tech-partners/google-analytics-4-measurement-protocol-connector-integration-guide/
---
## 動作原理

[Google Analytics 4 測定プロトコルコネクタ](https://docs.tealium.com/google-analytics-4-measurement-protocol-connector/)は、開発者がHTTPリクエストを行い、イベントを直接Google Analyticsサーバーに送信することを可能にします。これにより、開発者はHTTPが有効な環境からビジネスとのユーザーのやり取りを測定でき、サーバー間でのやり取りが発生する場合でも簡単に測定できます。

Tealium EventStreamは、Google Analytics 4のトラッキングを可能にするための伝送路として機能します。モバイル、IoT、オフラインイベントおよびページビューのトラッキングをサポートすることにより、以下を実現します：

* Webアプリケーションとアプリの両方をトラッキング。
* オンラインとオフラインの行動を結びつける。
* クライアントサイドとサーバーサイドの両方でのやり取りを測定。
* 標準的なユーザーインタラクション以外で発生するイベントを送信。

![](https://docs.tealium.com/images/server-side-connectors/googleanalytics4measurementprotocoldiagram.png)

Tealiumは、Google Analytics 4 測定プロトコルコネクタで以下のアクションをサポートしています：

* ページビューイベントを送信
* イベントを送信
* Firebaseイベントを送信

図に表示されているGoogle Analytics 4タグの追加の構成詳細については、[Google Analytics 4 (GA4) タグ構成ガイド](https://docs.tealium.com/google-analytics-4-ga4-tag/)を参照してください。

### 考慮事項


<blockquote>
Google Analytics 4の測定プロトコルコネクタは、クライアントサイドタグソリューションの完全な代替品ではありません。
</blockquote>


### 制限事項

* セッションまたはユーザーデータが必要な場合、クライアントサイドタグが必要です。
* `user_id`キーは、クライアントサイドと測定プロトコルのイベントの両方に`user_id`を含める必要があります。
* 現在のGA4測定プロトコルAPIではセッションデータはサポートされていません。自動的なGoogle Analyticsセッションデータを取得するには、Google Analytics 4 (GA4) タグを使用する必要があります。
  * タグを有効にすると、`session_start`および`first_visit`イベントも送信されます。
* パラメータ値は100文字に制限されています。100文字を超える値は、最終的なGA4レポートから切り捨てられるか、削除されます。
* `utm`パラメータはサポートされていません。
* キャンペーンおよびトラフィックソースデータの送信はサポートされていません。
* 地理データおよびユーザーエージェントを含まない。

## 認証

測定プロトコルAPIは、URLのクエリパラメータとして含まれる測定IDとAPIシークレットを使用します。

```
https://google-analytics.com/mp/collect?measurement_id=G-1234567890&api_secret=xxxxxxxxxx
```

## 構成

コネクタを構成するには、APIシークレットとデータストリームの測定IDまたはFirebase IDを入力します。

## レスポンス/デバッグ

測定プロトコルは、HTTPリクエストが受信された場合に常に`2xx`ステータスコードを返します。ペイロードデータが不正であったり、ペイロードのデータが誤っていたり、Google Analyticsによって処理されなかった場合、測定プロトコルはエラーコードを返しません。

Googleはイベントの検証用に別のエンドポイントを提供しています：

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

Tealium測定プロトコルコネクタは、このエンドポイントをTrace中に使用し、イベントデータの検証プロセスを表示します。

### 推奨事項と構成の詳細

指摘された制限を緩和し、すべてのデータ要件を完全にカバーするために、Tealium iQタグ管理で[Google Analytics 4タグ](https://docs.tealium.com/google-analytics-4-ga4-tag/)を実装し、すべてのページでタグをロードするように構成します。**Send Page View**は`false`に構成します。さらに、Google `clientId`が自動的に`utag_main__ga`クッキー値として追加されるように、Google Analytics Cookie Matching Serviceタグを追加します。

Googleの自動収集イベント以外の必要なイベントは、Tealium EventStreamのGoogle Analyticsコネクタで構成できます。

Google Analytics 4タグは、E-commerce拡張マッピングを通じて`order_id`が存在する場合に自動的に購入イベントをトリガーします。E-commerce拡張機能を有効にしており、EventStreamを通じて購入を追跡したい場合は、Google Analytics 4にスコープされた[Set Data Values](https://docs.tealium.com/set-data-values-extension/)拡張機能を構成して、`_corder`属性をクリアします。

![](https://docs.tealium.com/images/server-side-connectors/googleanalytics4measurementprotocolsetdatavalues.png)

Tealiumは、Webクライアント統合に対応するクライアントサイド実装をサポートするだけでなく、TealiumのEventStreamを通じてモバイルおよびオフラインイベントもサポートするため、両方のソリューションと統合し、組み合わせたアプローチを作成できます。

クライアントサイドタグの構成に関する詳細情報については、[Google Analytics 4 (GA4) タグ構成ガイド](https://docs.tealium.com/google-analytics-4-ga4-tag/)を参照してください。

### 前提条件

| 製品 | 必要 | 
| --- | --- |
| Google Analytics 4アカウント| 	✓| 
| Tealium EventStream / AudienceStream	| ✓| 
| Tealium iQタグ管理	|   任意ですが、推奨されます| 

### 認証

| 値	 | 説明	| 場所 |
| ---| ---| --- | 
| APIシークレット (必須)	| Google Analytics UIで生成されたAPIシークレット。| 	新しいシークレットを作成するには、**管理** > **データストリーム** > **ストリームを選択** > **測定プロトコル** > **追加構成** > **測定プロトコルAPIシークレット**に進みます。| 
| 測定ID (任意)	| ストリームに関連付けられた測定ID。	| Google Analytics UIで、**管理** > **データストリーム** > **ストリームを選択** > **測定ID** > **作成**に進みます。| 
| FirebaseアプリID (任意)| Firebaseアプリの識別子。| 	Firebaseコンソールで、**プロジェクト構成** > **一般** > **アプリ** > **アプリID**に進みます。 |

APIバージョン: ベータ

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

| パラメータ | 説明 | 
| --- | --- |
| ページタイトル | ページのタイトルです。 | 
| ページ位置 | （必須）ページの完全なURLです。 | 
| ユーザープロパティ | ユーザーベースのセグメントを記述するユーザープロパティ、例えば言語の好みや地理的な位置です。これらは**テンプレート**セクションに構成できます。 | 
| アイテムID | アイテムIDまたはアイテム名のいずれかが必要です。 | 
| アイテム名 | アイテムIDまたはアイテム名のいずれかが必要です。 | 
| 所属 | 製品の所属を指定して、供給会社または物理的な店舗の位置を示します。イベントレベルとアイテムレベルの所属パラメータは独立しています。 | 
| クーポン | アイテムに関連付けられたクーポン名またはコードです。イベントレベルとアイテムレベルのクーポンパラメータは独立しています。 |
| 通貨 | 3文字のISO 4217形式の通貨です。構成されている場合、イベントレベルの通貨は無視されます。イベント内で複数の通貨はサポートされていないため、すべてのエントリーは同じ通貨値を含みます。 | 
| 割引（数値） | アイテムに関連付けられた金額の割引値です。 | 
| インデックス（数値） | リスト内のアイテムのインデックスまたは位置です。 | 
| アイテムブランド | アイテムのブランドです。 | 
| アイテムカテゴリ | アイテムのカテゴリです。カテゴリ階層または分類法の一部として使用される場合、これは最初のカテゴリです。 | 
| アイテムカテゴリ2 | アイテムの第二のカテゴリ階層または追加の分類法です。 | 
| アイテムカテゴリ3 | アイテムの第三のカテゴリ階層または追加の分類法です。 | 
| アイテムカテゴリ4 | アイテムの第四のカテゴリ階層または追加の分類法です。 | 
| アイテムカテゴリ5 | アイテムの第五のカテゴリ階層または追加の分類法です。 | 
| アイテムリストID | ユーザーに提示されたリストのIDです。<ul><li>構成されている場合、イベントレベルの`item_list_id`は無視されます。</li><li>構成されていない場合、存在する場合はイベントレベルの`item_list_id`が使用されます。</li></ul>| 
| アイテムリスト名 | ユーザーに提示されたリストの名前です。<ul><li>構成されている場合、イベントレベルの`item_list_name`は無視されます。</li><li>構成されていない場合、存在する場合はイベントレベルの`item_list_name`が使用されます。</li></ul>|
| アイテムバリアント | アイテムのバリアントまたは追加のアイテム詳細やオプションに関する一意のコードや説明です。|
| ロケーションID | アイテムに関連付けられた場所です。関連するアイテムに対応するGoogle Place IDの使用を推奨します。カスタムロケーションIDも使用できます。<ul><li>構成されている場合、イベントレベルの`location_id`は無視されます。</li><li>構成されていない場合、存在する場合はイベントレベルの`location_id`が使用されます。</li></ul>|
| 価格（数値） | 指定された通貨単位のアイテムの金額です。|
| 数量（数値） | アイテムの数量です。|
| テンプレート変数 | テンプレートにデータ入力としてテンプレート変数を提供します。詳細については、[connector-template-variables](https://docs.tealium.com/connector-template-variables/)を参照してください。例えば、`items.name`のようにドット表記でネストされたテンプレート変数を名付けます。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。|
| テンプレート | ユーザープロパティで参照されるテンプレートを提供します。詳細については、[about-connector-templates](https://docs.tealium.com/about-connector-templates/)を参照してください。テンプレートは、例えば`{{SomeTemplateName}}`のように、サポートされているフィールドに名前でダブルカーリーブレースで注入されます。|

## PageViewイベントの送信

### 概要

このアクションは、ウェブサイトのページビューイベントをGoogle Analyticsに渡すために使用されます。

### ボディパラメータ

| パラメータ | 説明 |
| --- | --- |
| クライアントID | （必須）クライアントの一意の識別子です。<br><br>この識別子は、Google Analytics 4タグによって構成されたクライアントIDを使用する必要があります。詳細については、[Google Analytics 4 (GA4) タグ構成ガイド](https://docs.tealium.com/google-analytics-4-ga4-tag/)を参照してください。|
| 測定IDオーバーライド | 測定IDです。例えば、データストリームの識別子です。|
| FirebaseアプリIDオーバーライド | （必須）Firebaseアプリの識別子です。この構成は**構成**セクションで使用されるFirebaseアプリIDを上書きします。|
| ユーザーID | ユーザーの一意の識別子です。Google Analytics 4測定プロトコルイベントに`user_id`を含める場合、クライアントサイドのイベントにもそれを含める必要があります。|
| タイムスタンプマイクロ秒 | イベントに関連付ける時間のUnixタイムスタンプ（マイクロ秒単位）です。過去に発生したイベントを記録するためにこの値を構成します。この値は`user_property`またはイベントのタイムスタンプを介して上書きすることができます。イベントは、プロパティのタイムゾーンに基づいて最大3カレンダー日まで遡って日付を構成することができます。|
| 非パーソナライズ広告 | これらのイベントがパーソナライズ広告に使用されないことを示すために、これをtrueに構成します。|

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

| パラメータ | 説明 |
| --- | --- |
| ページタイトル | ページのタイトルです。 |
| ページ位置 | （必須）ページの完全なURLです。 |

追加のパラメータを渡すことができますが、ページビューイベントの追跡には必要ありません。

#### Googleペイロード

次の例のペイロードに示されているように、`events.name`の値は`page_view`であり、必要なパラメータは`page_location`と`client_id`です：

```json
{
  "events": [
    {
      "name": "page_view",
      "params": {
        "page_location": "http://demosite.com/ecomm/category.html",
        ...他のマップされたパラメータ...
      }
    }
  ],
  "client_id": "017f6ae7e7a40014b19d17739b3d05079002707100fb8"
}
```

## イベントの送信

### 概要

このアクションは、Google Analyticsに非ページビューイベントを送信するために使用されます。Googleが定義したイベントタイプのリストからイベントタイプを選択することができます（詳細については、[Measurement Protocol (Google Analytics 4) Events](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events)を参照してください）。さらに、カスタムイベントを選択し、カスタムイベント値を**カスタムイベントタイプ**にマッピングすることができます。

### ボディパラメータ

| パラメータ | 説明 |
| --- | --- |
| クライアントID | （必須）クライアントの一意の識別子です。Google Analytics 4タグによって構成されたクライアントIDです。Cookie Matching Tagが推奨される実装方法です。|
| 測定IDオーバーライド | 測定IDです。例えば、データストリームの識別子です。|
| FirebaseアプリIDオーバーライド | （必須）Firebaseアプリの識別子です。この構成は**構成**セクションで使用されるFirebaseアプリIDを上書きします。|
| ユーザーID | ユーザーの一意の識別子です。Google Analytics 4測定プロトコルイベントに`user_id`を含める場合、クライアントサイドのイベントにもそれを含める必要があります。|
| タイムスタンプマイクロ秒 | イベントに関連付ける時間のUnixタイムスタンプ（マイクロ秒単位）です。過去に発生したイベントを記録するためにこの値を構成します。この値は`user_property`またはイベントのタイムスタンプを介して上書きすることができます。イベントは、プロパティのタイムゾーンに基づいて最大3カレンダー日まで遡って日付を構成することができます。|
| 非パーソナライズ広告 | これらのイベントがパーソナライズ広告に使用されないことを示すために、これをtrueに構成します。|
### イベントとイベントパラメータ

以前にリストされた一般的なイベントパラメータに加えて、各イベントタイプは追加のパラメータを受け入れます。以下の表は、各イベントタイプに必要なパラメータとオプションのパラメータをリストしています：

| イベントタイプ | 説明 | イベント固有のパラメータ |
|-----|-----|-----|
| 支払情報の追加 | ユーザーが支払情報を提出したとき。 | イベントパラメータ：<ul><li>通貨（必須）</li><li>価値（必須）</li></ul>アイテムパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| 配送情報の追加 | ユーザーが配送情報を提出したとき。 | イベントパラメータ：<ul><li>通貨（必須）</li><li>価値（必須）</li><li>クーポン（オプション）</li><li>配送層（オプション）</li></ul>アイテムパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| ほしい物リストへの追加 | アイテムがほしい物リストに追加されたとき。このイベントを使用して、アプリ内で人気のギフトアイテムを特定します。 | イベントパラメータ：<ul><li>通貨（必須）</li><li>価値（必須）</li></ul>アイテムパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| チェックアウト開始 | ユーザーがチェックアウトを開始したとき。 | イベントパラメータ：<ul><li>通貨（必須）</li><li>価値（必須）</li><li>クーポン（オプション）</li></ul>アイテムパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| 仮想通貨の獲得 | ユーザーが仮想通貨を授与されたとき。このイベントを `spend_virtual_currency` と一緒に記録して、仮想経済をよりよく理解します。 | イベントパラメータ：<ul><li>仮想通貨名（オプション） - 仮想通貨の名前。</li><li>価値（オプション） - 仮想通貨の価値。</li></ul> |
| リードの生成 | リードが生成されたとき。このイベントを使用して、再エンゲージメントキャンペーンの効果をよりよく理解します。 | イベントパラメータ：<ul><li>通貨（必須）</li><li>価値（必須）</li></ul> |
| グループへの参加 | ユーザーがグループ（ギルド、チーム、ホーム族など）に参加したとき。このイベントを使用して、特定のグループやソーシャル機能の人気を分析します。 | イベントパラメータ：<ul><li>グループID（オプション） - グループのID。</li></ul> |
| レベルアップ | プレイヤーがレベルアップしたとき。このイベントを使用して、ユーザーベースのレベル分布を測定し、完了が困難なレベルを特定します。 | イベントパラメータ：<ul><li>レベル（オプション） - キャラクターのレベル。</li><li>キャラクター（オプション） - レベルアップしたキャラクター。</li></ul> |
| ログイン | ユーザーがログインしたとき。 | イベントパラメータ：<ul><li>方法（オプション） - ログインに使用された方法。</li></ul> |
| スコアの投稿 | ユーザーがスコアを投稿したとき。このイベントを使用して、ゲーム内でユーザーのパフォーマンスを理解し、高スコアをオーディエンスや行動と相関させます。 | イベントパラメータ：<ul><li>スコア（必須） - 投稿するスコア。</li><li>レベル（オプション） - キャラクターのレベル。</li><li>キャラクター（オプション） - レベルアップしたキャラクター。</li></ul> |
| 購入 | ユーザーが一つ以上のアイテムを購入したとき。 | イベントパラメータ：<ul><li>トランザクションID（必須）</li><li>価値（必須）</li><li>通貨（必須）</li></ul>アイテムパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| 払い戻し | ユーザーに払い戻しが発行されたとき。 | イベントパラメータ：<ul><li>トランザクションID（必須）</li><li>価値（必須）</li><li>通貨（必須）</li></ul>アイテムパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| カートからの削除 | ユーザーがカートからアイテムを削除したとき。 | イベントパラメータ：<ul><li>通貨（必須）</li><li>価値（必須）</li></ul>アイテムパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| 検索 | ユーザーが検索を実行したとき。このイベントを使用して、アプリ内で最も人気のあるコンテンツを特定するのに役立てます。 | イベントパラメータ：<ul><li>検索語（必須）</li></ul> |
| コンテンツの選択 | ユーザーが特定のタイプのコンテンツを選択したとき。このイベントを使用して、アプリ内で人気のコンテンツやコンテンツのカテゴリを特定します。 | イベントパラメータ：<ul><li>コンテンツタイプ（オプション）</li><li>アイテムID（オプション）</li></ul> |
| アイテムの選択 | ユーザーがリストからアイテムを選択したとき。 | イベントパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| プロモーションの選択 | ユーザーがリストからプロモーションを選択したとき。 | イベントパラメータ：<ul><li>クリエイティブ名（オプション）</li><li>クリエイティブスロット（オプション）</li><li>ロケーションID（オプション）</li><li>プロモーションID（オプション）</li><li>プロモーション名（オプション）</li></ul>アイテムパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| 共有 | ユーザーがコンテンツを共有したとき。 | イベントパラメータ：<ul><li>方法（オプション）</li><li>コンテンツタイプ（オプション）</li><li>アイテムID（オプション）</li></ul> |
| サインアップ | ユーザーがアカウントにサインアップしたとき。このイベントを使用して、ログインしているユーザーとログアウトしているユーザーの違いを理解します。 | イベントパラメータ：<ul><li>方法（オプション）</li></ul> |
| 仮想通貨の使用 | ユーザーが仮想商品を購入したとき。このイベントを使用して、最も人気のある仮想商品を特定します。 | イベントパラメータ：<ul><li>価値（必須）</li><li>仮想通貨名（必須）</li></ul> |
| チュートリアル開始 | ユーザーがオンボーディングプロセスを開始したとき。このイベントを `tutorial_complete` と一緒に使用して、チュートリアルを完了するユーザーの数を測定します。 | このイベントに必要なパラメータはありません。 |
| チュートリアル完了 | ユーザーがオンボーディングプロセスを完了したとき。このイベントを `tutorial_begin` と一緒に使用して、チュートリアルを完了するユーザーの数を測定します。 | このイベントに必要なパラメータはありません。 |
| 実績の解除 | ユーザーが実績を解除したとき。このイベントを使用して、ユーザーがゲームをどのように体験しているかをよりよく理解します。 | イベントパラメータ：<ul><li>実績ID（必須）</li></ul> |
| カートの表示 | ユーザーが自分のカートを表示したとき。 | イベントパラメータ：<ul><li>通貨（必須）</li><li>価値（必須）</li></ul>アイテムパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| アイテムの表示 | ユーザーが特定のコンテンツを表示したとき。このイベントを使用して、最も人気のある表示アイテムを特定します。 | イベントパラメータ：<ul><li>通貨（必須）</li><li>価値（必須）</li></ul>アイテムパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| アイテムリストの表示 | ユーザーが特定のカテゴリのアイテムリストを表示したとき。 | イベントパラメータ：<ul><li>アイテムリストID（必須）</li><li>アイテム名（必須）</li></ul>アイテムパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| プロモーションの表示 | ユーザーがリストからプロモーションを表示したとき。 | イベントパラメータ：<ul><li>クリエイティブ名（オプション）</li><li>クリエイティブスロット（オプション）</li><li>ロケーションID（オプション）</li><li>プロモーションID（オプション）</li><li>プロモーション名（オプション）</li></ul>アイテムパラメータ：<ul><li>アイテムID（必須）</li><li>アイテム名（必須）</li></ul> |
| 検索結果の表示 | ユーザーに検索結果が提示されたとき。 | イベントパラメータ：<ul><li>検索語（オプション）</li></ul> |
| カスタムイベント | Googleのプリセットイベントによって定義されていないカスタムイベントをサポートするためにこのイベントを使用します。 | このイベントに必要なパラメータはありません。 |

サポートされているイベントの完全なリストを表示するには、[Measurement Protocol - Google Analytics 4 events](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events)を参照してください。

## Firebaseイベントの送信


### 概要

このアクションは、FirebaseイベントをGoogleアナリティクスに送信するために使用されます。構成は「イベント送信」と同じですが、アプリインスタンスIDも提供する必要があります。

このコネクタアクションイベントタイプは、主にモバイルアプリケーションデータをFirebaseに渡して分析するために使用されます。

| パラメータ | 説明 |
| --- | --- |
| アプリインスタンスID | (必須) Firebaseアプリの特定のインストールを一意に識別します。この値はFirebase SDKを通じて取得できます。 |
| FirebaseアプリIDオーバーライド | (必須) Firebaseアプリの識別子です。この構成は**構成**セクションで使用されるFirebaseアプリIDを上書きします。 |
| ユーザーID (オプション) | ユーザーの一意の識別子です。 |
| タイムスタンプマイクロ秒 (オプション) | イベントに関連付ける時間のUnixタイムスタンプ（マイクロ秒単位）。 |
| 非パーソナライズ広告 (オプション) | これらのイベントがパーソナライズされた広告に使用されないことを示すために、これをtrueに構成します。 |

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

このアクションは、「イベント送信」アクションと同じ一般的なイベントパラメータをサポートし、同じイベント固有のパラメータもサポートします。

### ユーザープロパティ

ユーザープロパティは、言語の好みや地理的な位置など、ユーザーベースのセグメントを記述します。アナリティクスは[自動的にいくつかのユーザープロパティを記録します](https://support.google.com/analytics/answer/9268042)。追加のプロパティを収集したい場合は、プロジェクトごとに最大25の追加ユーザープロパティを構成できます。[GA4カスタムディメンション](https://support.google.com/analytics/answer/9269570)とメトリクス、および[Firebaseカスタムユーザープロパティ](https://developers.google.com/analytics/devguides/collection/protocol/ga4/user-properties?client_type=firebase#example_usage)について読んで、ユーザープロパティの構成と登録方法を学びましょう。