针对 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。