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 日，请在 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 小时内的时间戳。