网站归因报告概览

衡量广告点击或观看何时带来了转化，例如在广告客户的网站上购物。

适用对象

在这里，您将了解 Attribution Reporting 的基础知识和一些基本概念，但没提供太多技术细节。

• 如果您在广告或广告技术平台工作，将了解此 API 如何提供由第三方 Cookie 启用的功能。请查看 API 用例，其中详细介绍了如何生成报告。
• 如果您是开发者或软件工程师，请参阅完整的系统概览或实验并参与该 API。

依赖广告技术平台进行转化衡量的广告客户和发布商无需直接使用 API。如果您的广告技术计划集成此 API，不妨了解 Attribution Reporting 的工作原理。

注意：将来，Attribution Reporting API 可能会处理与广告无关的用例。

什么是 Attribution Reporting API？

目前，广告转化衡量通常依赖于第三方 Cookie。浏览器会限制对第三方 Cookie 的访问，因为这些 Cookie 可用于跨网站跟踪用户，并会妨碍用户隐私。

Attribution Reporting API 采用可保护隐私的方式实现这些衡量，无需第三方 Cookie。

借助此 API，广告主和广告技术提供商可以在下列情况下衡量转化情况：

• 广告点击次数和观看次数。
• 第三方 iframe 中的广告，例如在使用第三方广告技术提供商的发布商网站上投放的广告。
• 第一方环境中的广告，例如社交网络或搜索引擎结果页上的广告，或者发布商投放自己的广告。

如果您不熟悉其中一些术语或概念，请参阅 Privacy Sandbox 术语表。

试用 API

• 在浏览器中进行本地测试。设置标志，告知 Chrome 浏览器启用特定的实验性功能。

如果您有兴趣试用该 API，请参阅 Attribution Reporting：实验并参与。

注意：此 API 仍在开发中，将随着时间的推移而不断改进，具体取决于生态系统反馈和输入。您的答案有助于确保我们讨论各种用例的解决方案。 此 API 正处于开放式孵化和开发阶段。考虑参与讨论。

API 变更

• 跟踪 API 更改。
• 了解我们为何在 2023 年上半年推出 Attribution Reporting API。

注意：Attribution Reporting 以前称为 Event Conversion Measurement API。该名称在 2022 年进行了更改，因为原来的事件级范围已扩大到涵盖更多效果衡量用例。

可用性

Proposal	Status
Conversion journey: app-to-web Web explainer and Android explainer Mailing list announcement	Available in Chrome and Android for origin trial
Conversion journey: cross-device Explainer	This proposal has been archived. There are no current plans for implementation.
Preventing invalid aggregatable reports using report verification Explainer	Expected in Chrome in H1 2024
Default allowlist for the Attribution Reporting API Permissions-Policy will remain * Mailing list announcement	Available in Chrome in Q1 2023
Configurable Event-Level reporting epsilon GitHub issuek	Available in Chrome in Q4 2023
Padding for Aggregatable reports payload Updated explainer	Available in Chrome in Q4 2023
Phase 1 Lite Flexible Event-Level Flexible event-level configurations explainer	Available in Chrome in Q4 2023 The ability to customize the number of attribution reports and the number/length of reporting windows. Available in Chrome in Q1 2024 The ability to customize the number of bits of trigger data.
Support for Attribution Reporting debugging after third-party cookie deprecation Seeking feedback on GitHub	Expected in Chrome in H1 2024
Support for Attribution Reporting API and Aggregation Service for Google Cloud Attribution Reporting API Explainer Aggregation Service Explainer	Available in Chrome in H2 2023

注意：如需简要了解所有 Privacy Sandbox API 的状态，请参阅 Privacy Sandbox 时间表。

用例和功能

借助 Attribution Reporting API，您可以通过可发送给广告客户或第三方广告技术提供商的两类报告访问不同类型的数据分析。这两类报告可同时使用并互为补充。

• 事件级报告会将特定的广告点击或观看（位于广告端）与转化端数据相关联。转化端数据非常有限，并且数据带有噪声（也就是说，在一小部分情况下，发送的是随机数据，而不是真实报告）。这样可以防止跨网站合并用户身份，从而保护用户隐私。作为一种额外的隐私保护措施，报告会延迟发送。
• 摘要报告与广告端的特定事件无关。与事件级报告相比，这些报告可提供更丰富、保真度更高的转化数据。组合使用隐私保护技术有助于降低跨网站合并身份的风险。

事件级报告

事件级报告会将广告点击或观看与粗略的转化数据相关联。

事件级报告示例：news.example 上的点击 ID 200400600（附加到用户 ID Bob_Doe 的用户：news.example）促成了在 shop.example 进行的购买。

事件级报告适用于：

• 优化。您可以回答“如何提高投资回报率？”之类的问题。具体而言，这些报告可用于优化广告展示位置，因为报告中会提供广告端唯一 ID。事件级报告可以为机器学习模型提供训练数据。
• 粗略报告：几乎不需要有关转化的信息。目前的上限为点击次数的 3 位转化数据 ⏤这意味着可以为转化指定 8 个类别之一 ⏤ 可为观看分配 1 位数据。事件级报告不支持对精细的转化端数据（例如具体价格或转化时间）进行编码。
• 欺诈检测。某些报告中的数据有助于您了解可用于识别垃圾内容或无效活动的模式，因此对于广告欺诈检测和分析非常有用。

摘要报告

摘要报告（以前称为“汇总报告”）可提供更详细的转化数据，并且可以更灵活地将点击或浏览数据与转化数据进行组合。

详细了解摘要报告。

下面是摘要报告中的数据分析示例：news.example 上的广告系列 ID 1234567 在 shoes.example 带来了 518 次转化，总支出为 38174 美元。半数转化来自美国纽约的用户。

摘要报告最适合用于报告用例。这些报告可以帮助回答诸如“我的投资回报率是多少？”这样的问题。

使用摘要报告进行优化（例如，针对购买价值进行优化）是一个热门研究领域，而事件级报告不支持这种优化方式（因为转化数据过于粗略）。

其他功能

此 API 的其他功能包括：

• 应用到网站归因：查看或点击应用中的广告并在网站上完成转化。

注意：将来，如果没有第三方 Cookie，此 API 会与其他隐私保护广告 API 结合使用，以涵盖端到端用例： - 再营销：请参阅 Protected Audience API - 针对用户兴趣的广告选择：请参阅主题

浏览器支持

• Firefox 和 Edge 没有共享信号。
• Safari 和 Webkit 是不建议使用的，并提出了一种不同的 API 来衡量广告转化，称为隐私点击衡量。

虽然这两种 API 不同，但 Chrome 和 WebKit 是在公开环境中协同工作以简化开发者体验，例如在属性名称和报告的 JSON 结构方面保持一致。

Attribution Reporting API 的功能集不同于 Safari 和 WebKit 建议的 Private Click Measurement API 的功能集。最值得注意的是，使用 Attribution Reporting API：

• 支持浏览型转化衡量。
• 可以提供事件级报告。
• 摘要报告包含有关点击/查看方面和转化方面的丰富信息。
• 广告技术平台等第三方可以代表发布商和广告主接收报告。

浏览器配置

• 用户可以通过 chrome://settings/adPrivacy 中的用户设置选择停用该 API。
• 该 API 在无痕模式下处于停用状态。
• 停用第三方 Cookie 后，该 API 将处于无效状态。

注意：该 API 不依赖第三方 Cookie。 但是，在测试阶段，需要启用第三方 Cookie 才能启用 API。这样，开发者就可以获取调试报告，并将 API 结果与基于 Cookie 的归因进行比较。

网站如何控制访问权限？

如果该 API 在给定浏览器中可用，那么在默认情况下，它在任何给定网站中均可用，无论是在顶级文档和脚本中，还是在同源 iframe 中。

在发布商或广告客户不知情的情况下，任意第三方（例如，未通过拥有顶级访问权限的脚本添加到网页的跨源广告 iframe）无法使用该 API：在这些 iframe 中，需要通过权限政策明确启用 Attribution Reporting API。

<iframe src="..." allow="attribution-reporting"></iframe>

具有顶级访问权限且向网页添加跨源 iframe 的第三方也可以通过权限政策启用 Attribution Reporting API。

注意：

安全优势

这样，具有顶级访问权限的脚本便会允许它自己添加的帧使用 Attribution Reporting。您应只向网站信任的第三方脚本授予顶级访问权限，因此这不成问题。 该政策的主要安全优势在于其他方面：默认情况下，在没有顶级脚本的情况下添加的帧不应被信任来注册来源或触发器（除非其嵌入器已受信任）。因此，顶级网站必须为这些 iframe 明确启用该 API。

网站可以通过发送 HTTP 响应标头来对各方（包括具有顶级访问权限的脚本）停用 Attribution Reporting API：

Permissions-Policy: attribution-reporting=()

Attribution Reporting API 的工作原理是什么？

借助 Attribution Reporting API，可以衡量两个相互关联的事件：一个是发布商网站上的事件，例如用户查看或点击广告；另一个是广告客户网站上的后续转化。

注意：Attribution Reporting API 可能不适合满足每次转化费用结算需求，因为事件级报告和摘要报告中添加了噪声。 您可以在 GitHub 上分享有关 Attribution Reporting API 对各种结算模型的影响的任何反馈。

事件级报告

事件级报告的生成方式如下：
浏览器将点击或观看与广告技术平台定义的转化数据进行匹配。
稍后，浏览器将生成的报告发送到预定义的端点，同时存在一些延迟和噪声。

摘要报告

生成摘要报告

摘要报告的生成方式如下：

• 用户点击或查看经过特别配置的广告。用户本地设备上的浏览器会记录此事件，以及预先指定的归因配置数据。
• 之后，当用户完成转化时，浏览器会将此详细点击或观看事件（称为“归因来源事件”）与详细转化数据（称为“归因触发器数据”）进行匹配。所捕获的详细维度由广告技术公司预定义，浏览器会遵循广告技术平台定义的特定逻辑。浏览器会将这些数据输出到可汇总报告中。
• 可汇总的报告由浏览器加密并发送到广告技术平台服务器。可汇总报告从广告技术平台服务器发送到汇总服务，以生成摘要报告。
• 然后，摘要报告将可供广告技术平台使用。请注意，摘要报告的延迟程度不会和事件级报告的延迟程度相同。

详细了解摘要报告。

隐私权

与第三方 Cookie 不同，Attribution Reporting API 让广告公司无需跟踪个人在各个网站上的活动即可深入了解转化情况。

让我们以 Bob 为例。小鲍在阅读news.example上的新闻时看到了一则广告。一周后，Bob 在 shoes.example 买鞋。

目前，此类转化由用作跨网站标识符的第三方 Cookie 进行跟踪。借助第三方 Cookie，广告技术公司可以获取小鲍在 news.example 和 shoes.example 上的活动的大量详细信息。广告技术平台可以将这些信息合并在一起，以构建小鲍的详细个人资料，包括小鲍的位置、浏览习惯和 news.example 上的首选阅读行为。此玩家资料还可能包含 shoes.example 上的购买交易、活动和信用卡信息。这种跨网站联接有助于衡量广告转化情况。但这会妨碍用户隐私： Bob 的活动会在多个网站上被高度详细地跟踪。

当前 Web（联接身份）和未来 Web（分区身份）的并排视图

跨网站合并少量信息，足以衡量转化情况，但不足以详细跟踪小鲍在各个网站上的活动。Bob 在 news.example 和 shoes.example 上的 activity 保持独立。

每种报告类型中的保护措施

事件级报告将广告端标识符与少量转化端数据相关联。虽然它们确实提供了有关转化的跨网站信息，但转化端信息过于粗略，无法跨网站确定用户身份。

摘要报告提供详细的数据分析，但只能在汇总级别提供；由于这些可汇总报告的内容在发送到广告技术平台时已经过加密，因此如果不使用汇总服务，广告技术平台将无法从报告中获取任何信息。汇总服务仅提供对噪声汇总的访问。

事件级报告和汇总报告都会实施速率限制等额外的隐私保护措施。

详细说明：事件级报告和隐私权

事件级报告通过遵循以下隐私保护机制，在不跨网站跟踪用户的情况下提供转化数据分析洞见：

• 系统不会使用跨网站标识符，也不会使用详细的跨网站浏览活动离开设备。
• 事件级报告将广告端的 64 位信息 (news.example) 与转化端的 1 位或 3 位信息 (shop.example) 相关联。64 位信息足以映射到单个用户标识符，但这 64 位只能与非常少的跨网站信息相关联：1 位或 3 位，它们不足以保存标识符。
  • 广告端 64 位不是新信息。目前已在广告端提供用户 IDnews.example 或 adtech.example 已知道特定用户在 news.example 上的活动。
• 我们还采取了额外的保护措施来防范滥用行为和跨网站跟踪：
  • 这些报告的发送存在延迟。
  • 转化数据会添加噪声：在一定百分比的时间内生成虚假报告。
  • 对于每次点击或观看，归因转化报告的数量是有限的。

详细说明：摘要报告和隐私权

摘要报告会将点击或查看事件与详细的转化数据相关联。 它们通过以下隐私保护机制，在不跨网站跟踪用户的情况下提供转化分析数据：

• 不使用跨网站标识符。
• 每个归因都可以对生成的摘要报告做出多项贡献。任何给定用户都可以针对特定点击（或观看）和转化触发多个归因。
• 数据汇总最高到许多事件（许多用户）的级别，无法精确观察到单个事件。查看汇总数据时，随着详细程度的提高，该数据的相对噪声也会增加。汇总大量事件和用户的数据切片会更准确保持实用性。
• 将详细点击或查看事件与详细转化数据相关联的原始报告会经过加密处理，广告技术公司无法读取。此数据只能由汇总服务读取。
• 我们还采取了额外的保护措施来防范滥用行为和跨网站跟踪：
  • 报告的发送是随机延迟的。
  • 对不同数据切片的查询有速率限制。

互动和分享反馈

• 如有关于 API 的问题，请在 API 代码库中创建问题。
• 关注 Attribution Reporting 邮寄名单中的 API 更新和公告。
• 如果您有技术问题，请提交 Chromium bug。
• 有关实现、集成和一般最佳实践方面的问题：请在 Privacy Sandbox 开发者支持代码库中创建问题。