自定义报告窗口

自定义报告期可以更快地生成事件级报告,并为可汇总报告提供选择性报告。

借助归因报告的自定义报告窗口(在 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