网站归因报告概览

衡量广告点击或观看何时促成转化，例如在广告客户网站上完成购买。

适用对象

在这里，您可以找到归因报告的基础知识和一些基本概念，但不包含太多技术细节。

• 如果您使用广告或广告技术，则会了解此 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 年更改，因为原始事件级范围已扩展，涵盖其他衡量用例。

可用性

建议	状态
转化历程：从应用到网站 网站铺垫消息和 Android 铺垫消息 邮寄名单公告	在 Chrome 和 Android 中可用，以进行源试用
转化历程：跨设备 说明	该提案已归档。目前没有实施计划。
使用报告验证功能防止无效的可汇总报告 说明	预计于 2024 年上半年在 Chrome 中推出
Attribution Reporting API 权限政策的默认许可名单将保留 * 邮寄名单通知	将于 2023 年第 1 季度在 Chrome 中推出
可配置的事件级报告 epsilon GitHub 问题	将于 2023 年第 4 季度在 Chrome 中提供
可汇总报告载荷的内边距 更新了解释器	将于 2023 年第 4 季度在 Chrome 中提供
第 1 阶段精简版灵活事件级 灵活事件级配置说明说明	Chrome 将于 2023 年第 4 季度推出 可自定义归因报告的数量和报告期的数量/长度。 2024 年第 1 季度在 Chrome 中推出 可自定义触发器数据的位数。
支持在第三方 Cookie 弃用后进行 Attribution Reporting 调试 在 GitHub 上提供反馈	预计于 2024 年上半年在 Chrome 中推出
针对 Google Cloud Attribution Reporting API 和汇总服务的支持 Attribution Reporting API 说明 汇总服务说明	Chrome 将于 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上的 CampaignID 1234567 在shoes.example上促成了 518 次转化，总支出为 $3.8174。半数转化来自美国纽约市的用户。

摘要报告最适合报告应用场景。这些报告有助于回答诸如“我的投资回报率是多少？”之类的问题。

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

其他功能

此 API 的其他功能包括：

• 应用到网站归因：查看或点击应用中的广告，然后在网站上完成转化。
• 跨设备归因：在移动设备上查看或点击广告，并在桌面设备上完成转化。

注意：未来在不使用第三方 Cookie 的情况下，此 API 将与其他可保护隐私的广告 API 结合使用，以涵盖端到端用例： - 再营销：请参阅 Protected Audience API -“根据用户兴趣选择广告”：请参阅 Topics

浏览器支持

• Firefox 和 Edge 未共享信号。
• Safari 和 Webkit 是否定的，他们提议了一个名为不公开点击衡量的 API 来衡量广告转化情况。

虽然这两个 API 不同，但 Chrome 和 WebKit 以开源方式协同工作，以简化开发者体验，例如使属性名称和报告的 JSON 结构保持一致。

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

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

浏览器配置

• 用户可以通过 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 为例。Bob 在阅读 news.example 上的新闻时看到了一则广告。一周后，小鲍在shoes.example上买了鞋。

目前，此转化将通过用作跨网站标识符的第三方 Cookie 进行跟踪。借助第三方 Cookie，广告技术公司可以访问小鲍在 news.example 和 shoes.example 上的活动的大量详细信息。广告技术平台可以将这些信息合并到一起，以构建 Bob 的详细个人资料，包括 Bob 的位置、浏览习惯以及在 news.example 上的首选阅读方式。此个人资料还可能包含 shoes.example 上的购买交易、活动和信用卡信息。这种跨网站联接对于衡量广告转化情况非常有用。但这样做会损害用户隐私： 鲍勃的活动会以非常详细的信息跨网站进行跟踪。

并排视图：当前网站（联合身份）和未来网站（分区身份）

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

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

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

摘要报告提供详细的数据分析，但仅在汇总级别提供；由于这些可汇总报告的内容在发送到广告技术平台时会被加密，因此广告技术平台在不使用汇总服务的情况下无法从报告中获取任何信息。汇总服务仅提供噪声汇总。

事件级报告和汇总报告都会应用额外的隐私保护措施（例如速率限制）。

详情：事件级报告和隐私权

事件级报告按照以下隐私保护机制，提供转化数据洞见，而无需跨网站跟踪用户：

• 不使用跨网站标识符，也没有详细的跨网站浏览活动离开设备。
• 事件级报告将广告端 (news.example) 的 64 位信息与转化端 (shop.example) 仅关联 1 位或 3 位。64 位信息足以映射到单个用户标识符，但这 64 位只能与非常少的跨网站信息相关联：1 位或 3 位，已不足以存储标识符。
  • 广告端 64 位不是新信息。用户 ID 目前已经可以在广告端使用。news.example 或 adtech.example 已经知道特定用户在 news.example 上的活动。
• 应用额外的保护措施来防止滥用行为和跨网站跟踪：
  • 报告的发送会延迟。
  • 转化数据带有噪声：在一定百分比的时间里，系统会生成虚假报告。
  • 归因转化报告的数量受点击或浏览限制。

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

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

• 未使用跨网站标识符。
• 每个归因都可以对生成的摘要报告做出多项贡献。任何指定用户都可以针对特定点击（或观看）和转化触发多种归因。
• 系统会汇总许多事件（许多用户）的级别数据，并且无法精确观察到单个事件。在查看汇总数据时，随着详细程度的增加，该数据的相对噪声也会增加。汇总大量事件和用户的数据切片会更准确地保持实用性。
• 将详细点击或观看事件与详细转化数据相关联的原始报告已加密，广告技术公司无法读取。只有汇总服务可以读取这些数据。
• 应用额外的保护措施来防止滥用行为和跨网站跟踪：
  • 报告的发送会随机延迟。
  • 对不同数据切片的查询会受到限制。

互动和分享反馈

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