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,请将其设置为小于或等于的时间戳 请求时间。