自定义报告期可以更快地生成事件级报告,并为可汇总报告提供选择性报告。
借助归因报告的自定义报告窗口(在 Chrome 110 中发布),您可以指示浏览器过滤掉在特定时间窗口之后发生的转化。
- 对于事件级报告,报告期可让您更快地获取报告,还可以过滤掉在特定时间范围之后发生的转化。根据您的目标,还可以将此视为一种权衡:使用报告时间范围可让您更快地获取报告,但这意味着您可能会丢失一些转化数据。如需了解详情,请参阅活动级部分。
- 对于可汇总报告,报告窗口可让您过滤在特定时间范围之后发生的转化。如需了解详情,请参阅可汇总部分。
什么是自定义报告窗口?
自定义报告窗口是指来源注册后的一段时间,在此期间内,系统可能会为此来源创建相应类型的报告(事件级报告或可汇总报告)。
对于事件级报告,报告期限也充当发送相应类型报告的最后一个期限。
报告期限方面的要点:
- 如果未设置
report_window,则会回退到expiry。 - 如果未设置
expiry,则会回退到默认值 30 天。 - 自定义报告的最小时间范围为 1 天。即使您设置的时间窗口不足一天,该值也会被强制修改为一天。查看事件级报告的示例。
- 报告窗口以秒为单位定义。
请注意,expiry 的运作方式保持不变;expiry 会更改哪些展示或点击符合归因条件。
事件级报告:更快的报告速度和选择性报告
默认情况下,系统会按照内置报告期的时间表发送事件级报告:点击有 3 个报告期,观看有 1 个报告期。
对于事件级报告,自定义报告期可让您:
- 更快地获取报告。除了其他功能之外,自定义报告期还允许您在点击或展示发生一天后获取报告,而不是像 Chrome 110 之前内置的过期期那样,必须在两天后才能获取报告。
- 过滤掉在特定时间范围之后发生的转化。
如需为事件级报告使用报告期,请将 event_report_window 字段添加到 Attribution-Reporting-Register-Source 来源注册标头。
事件级报告最晚会在达到报告窗口后不久发送。
事件级报告(点击)的安排示例
| expiry | event_report_window |
如果转化发生在点击后一天,浏览器会发送报告: | 对于发生的转化,过滤掉(未发送)的报告: |
|---|---|---|---|
| 默认(30 天) | (未设置) | 点击后约 2 天零 1 小时 默认报告行为 - 内置回溯期 1 |
点击后约 30 天 |
| 自定义,设置为 5 天 | (未设置) | 点击后约 2 天零 1 小时 默认报告行为 - 内置回溯期 1 |
点击后超过 5 天 |
| 默认(30 天) | 设置为 1 天 | 点击后约 1 天 1 小时 自定义行为,因为您设置了自定义报告窗口期。请注意,与第一行相比,此方法可更快地生成此报告,因为第一行需要等待第一个内置窗口期(2 天) |
点击后超过 1 天 |
| 自定义,设置为 5 天 | 设置为 1 天 | 点击后约 1 天 1 小时 因自定义报告窗口而产生的自定义行为 |
点击后超过 1 天 |
| 默认(30 天) | 设置为 4 小时 | 点击后约 1 天零 1 小时 因自定义报告窗口而产生的自定义行为。这是由于钳制所致:报告窗口的最小值是一天。即使您将报告期设置为不到一天(例如 4 小时),其值也会被限制为一天。 |
点击后超过 1 天 |
事件级报告和视图的调度示例
| expiry | event_report_window |
如果转化发生在点击后一天,浏览器会发送报告: |
|---|---|---|
| 默认(30 天) | (未设置) | 观看后约 30 天零 1 小时 默认报告行为 |
| 自定义,设置为 5 天 | (未设置) | 观看后约 5 天零 1 小时 默认报告行为 |
| 默认(30 天) | 设置为 1 天 | 观看后约 1 天零 1 小时 因自定义报告窗口而产生的自定义行为 |
| 自定义,设置为 5 天 | 设置为 1 天 | 观看后约 1 天零 1 小时 因自定义报告窗口而产生的自定义行为 |
可汇总的报告:选择性报告
对于可汇总报告,报告期的作用仅在于过滤掉在特定时间范围之后发生的转化。在更快获取报告方面没有任何好处。
如需为可汇总报告使用报告窗口,请将 aggregatable_report_window 字段添加到 Attribution-Reporting-Register-Source 来源注册标头。
这样一来,系统就会过滤掉在特定时间范围之后发生的转化。
可汇总报告会在触发后一小时内发送;它们会随机延迟 10 分钟到 1 小时。
| expiry | aggregatable_report_window |
对于发生的转化,过滤掉(未发送)的报告: |
|---|---|---|
| 默认(30 天) | (未设置) | 点击或观看后超过 30 天 |
| 自定义,设置为 5 天 | (未设置) | 点击或观看后超过 5 天 |
| 默认(30 天) | 设置为 1 天 | 点击或观看后超过 1 天 |
| 自定义,设置为 5 天 | 设置为 1 天 | 点击或观看后超过 1 天 |
| 默认(30 天) | 设置为 4 小时 | 在点击或观看后超过 1 天。这是由于钳制所致:报告窗口的最小值是一天。即使您将报告期设置为不到一天(例如 4 小时),其值也会被限制为一天。 |
互动并分享反馈
您可以参与并试用此 API。