对于 Chrome 版本,Attribution Reporting 提案将发生变化 104,其中包含新的 API 机制、功能和更新 汇总服务的数据。
这些更新适用于哪些对象?
如果您符合以下条件,这些更新就会为您送上:
- 您已熟悉该 API。例如,如果您一直在观察 或参与 WICG 存储库的讨论,并希望 了解对 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 实验指南
详细了解相关更新
标题图片来自 Diana Polekhina 的 Unsplash 网站。