2022 年 6 月归因报告更新

对于 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 PolekhinaUnsplash 网站。