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