2022 年 6 月归因报告更新

针对 Chrome 版本 104 的 Attribution Reporting 提案将发生变化,其中包括新的 API 机制、功能和汇总服务更新。

这些更新的受众是谁?

如果您符合以下情况,那么这些更新适用于您:

  • 您已经熟悉此 API,例如,如果您一直在观察或参与有关 WICG 代码库的讨论,并希望了解对该 API 所做的更改。
  • 您正在演示或计划中使用 Attribution Reporting API,以在源试用中进行测试。

如果您刚开始使用此 API 和/或尚未试用过,请直接参阅 API 简介

Attribution Reporting API 更新

更新了 Attribution Reporting 演示,以反映 Attribution Reporting 客户端 API 的最新更改。

大多数更改不需要采取任何措施。下面突出显示了需要更新实现的代码。

(建议采取行动)采用统一的标头进行注册

标题已统一。现在,来源和触发器只有一个标头,采用 JSON 格式。

  • 如需注册归因来源,您可以使用标头 Attribution-Reporting-Register-Source 响应注册请求。
  • 如需完成触发器注册,请设置 Attribution-Reporting-Register-Trigger 标头。

此更改需要采取行动。如需了解详情,请参阅 API 开发者指南

(需要采取行动)汇总键现已转换为字典

如需注册归因来源,请继续使用 aggregation_keys,但现在以 JSON 字典(而不是列表)的形式存储。

例如:

"aggregation_keys": {
    // Generate a "0x159" key piece for the key named "campaignCounts".
    "campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)

    // Generates a "0x5" key piece (low order bits of the key) for 
    // the key named "geoValue".
    "geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
 }

此更改需要采取行动。如需了解详情,请参阅 API 手册

生成报告

您可以选择仅生成可汇总报告,这类报告可以汇总到摘要报告中。如果您的过滤条件与任何事件触发器都不匹配,则系统将不会生成事件级报告。

统一的调试密钥设置

调试密钥现在应在源代码标头和触发器标头中设置,而不是使用单独的标头进行设置。详细了解如何调试报告

注册归因来源

与支持 <img> 标记类似,脚本标记现在可用于注册归因来源。

更多 API 更新

API 手册中提到的其他更改包括:

  • 您可以通过 JavaScript 请求 API 注册来源。
  • window.registerSource”已移除。
  • 现在,在注册来源时可以选择包含 attributionsrc 的值。
  • 向传入的来源注册请求添加了 Attribution-Reporting-Eligible 标头。
  • encodeURIComponent 有小幅变化。
  • 从可汇总报告的 shared_info 字段中移除了隐私预算密钥

对汇总服务的支持

在 Chrome 104 中,我们打算更新可汇总报告内某些信息的格式。我们目前正在汇总服务,为此项变更提供支持。这些更改发布后,本文档以及更新日志将会更新。

我们收集了一份生成摘要报告的实用提示和策略文档。其中包括许多数据分析,包括:

  • 概览报告生成过程中的噪声
  • 对维度、键和值的详细说明
  • 聚合键的实际应用,包括键结构映射
  • 实际中可汇总的价值,以及贡献预算的影响
  • epsilon 实验指南

详细了解相关更新

标题图片来自 Unsplash 网站 Diana Polekhina