衡量广告点击或观看何时带来了转化,例如在广告客户的网站上购物。
适用对象
在这里,您将了解 Attribution Reporting 的基础知识和一些基本概念,但没提供太多技术细节。
- 如果您在广告或广告技术平台工作,将了解此 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,请参阅 Attribution Reporting:实验并参与。
API 变更
- 跟踪 API 更改。
- 了解我们为何在 2023 年上半年推出 Attribution Reporting API。
可用性
建议 | 状态 |
---|---|
转化历程:从应用到网站 网站铺垫消息和 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 年下半年推出 |
用例和功能
借助 Attribution Reporting API,您可以通过可发送给广告客户或第三方广告技术提供商的两类报告访问不同类型的数据分析。这两类报告可同时使用并互为补充。
- 事件级报告会将特定的广告点击或观看(位于广告端)与转化端数据相关联。转化端数据非常有限,并且数据带有噪声(也就是说,在一小部分情况下,发送的是随机数据,而不是真实报告)。这样可以防止跨网站合并用户身份,从而保护用户隐私。作为一种额外的隐私保护措施,报告会延迟发送。
- 摘要报告与广告端的特定事件无关。与事件级报告相比,这些报告可提供更丰富、保真度更高的转化数据。组合使用隐私保护技术有助于降低跨网站合并身份的风险。
事件级报告
事件级报告会将广告点击或观看与粗略的转化数据相关联。
![事件级报告](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=6&hl=cs)
news.example
上的点击 ID 200400600(附加到用户 ID Bob_Doe 的用户:news.example
)促成了在 shop.example
进行的购买。事件级报告适用于:
- 优化。您可以回答“如何提高投资回报率?”之类的问题。具体而言,这些报告可用于优化广告展示位置,因为报告中会提供广告端唯一 ID。事件级报告可以为机器学习模型提供训练数据。
- 粗略报告:几乎不需要有关转化的信息。目前的上限为点击次数的 3 位转化数据 ⏤这意味着可以为转化指定 8 个类别之一 ⏤ 可为观看分配 1 位数据。事件级报告不支持对精细的转化端数据(例如具体价格或转化时间)进行编码。
- 欺诈检测。某些报告中的数据有助于您了解可用于识别垃圾内容或无效活动的模式,因此对于广告欺诈检测和分析非常有用。
摘要报告
摘要报告(以前称为“汇总报告”)可提供更详细的转化数据,并且可以更灵活地将点击或浏览数据与转化数据进行组合。
详细了解摘要报告。
![摘要报告中的数据分析示例。](https://developers.google.cn/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=6&hl=cs)
news.example
上的广告系列 ID 1234567 在 shoes.example
带来了 518 次转化,总支出为 38174 美元。半数转化来自美国纽约的用户。摘要报告最适合用于报告用例。这些报告可以帮助回答诸如“我的投资回报率是多少?”这样的问题。
使用摘要报告进行优化(例如,针对购买价值进行优化)是一个热门研究领域,而事件级报告不支持这种优化方式(因为转化数据过于粗略)。
其他功能
此 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 在给定浏览器中可用,那么在默认情况下,它在任何给定网站中均可用,无论是在顶级文档和脚本中,还是在同源 iframe 中。
在发布商或广告客户不知情的情况下,任意第三方(例如,未通过拥有顶级访问权限的脚本添加到网页的跨源广告 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,可以衡量两个相互关联的事件:一个是发布商网站上的事件,例如用户查看或点击广告;另一个是广告客户网站上的后续转化。
事件级报告
![事件级报告](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=6&hl=cs)
浏览器将点击或观看与广告技术平台定义的转化数据进行匹配。
稍后,浏览器将生成的报告发送到预定义的端点,同时存在一些延迟和噪声。
摘要报告
![](https://developers.google.cn/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=6&hl=cs)
摘要报告的生成方式如下:
- 用户点击或查看经过特别配置的广告。用户本地设备上的浏览器会记录此事件,以及预先指定的归因配置数据。
- 之后,当用户完成转化时,浏览器会将此详细点击或观看事件(称为“归因来源事件”)与详细转化数据(称为“归因触发器数据”)进行匹配。所捕获的详细维度由广告技术公司预定义,浏览器会遵循广告技术平台定义的特定逻辑。浏览器会将这些数据输出到可汇总报告中。
- 可汇总的报告由浏览器加密并发送到广告技术平台服务器。可汇总报告从广告技术平台服务器发送到汇总服务,以生成摘要报告。
- 然后,摘要报告将可供广告技术平台使用。请注意,摘要报告的延迟程度不会和事件级报告的延迟程度相同。
详细了解摘要报告。
隐私权
与第三方 Cookie 不同,Attribution Reporting API 让广告公司无需跟踪个人在各个网站上的活动即可深入了解转化情况。
让我们以 Bob 为例。小鲍在阅读news.example
上的新闻时看到了一则广告。一周后,Bob 在 shoes.example
买鞋。
目前,此类转化由用作跨网站标识符的第三方 Cookie 进行跟踪。借助第三方 Cookie,广告技术公司可以获取小鲍在 news.example
和 shoes.example
上的活动的大量详细信息。广告技术平台可以将这些信息合并在一起,以构建小鲍的详细个人资料,包括小鲍的位置、浏览习惯和 news.example
上的首选阅读行为。此玩家资料还可能包含 shoes.example
上的购买交易、活动和信用卡信息。这种跨网站联接有助于衡量广告转化情况。但这会妨碍用户隐私:
Bob 的活动会在多个网站上被高度详细地跟踪。
![当今网络(联接身份)和未来网络(分区身份)的并排视图](https://developers.google.cn/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=6&hl=cs)
跨网站合并少量信息,足以衡量转化情况,但不足以详细跟踪小鲍在各个网站上的活动。Bob 在 news.example
和 shoes.example
上的 activity 保持独立。
每种报告类型中的保护措施
事件级报告将广告端标识符与少量转化端数据相关联。虽然它们确实提供了有关转化的跨网站信息,但转化端信息过于粗略,无法跨网站确定用户身份。
摘要报告提供详细的数据分析,但只能在汇总级别提供;由于这些可汇总报告的内容在发送到广告技术平台时已经过加密,因此如果不使用汇总服务,广告技术平台将无法从报告中获取任何信息。汇总服务仅提供对噪声汇总的访问。
事件级报告和汇总报告都会实施速率限制等额外的隐私保护措施。
![](https://developers.google.cn/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=6&hl=cs)
详细说明:事件级报告和隐私权
事件级报告通过遵循以下隐私保护机制,在不跨网站跟踪用户的情况下提供转化数据分析洞见:
- 系统不会使用跨网站标识符,也不会使用详细的跨网站浏览活动离开设备。
- 事件级报告将广告端的 64 位信息 (
news.example
) 与转化端的 1 位或 3 位信息 (shop.example
) 相关联。64 位信息足以映射到单个用户标识符,但这 64 位只能与非常少的跨网站信息相关联:1 位或 3 位,它们不足以保存标识符。- 广告端 64 位不是新信息。目前已在广告端提供用户 ID
news.example
或adtech.example
已知道特定用户在news.example
上的活动。
- 广告端 64 位不是新信息。目前已在广告端提供用户 ID
- 我们还采取了额外的保护措施来防范滥用行为和跨网站跟踪:
- 这些报告的发送存在延迟。
- 转化数据会添加噪声:在一定百分比的时间内生成虚假报告。
- 对于每次点击或观看,归因转化报告的数量是有限的。
详细说明:摘要报告和隐私权
摘要报告会将点击或查看事件与详细的转化数据相关联。 它们通过以下隐私保护机制,在不跨网站跟踪用户的情况下提供转化分析数据:
- 不使用跨网站标识符。
- 每个归因都可以对生成的摘要报告做出多项贡献。任何给定用户都可以针对特定点击(或观看)和转化触发多个归因。
- 数据汇总最高到许多事件(许多用户)的级别,无法精确观察到单个事件。查看汇总数据时,随着详细程度的提高,该数据的相对噪声也会增加。汇总大量事件和用户的数据切片会更准确保持实用性。
- 将详细点击或查看事件与详细转化数据相关联的原始报告会经过加密处理,广告技术公司无法读取。此数据只能由汇总服务读取。
- 我们还采取了额外的保护措施来防范滥用行为和跨网站跟踪:
- 报告的发送是随机延迟的。
- 对不同数据切片的查询有速率限制。
互动和分享反馈
- 如有关于 API 的问题,请在 API 代码库中创建问题。
- 关注 Attribution Reporting 邮寄名单中的 API 更新和公告。
- 如果您有技术问题,请提交 Chromium bug。
- 有关实现、集成和一般最佳实践方面的问题:请在 Privacy Sandbox 开发者支持代码库中创建问题。