网站归因报告概览

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

此工具适用于哪些对象？

您可以在此处了解归因报告的基础知识和一些基本概念，但不会涉及太多技术细节。

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

依赖广告技术平台来衡量转化的广告客户和发布商无需直接使用此 API。如果您的广告技术平台计划与此 API 集成，您可能有兴趣了解归因报告的运作方式。

注意：未来，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 API 以前称为 Event Conversion Measurement API。由于原始事件级范围扩大到涵盖其他衡量用例，因此该名称在 2022 年发生了更改。

可用性

提案	状态
转化历程：应用到网站 网站说明和 Android 说明 邮寄名单通告	适用于 Chrome 和 Android 的源试用
转化历程：跨设备 说明	此提案已归档。目前没有实施计划。
使用报告验证功能防止可汇总报告无效 说明	此提案已归档。我们改为为此用例实现了 trigger_context_id。
Attribution Reporting API Permissions-Policy 的默认许可名单将保持不变 * 邮寄名单通告	2023 年第 1 季度在 Chrome 中推出
可配置的事件级报告 epsilon GitHub 问题	2023 年第 4 季度在 Chrome 中推出
可汇总报告载荷的填充 更新了说明	2023 年第 4 季度在 Chrome 中推出
灵活事件级 “灵活事件级配置”说明	将于 2023 年第 4 季度在 Chrome 中推出 可自定义归因报告的数量以及报告期的数量/时长。 将于 2024 年第 1 季度在 Chrome 中推出 能够自定义触发器数据的位数。
支持不依赖于第三方 Cookie 的 Attribution Reporting 详细调试报告 说明	2024 年第 3 季度在 Chrome 中推出
支持 Google Cloud 的 Attribution Reporting API 和汇总服务 Attribution Reporting API 说明 汇总服务说明	2023 年下半年在 Chrome 中推出
灵活的贡献过滤 说明	2024 年第 3 季度在 Chrome 中推出
归因前过滤：归因范围 说明	2024 年第 4 季度在 Chrome 中推出

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

用例和功能

Attribution Reporting API 提供两种可发送给广告客户或第三方广告技术平台的报告，可让您获取不同类型的数据分析。这两种报告可以同时使用，并且互为补充。

• 事件级报告可将特定的广告点击或观看（在广告端）与转化端的数据相关联。转化端数据非常有限，并且数据带有噪声（这意味着，在少数情况下，系统会发送随机数据，而不是真实报告）。这可防止跨网站联接用户身份，从而保护用户隐私。为了进一步保护隐私，系统会延迟发送报告。
• 摘要报告与广告端的特定事件无关。与事件级报告相比，这些报告可提供更丰富、保真度更高的转化数据。结合使用多种隐私保护技术有助于降低跨网站关联身份的风险。

事件级报告

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

事件级报告示例：news.example 上的点击 ID 200400600（与 news.example 上的用户 ID Bob_Doe 相关联）促成了 shop.example 上的购买交易。

事件级报告适用于以下情况：

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

摘要报告

摘要报告（以前称为汇总报告）提供更详细的转化数据，并且在联接点击或浏览数据与转化数据时更灵活。

详细了解摘要报告。

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

摘要报告最适合用于报告使用情形。这些报告有助于回答诸如“我的投资回报率是多少？”这样的问题。

我们正在积极研究如何使用摘要报告进行优化，例如，优化事件级报告不支持的购买价值（因为转化数据过于粗糙）。

其他功能

此 API 的其他功能包括：

• 应用到网站归因：用户在应用中看到或点击广告，然后在网站上完成转化。

注意：在未来弃用第三方 Cookie 后，此 API 将与其他可保护隐私的广告 API 结合使用，以涵盖端到端用例： - 再营销：请参阅 Protected Audience API - 基于兴趣的广告选择：请参阅 Topics

浏览器支持

• Firefox 和 Edge 尚未共享信号。
• Safari 和 Webkit 的意见为否定，并提出了一种名为Private Click Measurement 的其他 API 来衡量广告转化。

虽然这两个 API 不同，但 Chrome 和 WebKit 正在公开合作，以简化开发者体验，例如通过统一属性名称和报告的 JSON 结构。

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

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

浏览器配置

• 用户可以在 chrome://settings/adPrivacy 中使用用户设置停用该 API。
• 该 API 在无痕模式下处于非活动状态。

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

网站如何控制访问权限？

如果给定浏览器支持该 API，则该 API 默认在任何给定网站（顶级文档和脚本以及同源 iframe）中都受支持。

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

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

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

注意：

安全优势

这样一来，具有顶级访问权限的脚本便可允许其自行添加的帧使用归因报告。只有网站信任的第三方脚本才应获得顶级访问权限，因此这不是一个问题。 该政策的主要安全优势在于：默认情况下，不带顶级脚本添加的帧不应被信任，无法注册来源或触发器（除非其嵌入者已被信任）。因此，顶级网站必须为这些 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，广告技术公司可以访问 Bob 在 news.example 和 shoes.example 上的大量详细活动信息。广告技术平台可以将这些信息合并起来，构建 Bob 的详细个人资料，包括 Bob 的位置信息、浏览习惯和 news.example 上的首选阅读内容。此玩家资料还可能包含 shoes.example 上的购买交易、活动记录和信用卡信息。这种跨网站关联对于衡量广告转化非常有用。但这会侵犯用户隐私：系统会跨网站跟踪 Bob 的活动，并且跟踪信息非常详细。

现今网络（合并身份）和未来网络（分区身份）的并排视图

系统会跨网站联接少量信息，这些信息足以衡量转化，但不足以详细跟踪 Bob 在各个网站上的活动。Bob 在 news.example 和 shoes.example 上的 activity 仍然是分开的。

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

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

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

系统会对事件级报告和汇总报告施加额外的隐私保护措施，例如速率限制。

详细了解：事件级报告和隐私权

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

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

详细信息：摘要报告和隐私权

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

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

互动和分享反馈

• 如有关于此 API 的问题，请在 API 代码库中创建问题。
• 请加入 Attribution Reporting 邮寄名单，及时了解 API 更新和相关公告。
• 如果您有技术问题，请提交 Chromium bug。
• 对于实现、集成和常规最佳实践问题：请在 Privacy Sandbox 开发者支持代码库中创建问题。