自定义报告窗口提供更快的事件级报告，以及针对可汇总报告的选择性报告。
借助 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 开发者支持代码库中提问并加入讨论。