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. 您的在线衡量缺少查询 在线事件使用 User-ID，但您有一个事件处理流水线 能够在在线会话与 User-ID 之间建立关联。

    在本例中，您使用 Measurement Protocol 提供 online 事件。

  2. 对于您使用 Measurement Protocol，但您希望将这些事件与 如果用户在会话过程中在线登录，则为 User-ID。

    在这种情况下，您要使用线上活动来 包含 User-ID 的 Measurement Protocol 事件。

以下是向活动添加 User-ID 的要求：

  • 在事件的参数列表中添加 session_id。
  • 在与 在线会话。
  • 如果您替换 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。

以下是一些适合使用该功能的常见场景：

  • 您的商家有您希望在广告中包含的线下事件 归因和报告
  • 系统中还有其他事件无法添加代码或 但您仍然希望将这些事件纳入到 产品。

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

  • 请在工作日后 63 天内发送请求 最新的在线事件，即使关键事件的归因回溯期较远 超过 63 天。

    例如，如果client_id的最新线上活动或 app_instance_id发生在 3 月 1 日，请发送 Measurement Protocol 活动结束日期不晚于 5 月 3 日工作日。

  • 如果您替换 timestamp_micros，请将其设置为小于或等于的时间戳 请求时间。

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

使用 Measurement Protocol 发送的事件和用户属性 如果您符合几项要求，则评估受众群体条件。

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

  • 在工作日结束前将请求发送到网站数据流 同一client_id的最新线上活动结束后 30 天。

    例如，如果client_id的最新线上活动发生在 3 月 1 日，在 。

  • 在工作日结束前将请求发送到应用数据流 同一app_instance_id的最新线上活动结束 42 天后。

    例如，如果app_instance_id的最新线上活动发生时 应在 3 月 1 日之前发送 Measurement Protocol 事件，该日期不能晚于 3 月 1 日 4 月 12 日的工作日。

  • 如果您替换 timestamp_micros，请将其设置为小于或等于的时间戳 请求时间。