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 Polekhina 的 Unsplash 网站。