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

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

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 を使用して、オンラインまたはオフラインのイベントにユーザー ID を指定します。

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

オンライン測定には、オンラインイベントのユーザー ID を検索するために必要な情報がありませんが、オンラインセッションとユーザー 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 広告やキャンペーンマネージャー 360 などのリンクされた広告サービスへのエクスポートに含まれます。

この機能が役立つ一般的なシナリオは次のとおりです。

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

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

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

たとえば、client_id または app_instance_id の最新のオンラインイベントが 3 月 1 日に発生した場合、Measurement Protocol イベントは 5 月 3 日までに送信します。
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 日に発生した場合、Measurement Protocol イベントは 4 月 12 日までに送信します。
timestamp_micros をオーバーライドする場合は、過去 72 時間以内のタイムスタンプに設定します。