网站归因报告概览

衡量广告点击或浏览促成转化的时间，例如广告客户网站上的购买交易。

此功能适用于哪些用户？

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

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

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

什么是 Attribution Reporting API？

如今，广告转化衡量通常依赖于第三方 Cookie。浏览器正在限制对第三方 Cookie 的访问，因为这些 Cookie 可用于跨网站跟踪用户，从而损害用户隐私。

Attribution Reporting API 可在不使用第三方 Cookie 的情况下以注重隐私保护的方式实现这些衡量。

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

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

如果您不熟悉上述某些术语或概念，请参阅 Privacy Sandbox 词汇表。

试用 API

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

如果您有兴趣试用该 API，请前往归因报告：实验和参与。

API 变更

• 及时了解 API 变更。
• 了解我们为何在 2023 年上半年发布 Attribution Reporting API。

可用性

用例和功能

Attribution Reporting API 可通过两种类型的报告提供不同类型的分析洞见，这些报告可以发送给广告客户或第三方广告技术提供商。这两种类型的报告可以同时使用，并且互为补充。

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

事件级报告

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

事件级报告适合用于以下用途：

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

摘要报告

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

详细了解摘要报告。

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

使用汇总报告进行优化（例如，优化购买价值，而事件级报告不支持此功能，因为转化数据过于粗略）是一个正在积极研究的领域。

其他功能

此 API 的其他功能包括：

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

浏览器支持

• Firefox 和 Edge 未共享信号。
• Safari 和 Webkit 持否定态度，并提出了另一种用于衡量广告转化效果的 API，称为 Private Click Measurement。

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

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

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

浏览器配置

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

网站如何控制访问权限？

如果某个浏览器支持该 API，则默认情况下，任何给定网站（包括顶级文档和脚本，以及同源 iframe）都支持该 API。

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

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

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

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

Permissions-Policy: attribution-reporting=()

Attribution Reporting API 的运作方式

您可以通过 Attribution Reporting API 衡量两个关联在一起的事件：发布商网站上的事件（如用户浏览或点击广告），以及广告客户网站上的后续转化。

事件级报告

摘要报告

系统按如下方式生成摘要报告：

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

详细了解摘要报告。

隐私权

与第三方 Cookie 不同，借助 Attribution Reporting API，广告公司可以深入了解转化情况，而无需跨网站跟踪个人用户的活动。

假设有个人名叫 Bob。小鲍在 news.example 上阅读新闻时看到了一则广告。一周后，小鲍在 shoes.example 上购买了鞋子。

如今，这种转化会通过用作跨网站标识符的第三方 Cookie 来跟踪。 借助第三方 Cookie，广告技术公司可以访问 Bob 在 news.example 和 shoes.example 上的活动记录的许多详细信息。广告技术可以将这些信息片段合并在一起，构建 Bob 的详细个人资料，包括 Bob 的位置、浏览习惯和在 news.example 上的偏好读物。此个人资料还可能包含 shoes.example 上的购买交易、活动记录和信用卡信息。这种跨网站联接有助于衡量广告转化。但它会损害用户隐私：系统会以非常详细的方式跟踪 Bob 在各个网站上的活动。

系统会在网站之间联接少量信息，这些信息足以衡量转化，但不足以详细跟踪 Bob 在各个网站上的活动。Bob 在 news.example 和 shoes.example 上的活动仍保持独立。

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

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

摘要报告可提供详细的分析洞见，但仅限于汇总层面；由于这些可汇总报告的内容在发送给广告技术平台时会进行加密，因此广告技术平台必须使用汇总服务才能从报告中获取任何信息。汇总服务仅提供对含噪汇总的访问权限。

事件级报告和汇总报告均会受到额外的隐私保护措施（例如速率限制）的约束。

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

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

• 不使用任何跨网站标识符，也不会有任何详细的跨网站浏览活动离开设备。
• 事件级报告会将广告端的 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。