网站归因报告概览

衡量广告点击或观看何时带来了转化（例如用户在网站上进行的购买） 广告客户的网站。

适用对象

在这里，您将了解 Attribution Reporting 的基本信息以及 而不是太多技术细节。

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

依赖广告技术平台进行转化的广告客户和发布商 衡量无需直接使用 API。你可能感兴趣的内容 了解 Attribution Reporting 的运作方式（如果您的广告技术计划集成该解决方案） 此 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。

。

注意：归因报告以前称为 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，您可以通过 两种类型的报告可发送给广告客户或第三方广告技术平台 提供商。这两种类型的报告可以同时使用 是相辅相成的

• 事件级报告会与特定广告相关联 点击或查看（位于广告方面），其中包含转化端数据。 转化端数据非常有限，且采用了噪声（这意味着对于 少数情况下发送随机数据，而不是真实报告）。 这样可以防止跨不同平台中的用户身份合并，从而保护用户隐私 。作为一种额外的隐私保护措施，报告会延迟发送。
• 摘要报告未与以下事件中的特定事件相关联： 。这些报告可提供更丰富、保真度更高的转化数据 相较于事件级报告多种隐私保护技术有助于减少 存在跨网站合并身份的风险。

事件级报告

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

<ph type="x-smartling-placeholder">

</ph>

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

事件级报告适用于：

• 优化。您可以回答“如何提高投资回报率 投资？”。具体来说，这些报告可用于优化 因为您可以在报表中提供广告端唯一 ID。 事件级报告可以为机器学习模型提供训练数据。
• 粗略报告：几乎不要求有关 。目前针对点击只能提供 3 位的转化数据 ⏤此 表示可以为转化指定八个类别之一⏤且为转化指定 1 位 观看次数。精细的转化端数据编码，例如 事件级报告不支持具体价格或转化时间。
• 欺诈检测。某些报告中的数据可能适用于广告欺诈 检测和分析，从而理解可能 来标识垃圾内容或无效活动。

摘要报告

摘要报告（以前称为汇总报告）可针对 转化数据，并且在联接点击或浏览数据和转化数据方面更加灵活 数据。

详细了解摘要报告。

<ph type="x-smartling-placeholder">

</ph>

下面是摘要报告中的数据分析示例：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：

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

浏览器配置

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

。

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

网站如何控制访问权限？

如果该 API 在给定浏览器中可用，那么在默认情况下，它在任何 同时存在于顶级文档和脚本中，以及在同源 iframe 中。

任意第三方 - 例如，非 添加到带有顶级访问权限的脚本的网页 - 无法使用 API 而这些 iframe 中的 需要明确启用 Attribution Reporting API， 权限 政策。

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

向网页添加跨源 iframe 的拥有顶级访问权限的第三方 还可以通过 权限政策。

注意：

安全优势

这样，具有顶级访问权限的脚本将允许其自行添加的框架 使用 Attribution Reporting。只有受 应该给该网站授予顶级访问权限，所以这并不是问题。 该政策的主要安全优势还在于其他地方： 添加没有顶级脚本的，则在默认情况下 来源或触发器（除非其嵌入器已受信任）。正因如此， 必须为这些 iframe 明确启用 API。

网站可以为所有相关方停用 Attribution Reporting API，包括 具有顶级访问权限的脚本，通过发送 HTTP 响应标头：

Permissions-Policy: attribution-reporting=()

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

借助 Attribution Reporting API，可以衡量关联的两个事件 同时发生：发布商网站上的事件，例如用户查看或点击 随后在广告客户网站上完成转化。

注意：Attribution Reporting API 可能不适合按每次转化费用结算 因为事件级和 摘要报告。 您可以通过以下方式就此变更对各种结算模式的影响提供反馈意见 Attribution Reporting API GitHub。

事件级报告

<ph type="x-smartling-placeholder">

</ph>

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

摘要报告

<ph type="x-smartling-placeholder">

</ph>

生成摘要报告

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

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

详细了解摘要报告。

隐私权

与第三方 Cookie 不同，Attribution Reporting API 广告公司可以深入了解 转化而不跟踪个人活动 跨网站。

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

目前，此转化将由第三方跟踪 用作跨网站标识符的 Cookie。 借助第三方 Cookie，广告技术公司可以访问许多 Bob 在 news.example 及以下期间的活动详情 shoes.example。广告技术平台可以将这些 汇总信息以详细记录小鲍的个人资料， 包括小鲍的位置、浏览习惯 news.example的首选阅读资源。此个人资料还可以 包含您的购买交易、活动和信用卡信息， shoes.example。此跨网站连接可用于测量 广告转化。但会妨碍用户隐私： 系统会以高度详细的方式跟踪小鲍的活动。

<ph type="x-smartling-placeholder">

</ph>

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

少量信息被联接在一起 这足以衡量转化情况， 足以详细跟踪小鲍在各个网站上的活动小鲍的 news.example 和 shoes.example 上的活动仍然存在 。

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

事件级报告会将广告端标识符与少量 转化方数据虽然它们确实提供了 转化方信息过于粗略，无法加入用户行列 身份和身份

摘要报告提供详细的数据分析，但仅限汇总级别；因为其中的 这些可汇总的报告都会在发送到广告技术平台时加密，因此广告技术平台无法获取 报告中的任何信息，而无需使用汇总服务。仅限汇总服务 提供对噪声汇总的访问。

系统会对这两者施加速率限制等额外隐私保护措施 事件级报告和汇总报告

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

事件级报告提供转化数据分析，而不跟踪整个 通过以下隐私保护机制访问该网站：

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

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

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

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

互动和分享反馈

• 有关 API 的问题： 创建问题 。
• 关注 Attribution Reporting 邮寄名单。
• 如果您有技术问题 提交 Chromium 错误。
• 对于实施、集成和常规最佳实践方面的问题： 创建问题 。