此页面由 Cloud Translation API 翻译。

Measurement Protocol 用例

借助 Google Analytics Measurement Protocol，除了使用代码植入或 Firebase SDK 收集的数据之外，您还可以将离线数据发送到您的网站或应用数据流。

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

要求摘要

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

事件和用户属性的 timestamp_micros 默认为请求发生的时间。当发送过去发生的事件或用户属性变更时，请按照发送事件指南和用户属性指南中所述替换该时间戳。
为了确保实时报告和互动指标的准确性，请添加 engagement_time_msec 事件参数，并将其设置为自前一个事件以来经过的毫秒数。

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

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

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

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

在此方案中，您将使用 Measurement Protocol 提供包含 User-ID 的线上事件。
您通过 Measurement Protocol 发送的事件没有 User-ID，但您希望这些事件在用户在会话期间在线登录后与 User-ID 相关联。

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

以下是将 User-ID 添加到事件的要求：

符合特定要求的 Measurement Protocol 事件在报告中显示的会话属性（例如地理位置信息、来源、媒介和广告系列）与同一会话中的在线事件相同。

以下是会话归因的要求：

Google Analytics 会将您使用 Measurement Protocol 发送的事件纳入导出到关联的广告产品（例如 Google Ads 或 Campaign Manager 360）的数据中。

以下是一些常见的使用场景：

以下是将事件导出到广告平台的要求：

即使关键事件的归因时间范围超过 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 个工作日内的时间戳。