Measurement Protocol 用例

借助 Google Analytics Measurement Protocol，除了通过代码或 Firebase SDK 收集的数据之外，您还可以向网站或应用数据流发送线下数据。

本指南介绍了 Google Analytics Measurement Protocol 的常见应用场景及其要求。

要求摘要

下表简要提供了每种应用场景的要求供您快速参考。请牢记以下最佳实践：

  1. 事件和用户属性的 timestamp_micros 默认为请求发生的时间。当发送过去发生的事件或用户属性变更时，请按照发送事件指南和用户属性指南中所述替换该时间戳。

  2. 为了确保实时报告和互动指标的准确性，请添加 engagement_time_msec 事件参数，并将其设置为自前一个事件以来经过的毫秒数。

使用场景 会话 ID 请求时间要求 timestamp_micros 要求
将 User-ID 分配给事件 必填 <= 会话开始的工作日结束时间 >= 会话开始时间且 <= 会话结束时间
会话归因 必填 <= 会话开始时间 + 24 小时 >= 会话开始时间且 <= 会话结束时间
将事件导出到广告平台 不需要 <= 最后一个会话所在日期 + 63 天 >= 请求时间减去 72 小时且 <= 请求时间
发送事件或用户属性以创建受众群体 不需要 网站：<= 最新在线事件发生时间 + 30 天
应用：<= 最新在线事件发生时间 + 42 天		 >= 请求时间减去 72 小时且 <= 请求时间

将 User-ID 分配给事件

使用 Measurement Protocol 为线上或线下事件提供 User-ID。

以下是向事件添加 User-ID 的一些应用场景示例：

  1. 您的线上衡量缺少查找线上事件 User-ID 所需的信息，但您有一个事件处理流水线，能够将线上会话与 User-ID 相关联。

    在此场景中，您将使用 Measurement Protocol 提供包含 User-ID 的线上事件。

  2. 您没有通过 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 Analytics 会将您使用 Measurement Protocol 发送的事件包含在导出到关联的广告产品（例如 Google Ads 或 Campaign Manager 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 日，则发送 Measurement Protocol 事件的时间不得晚于 3 月 31 日。

  • 在同一 app_instance_id 的最新线上事件发生后 42 天内，将请求发送到应用数据流。

    例如，如果 app_instance_id 的最新在线事件发生在 3 月 1 日，则发送 Measurement Protocol 事件的时间不得晚于 4 月 12 日。

  • 如果您替换 timestamp_micros，请将其设置为过去 72 小时内的时间戳。