自定义报告窗口提供更快的事件级报告,以及针对可汇总报告的选择性报告。
借助 Attribution Reporting 的自定义报告窗口(随 Chrome 110 一起提供),您可以指示浏览器滤除特定时间范围后发生的转化。
- 对于事件级报告,除了滤除在特定时间范围之后发生的转化之外,您还可以利用报告期更快地获取报告。根据您的目标,换一种方式看待此问题:使用报告期可加快访问报告的速度,但也意味着您可能会错失一些转化。如需了解详情,请参阅事件级部分。
- 对于可汇总报告,您可以通过报告期过滤特定时间范围后发生的转化。如需了解详情,请参阅可汇总部分。
什么是自定义报告窗口?
自定义报告时间范围是指在来源注册后,系统可能会为此来源创建相应类型(事件或可汇总)的报告。
对于事件级报告,报告期也是发送相应类型的报告的最后一个窗口。
有关报告期的要点:
- 如果未设置
report_window
,则回退到expiry
。 - 如果未设置
expiry
,则回退到默认的 30 天。 - 最短自定义报告时间为一天。即使您设置的时间范围少于一天,系统也会将该值限定为一天。查看事件级报告示例。
- 报告期定义以秒为单位。
请注意,expiry
的工作原理保持不变;而 expiry
会更改符合归因条件的展示或点击。
事件级报告:更快生成报告和选择性报告
默认情况下,事件级报告会按照内置报告期的时间安排发送:3 个窗口用于点击,1 个窗口用于查看。
对于事件级报告,您可以通过自定义报告窗口执行以下操作:
- 更快获取报告。除此之外,在 Chrome 110 之前,内置过期时间限制的有效期是两天,另外,自定义报告时间范围可让您在点击或展示后一天内获得报告。
- 并滤除特定时间范围后发生的转化。
若要将报告窗口用于事件级报告,请将 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 开发者支持代码库中提问并加入讨论。