借助 Google Analytics Measurement Protocol,您可以 与您已通过代码植入或 Firebase SDK 收集的数据搭配使用。
本指南介绍了 Google Analytics Measurement Protocol 的常见用例及其要求。
要求摘要
下表提供了针对每种用途的相关要求的快速参考 这种情况。请牢记以下最佳实践:
事件和用户属性的
timestamp_micros
默认为请求 。发送在 根据发送事件指南中的说明替换时间戳,并 用户属性指南。为了获得准确的实时报告和互动指标,请在
engagement_time_msec
事件参数已设置为自以下时间起经过的毫秒数: 事件。
使用场景 | 会话 ID | 申请时间要求 | timestamp_micros 项要求 |
---|---|---|---|
为事件指定 User-ID | 必填 | <= 会话结束时间(工作日) | >= 会话开始且 <= 会话结束 |
会话归因 | 必填 | <= 会话开始 + 24 小时 | >= 会话开始且 <= 会话结束 |
将事件导出到广告平台 | 不需要 | <= 上个会话工作日 + 63 天 | <= 请求时间 |
发送受众群体的事件或用户属性 创建 | 不需要 | 网站:<= 最新的线上活动时间 + 30 天 应用:<= 最新线上活动时间 + 42 天 |
<= 请求时间 |
为事件指定 User-ID
使用 Measurement Protocol 为线上或线下事件提供 User-ID。
以下是向事件添加 User-ID 的一些示例用例:
您的在线衡量缺少查询 在线事件使用 User-ID,但您有一个事件处理流水线 能够在在线会话与 User-ID 之间建立关联。
在本例中,您使用 Measurement Protocol 提供 online 事件。
对于您使用 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
,请将其设置为小于或等于的时间戳 请求时间。