自定义报告期可以更快地生成事件级报告,并为可汇总报告提供选择性报告。
借助归因报告的自定义报告期(在 Chrome 110 中推出),您可以指示浏览器滤除在特定时间范围之后发生的转化。
- 对于事件级报告,报告期不仅可以让您更快地获取报告,还可以滤除在特定时间范围之后发生的转化。从另一个角度来看,这是一种权衡:使用报告时间范围可以更快地获取报告,但这意味着您可能会丢失一些转化。如需了解详情,请参阅事件级部分。
- 对于可汇总报告,您可以使用报告时间范围来过滤在特定时间范围之后发生的转化。如需了解详情,请参阅“可汇总”部分。
什么是自定义报告时间范围?
自定义报告期是指来源注册后的一段时间,在此时间段内系统可能会为此来源创建相应类型(事件或可汇总)的报告。
对于事件级报告,报告期限还充当发送相应类型报告的最后期限。
报告时间范围的要点:
- 如果未设置
report_window
,则会回退到expiry
。 - 如果未设置
expiry
,则会回退到默认的 30 天。 - 自定义报告的时间范围下限为 1 天。即使您设置的时间范围短于一天,该值也会被限制为一天。查看事件级报告示例。
- 报告时间范围以秒为单位。
请注意,expiry
的运作方式保持不变;expiry
会更改哪些展示或点击符合归因条件。
事件级报告:更快的报告和选择性报告
默认情况下,系统会按照内置报告期时间表发送事件级报告:对于点击,系统会发送三个报告期;对于观看,系统会发送一个报告期。
对于事件级报告,借助自定义报告期,您可以:
- 更快获取报告。除此之外,借助自定义报告期,您可以在点击或展示后的第 1 天获取报告,而无需遵守 Chrome 110 之前内置到期期的 2 天限制。
- 滤除在特定时间范围之后发生的转化。
如需为事件级报告使用报告期,请将 event_report_window
字段添加到 Attribution-Reporting-Register-Source
来源注册标头。
事件级报告会安排在报告期结束后不久发送。
事件级报告、点击的安排示例
到期 | 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 天 |
事件级报告和视图的安排示例
到期 | 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 小时。
到期 | aggregatable_report_window |
系统会滤除(不发送)以下时间段内发生的转化报告: |
---|---|---|
默认(30 天) | (未设置) | 点击或观看后超过 30 天 |
自定义,设置为 5 天 | (未设置) | 点击或观看后超过 5 天 |
默认(30 天) | 设为 1 天 | 点击或浏览后超过 1 天 |
自定义,设置为 5 天 | 设为 1 天 | 点击或浏览后超过 1 天 |
默认(30 天) | 设置为 4 小时 | 点击或观看后超过 1 天。这是由于限值所致:最短报告期为一天。即使您将报告期设置为不足一天(例如 4 小时),其值也会被限制为一天。 |
互动和分享反馈
您可以参与试用并试用此 API。
- 了解可汇总报告和汇总服务,提出问题并提出反馈。
- 阅读归因报告指南。
- 在 Privacy Sandbox 开发者支持代码库中提问并加入讨论。