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 天	>= 请求时间减去两个工作日，且 <= 请求时间
发送事件或用户属性以创建受众群体	不需要	网站：<= 最新在线事件发生时间 + 30 天 应用：<= 最新在线事件发生时间 + 42 天	>= 请求时间减去两个工作日，且 <= 请求时间

将 User-ID 分配给事件

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

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

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

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

2. 您通过 Measurement Protocol 发送的事件没有 User-ID，但您希望这些事件在用户在会话期间在线登录后与 User-ID 相关联。

   在此方案中，您使用线上事件来提供带有 User-ID 的 Measurement Protocol 事件。

以下是将 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，请将其设置为过去三个工作日内的某个时间戳。

发送事件或用户属性以创建受众群体

如果您遵循一些要求，则使用 Measurement Protocol 发送的事件和用户属性会纳入受众群体条件的评估范围。

以下是发送事件或用户属性以创建受众群体的要求：

• 在同一 client_id 的最新在线事件发生后 30 天内（最晚在当天营业结束前），将请求发送到 Web 数据流。

  例如，如果 client_id 的最新在线事件发生在 3 月 1 日，请在 3 月 31 日营业日结束之前发送 Measurement Protocol 事件。

• 在同一 app_instance_id 的最新在线活动发生后的 42 天内（不得晚于该工作日结束时），将请求发送到应用数据流。

  例如，如果 app_instance_id 的最新在线事件发生在 3 月 1 日，请在 4 月 12 日营业日结束之前发送 Measurement Protocol 事件。

• 如果您要替换 timestamp_micros，请将其设置为过去 3 个工作日内的时间戳。