Measurement Protocol は成熟した最終的なプロダクトの状態に達しており、サポート終了の予定はなく、引き続き運用されます。ただし、技術的な設定を将来にわたって有効にするには、Data Manager API を使用してサーバー間イベント統合を構築することをおすすめします。これは、今後のデータの取り込みのイノベーションに向けた Google の中心的なインフラストラクチャです。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Measurement Protocol のユースケース

Google アナリティクス Measurement Protocol を使用すると、タグ設定や Firebase SDK で収集しているデータに加えて、オフラインデータをウェブストリームまたはアプリストリームに送信できます。

このガイドでは、Google アナリティクス Measurement Protocol の一般的なユースケースとその要件について説明します。

要件の概要

この表では、ユースケースごとの要件を簡単に確認できます。以下のベストプラクティスを念頭に置くようにしてください。

イベントとユーザープロパティの timestamp_micros には、デフォルトでリクエストの日時が使用されます。過去に発生したイベントまたはユーザープロパティの変更を送信する場合、イベントの送信に関するガイドとユーザープロパティに関するガイドの説明に従ってタイムスタンプをオーバーライドします。
リアルタイムの正確なレポートやエンゲージメント指標を確認する場合は、先行するイベントからのミリ秒単位の経過時間を engagement_time_msec イベントパラメータに設定したものを含めてください。

ユースケース	セッション ID	リクエストの日時の要件	`timestamp_micros` の要件
User-ID をイベントに割り当てる	必須	セッションが開始した営業日の終了まで	セッションの開始からセッションの終了まで
セッションアトリビューション	必須	セッションの開始から 24 時間後まで	セッションの開始からセッションの終了まで
イベントを広告プラットフォームにエクスポートする	不要	最後のセッションが発生した日から 63 日後まで	リクエストの日時から 72 時間前以降、リクエストの日時まで
オーディエンスを作成する目的で、イベントまたはユーザープロパティを送信する	不要	ウェブ: 直近のオンラインイベントの日時から 30 日後までアプリ: 直近のオンラインイベントの日時から 42 日後まで	リクエストの日時から 72 時間前以降、リクエストの日時まで

User-ID をイベントに割り当てる

Measurement Protocol を使用して、オンラインイベントまたはオフラインイベントに User-IDを指定します。

イベントに User-ID を追加するユースケースの例を次に示します。

オンライン測定では、オンラインイベントの User-ID を検索するために必要な情報が不足していますが、オンラインセッションと User-ID を関連付けることができるイベント処理パイプラインがあります。

このシナリオでは、Measurement Protocol を使用して、オンラインイベントに User-ID を指定します。
Measurement Protocol で送信するイベントの User-ID はありませんが、セッション中にユーザーがオンラインでログインした場合は、それらのイベントを User-ID に関連付けたいと考えています。

このシナリオでは、オンラインイベントを使用して、Measurement Protocol イベントに User-ID を指定します。

イベントに User-ID を追加するための要件は次のとおりです。

イベントのパラメータリストに session_id を含めます。
オンラインセッションと同じ営業日に Measurement Protocol イベントを送信します。
timestamp_micros をオーバーライドする場合は、オンラインセッションの開始時刻と終了時刻の間のタイムスタンプに設定します。
オンラインイベントに User-ID を指定することが目的の場合は、リクエストで user_id を設定します。
各 Measurement Protocol イベントに、対応するオンラインセッションの User-ID を指定することが目的の場合は、user_id を設定する必要はありません。

セッションアトリビューション

特定の要件を満たす Measurement Protocol イベントは、同じセッションのオンラインイベントと同じセッション属性（地域情報、参照元、メディア、キャンペーンなど）でレポートに表示されます。

セッションアトリビューションの要件は次のとおりです。

イベントのパラメータリストに session_id を含めます。
オンラインセッションの開始から 24 時間以内にリクエストを送信します。

たとえば、プロパティのタイムゾーンで月曜日の午前 11 時 15 分にセッションが開始された場合は、火曜日の午前 11 時 15 分までにリクエストを送信します。
timestamp_micros をオーバーライドする場合は、オンラインセッションの開始時刻と終了時刻の間のタイムスタンプに設定します。

イベントを広告プラットフォームにエクスポートする

Google アナリティクスでは、Measurement Protocol を使用して送信したイベントが、Google 広告や Campaign Manager 360 などのリンクされた広告プロダクトへのエクスポートに含まれます。

この機能が役立つ一般的なシナリオをいくつかご紹介します。

広告のアトリビューションとレポートに含めたいオフラインイベントがある。
タグ設定や Firebase SDK では利用できないシステムに追加のイベントがあるが、それらのイベントをリンクされたプロダクトに含めたい。

イベントを広告プラットフォームにエクスポートするための要件は次のとおりです。

キーイベントのアトリビューション期間が 63 日を超えている場合でも、直近のオンラインイベントから 63 日以内にリクエストを送信します。また、イベントはキーイベントのアトリビューション期間内に到着する必要があります。アトリビューション期間の設定方法をご覧ください。

たとえば、client_id または app_instance_id の直近のオンラインイベントが 3 月 1 日に発生した場合は、5 月 3 日までに Measurement Protocol イベントを送信します。
timestamp_micros をオーバーライドする場合は、過去 72 時間以内のタイムスタンプに設定します。

オーディエンスを作成する目的で、イベントまたはユーザープロパティを送信する

Measurement Protocol を使用して送信されたイベントとユーザープロパティは、オーディエンス条件の評価に含まれます（いくつかの要件を満たしている場合）。

オーディエンスを作成する目的で、イベントまたはユーザープロパティを送信するための要件は次のとおりです。

同じ client_id の直近のオンラインイベントから 30 日以内に、ウェブストリームにリクエストを送信します。

たとえば、client_id の直近のオンラインイベントが 3 月 1 日に発生した場合は、3 月 31 日までに Measurement Protocol イベントを送信します。
同じ app_instance_id の直近のオンラインイベントから 42 日以内に、アプリストリームにリクエストを送信します。

たとえば、app_instance_id の直近のオンラインイベントが 3 月 1 日に発生した場合は、4 月 12 日までに Measurement Protocol イベントを送信します。
timestamp_micros をオーバーライドする場合は、過去 72 時間以内のタイムスタンプに設定します。