Tealium + Google Analytics 4 測定プロトコル統合ガイド
この記事では、Tealiumと一緒にGoogle Analytics 4 測定プロトコルタグとコネクタを構成し使用する方法について説明します。
動作原理
Google Analytics 4 測定プロトコルコネクタは、開発者がHTTPリクエストを行い、イベントを直接Google Analyticsサーバーに送信することを可能にします。これにより、開発者はHTTPが有効な環境からビジネスとのユーザーのやり取りを測定でき、サーバー間でのやり取りを簡単に測定できます。
Tealium EventStreamは、Google Analytics 4のトラッキングを可能にするための伝送路として機能します。モバイル、IoT、オフラインイベントおよびページビューのトラッキングを統合することにより、以下のサポートを提供します：
- Webアプリケーションとアプリの両方をトラッキング。
- オンラインとオフラインの行動を結びつける。
- クライアントサイドとサーバーサイドの両方でのやり取りを測定。
- 標準的なユーザーインタラクション以外で発生するイベントを送信。
Tealiumは、Google Analytics 4 測定プロトコルコネクタで以下のアクションをサポートしています：
- ページビューイベントを送信
- イベントを送信
- Firebaseイベントを送信
図に表示されているGoogle Analytics 4タグの追加の構成詳細については、Google Analytics 4 (GA4) タグ構成ガイドを参照してください。
考慮事項
Google Analytics 4の測定プロトコルコネクタは、クライアントサイドタグソリューションの完全な代替品ではありません。
制限事項
- セッションまたはユーザーデータが必要な場合、クライアントサイドタグが必要です。
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タグを実装します。すべてのページでタグをロードするように構成し、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拡張機能を構成して、_corder属性をクリアします。
Tealiumは、ウェブクライアント統合に対応するクライアントサイド実装をサポートすることができるだけでなく、TealiumのEventStreamを通じてモバイルおよびオフラインイベントもサポートするため、両方のソリューションと統合し、組み合わせたアプローチを作成することができます。
クライアントサイドタグの構成に関する詳細情報については、Google Analytics 4 (GA4) タグ構成ガイドを参照してください。
前提条件
| 製品 | 必要 |
|---|---|
| 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です。
|
| アイテムリスト名 | ユーザーに提示されたリストの名前です。
|
| アイテムバリアント | アイテムのバリアントまたは追加のアイテム詳細またはオプションに関する一意のコードまたは説明です。 |
| ロケーションID | アイテムに関連付けられた場所です。関連するアイテムに対応するGoogle Place IDの使用を推奨します。カスタムロケーションIDも使用できます。
|
| 価格（数値） | 指定された通貨単位のアイテムの金額です。 |
| 数量（数値） | アイテムの数量です。 |
| テンプレート変数 | テンプレートにデータ入力としてテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。ドット表記を使用してネストされたテンプレート変数に名前を付けます。例えば、items.nameです。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
| テンプレート | ユーザー属性で参照されるテンプレートを提供します。詳細については、コネクターテンプレートについてを参照してください。テンプレートは名前で二重中括弧によってサポートされるフィールドに注入されます。例えば、{{SomeTemplateName}}です。 |
PageViewイベントの送信
概要
このアクションは、ウェブサイトのページビューイベントをGoogle Analyticsに渡すために使用されます。
本文パラメータ
| パラメータ | 説明 |
|---|---|
| クライアントID | 必須。クライアントの一意の識別子です。 この識別子はGoogle Analytics 4タグによって構成されたクライアントIDを使用する必要があります。詳細については、Google Analytics 4 (GA4) タグ構成ガイドを参照してください。 |
| 測定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です：
{
"events": [
{
"name": "page_view",
"params": {
"page_location": "http://demosite.com/ecomm/category.html",
...other mapped parameters...
}
}
],
"client_id": "017f6ae7e7a40014b19d17739b3d05079002707100fb8"
}
イベントの送信
概要
このアクションは、ページビュー以外のイベントをGoogle Analyticsに送信するために使用されます。イベントタイプは、Googleが定義したイベントリストから選択することができます（詳細については、Measurement Protocol (Google Analytics 4) 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に構成します。 |
イベントとイベントパラメータ
以前にリストされた一般的なイベントパラメータに加えて、各イベントタイプは追加のパラメータを受け入れます。以下の表は、各イベントタイプに必要なパラメータとオプションのパラメータをリストしています：
| イベントタイプ | 説明 | イベント固有のパラメータ |
|---|---|---|
| 支払情報の追加 | ユーザーが支払情報を提出したとき。 | イベントパラメータ：
|
| 配送情報の追加 | ユーザーが配送情報を提出したとき。 | イベントパラメータ：
|
| ほしい物リストへの追加 | アイテムがほしい物リストに追加されたとき。このイベントを使用して、アプリ内で人気のギフトアイテムを特定します。 | イベントパラメータ：
|
| チェックアウト開始 | ユーザーがチェックアウトを開始したとき。 | イベントパラメータ：
|
| 仮想通貨の獲得 | ユーザーが仮想通貨を授与されたとき。このイベントを spend_virtual_currency と一緒に記録して、仮想経済をよりよく理解します。 |
イベントパラメータ：
|
| リードの生成 | リードが生成されたとき。このイベントを使用して、再エンゲージメントキャンペーンの効果をよりよく理解します。 | イベントパラメータ：
|
| グループへの参加 | ユーザーがグループ（ギルド、チーム、ホーム族など）に参加したとき。このイベントを使用して、特定のグループや社会的機能の人気を分析します。 | イベントパラメータ：
|
| レベルアップ | プレイヤーがレベルアップしたとき。このイベントを使用して、ユーザーベースのレベル分布を測定し、完了が困難なレベルを特定します。 | イベントパラメータ：
|
| ログイン | ユーザーがログインしたとき。 | イベントパラメータ：
|
| スコアの投稿 | ユーザーがスコアを投稿したとき。このイベントを使用して、ゲーム内でユーザーがどのようにパフォーマンスしているかを理解し、高スコアをオーディエンスや行動と相関させます。 | イベントパラメータ：
|
| 購入 | ユーザーが一つ以上のアイテムを購入したとき。 | イベントパラメータ：
|
| 払い戻し | ユーザーに払い戻しが発行されたとき。 | イベントパラメータ：
|
| カートからの削除 | ユーザーがカートからアイテムを削除したとき。 | イベントパラメータ：
|
| 検索 | ユーザーが検索を実行したとき。このイベントを使用して、アプリ内で最も人気のあるコンテンツを特定するのに役立てます。 | イベントパラメータ：
|
| コンテンツの選択 | ユーザーが特定のタイプのコンテンツを選択したとき。このイベントを使用して、アプリ内で人気のあるコンテンツやコンテンツのカテゴリを特定します。 | イベントパラメータ：
|
| アイテムの選択 | ユーザーがリストからアイテムを選択したとき。 | イベントパラメータ：
|
| プロモーションの選択 | ユーザーがリストからプロモーションを選択したとき。 | イベントパラメータ：
|
| 共有 | ユーザーがコンテンツを共有したとき。 | イベントパラメータ：
|
| サインアップ | ユーザーがアカウントにサインアップしたとき。このイベントを使用して、ログインしているユーザーとログアウトしているユーザーの違いを理解します。 | イベントパラメータ：
|
| 仮想通貨の使用 | ユーザーが仮想商品を購入したとき。このイベントを使用して、最も人気のある仮想商品を特定します。 | イベントパラメータ：
|
| チュートリアル開始 | ユーザーがオンボーディングプロセスを開始したとき。このイベントを tutorial_complete と一緒に使用して、チュートリアルを完了するユーザーの数を測定します。 |
このイベントに必要なパラメータはありません。 |
| チュートリアル完了 | ユーザーがオンボーディングプロセスを完了したとき。このイベントを tutorial_begin と一緒に使用して、チュートリアルを完了するユーザーの数を測定します。 |
このイベントに必要なパラメータはありません。 |
| 実績の解除 | ユーザーが実績を解除したとき。このイベントを使用して、ユーザーがゲームをどのように体験しているかをよりよく理解します。 | イベントパラメータ：
|
| カートの表示 | ユーザーが自分のカートを表示したとき。 | イベントパラメータ：
|
| アイテムの表示 | ユーザーが特定のコンテンツを表示したとき。このイベントを使用して、最も人気のある表示アイテムを特定します。 | イベントパラメータ：
|
| アイテムリストの表示 | ユーザーが特定のカテゴリのアイテムリストを表示したとき。 | イベントパラメータ：
|
| プロモーションの表示 | ユーザーがリストからプロモーションを表示したとき。 | イベントパラメータ：
|
| 検索結果の表示 | ユーザーに検索結果が表示されたとき。 | イベントパラメータ：
|
| カスタムイベント | Googleのプリセットイベントによって定義されていないカスタムイベントをサポートするためにこのイベントを使用します。 | このイベントに必要なパラメータはありません。 |
サポートされているイベントの完全なリストを表示するには、Measurement Protocol - Google Analytics 4 eventsを参照してください。
Firebaseイベントの送信
概要
このアクションは、FirebaseイベントをGoogleアナリティクスに送信するために使用されます。構成は「イベント送信」と同じですが、アプリインスタンスIDの提供も必要です。
このコネクタアクションイベントタイプは、主にモバイルアプリケーションデータをFirebaseに渡して分析するために使用されます。
| パラメータ | 説明 |
|---|---|
| アプリインスタンスID | 必須。Firebaseアプリの特定のインストールを一意に識別します。この値はFirebase SDKを通じて取得できます。 |
| FirebaseアプリIDオーバーライド | 必須。Firebaseアプリの識別子です。この構成は構成セクションで使用されるFirebaseアプリIDを上書きします。 |
| ユーザーID（オプション） | ユーザーの一意の識別子です。 |
| タイムスタンプマイクロ秒（オプション） | イベントに関連付ける時間のUnixタイムスタンプ（マイクロ秒単位）。 |
| 非パーソナライズ広告（オプション） | これらのイベントがパーソナライズ広告に使用されないことを示すために、これをtrueに構成します。 |
イベントパラメータ
このアクションは、「イベント送信」アクションと同じ一般的なイベントパラメータをサポートし、同じイベント固有のパラメータもサポートします。
ユーザープロパティ
ユーザープロパティは、言語の好みや地理的な位置など、ユーザーベースのセグメントを記述します。アナリティクスは自動的にいくつかのユーザープロパティを記録します。追加のプロパティを収集したい場合は、プロジェクトごとに最大25の追加ユーザープロパティを構成できます。GA4カスタムディメンションとメトリクスおよびFirebaseカスタムユーザープロパティを読んで、ユーザープロパティの構成と登録方法を学びましょう。
最終更新日 :: 2025年June月13日