Topics、Fenced Frames 和 Shared Storage。 keywords: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, Skiller:Beginner
Privacy Sandbox 包含一系列用于支持广告用途的提案 而无需进行跨网站跟踪。来源 测试让开发者有机会评估 并通过实际测试提供有关新网络技术的反馈。通过 Privacy Sandbox 的相关性和 效果衡量源试用 提供一次试验,允许网站跨多种平台运行统一的实验 Attribution Reporting、Protected Audience API、Topics、Fenced Frames 和 Shared 存储空间。 开发者可以注册参与此单一源试用 跨 Topics API、Protected Audience API 和 Attribution Reporting API。这个 该指南将引导您完成访问这些 API 所需的配置步骤, 如何验证配置,并提供更多测试资源 与 API 相关
查看源试用的状态
2023 年 6 月
稳定版中的不公开汇总磨合期增加了 7%
Private Aggregation API 将 自 2023 年 6 月 6 日(星期二)起,占 Chrome 稳定版流量的 7% 即可使用此功能。API 将在主要的统一源试用组 (5%)、受保护 受众群体隔离群组 (1%) 和共享存储空间隔离群组 (1%)。通过 Protected Audience 和共享存储空间的流量分配不会改变 因为我们即将在现有孤立实验中添加不公开汇总。
截至 6 月 6 日(星期二)的流量分配情况:
API | 流量分配 | 状态 |
归因报告 | 统一 - 5% | 截至 2023 年 3 月 13 日的稳定流量的 6% |
隔离 - 1% - 仅限 ARA | ||
围栏框架 | 统一 - 5% | 截至 2023 年 3 月 13 日的稳定流量的 7% |
独立 - 1% - 共享存储空间 + 私密聚合 + 围栏框架 | ||
隔离 - 1% - Protected Audience + 不公开汇总 + 仅限围栏框架 | ||
Protected Audience | 统一 - 5% | 截至 2023 年 3 月 13 日的稳定流量的 6% |
隔离 - 1% - Protected Audience + 不公开汇总 + 仅限围栏框架 | ||
不公开汇总 | 统一 - 5% | 截至 2023 年 6 月 6 日的稳定流量的 7% |
隔离 - 1% - Protected Audience + 不公开汇总 + 仅限围栏框架 | ||
独立 - 1% - 共享存储空间 + 私密聚合 + 围栏框架 | ||
共享存储空间 | 统一 - 5% | 截至 2023 年 3 月 13 日的稳定流量的 6% |
独立 - 1% - 共享存储空间 + 私密聚合 + 围栏框架 | ||
主题 | 统一 - 5% | 截至 2023 年 3 月 13 日的稳定流量的 6% |
独立 - 1% - 仅限主题 |
过往动态
查看源试用的过往更新。
2023 年 4 月
稳定版中的不公开汇总磨合期为 1%
Aggregation API 源试用将在 Chrome 稳定版的 1% 推出
统一实验流量。sendHistogramReport()
可在 Protected Audience API 中使用不公开汇总的功能
和共享存储空间
Worklet。
从 4 月 17 日(星期一)开始,流量分配将如下所示:
API | 流量分配 | 状态 |
归因报告 | 统一 - 5% | 自 2023 年 3 月 13 日起的稳定流量的 6% |
隔离 - 1% - 仅限 ARA | ||
围栏框架 | 统一 - 5% | 自 2023 年 3 月 13 日起的稳定流量的 7% |
独立 - 1% - 共享存储空间(网址选择)+ 围栏框架 | ||
隔离 - 1% - 仅限 Protected Audience API + 围栏框架 | ||
Protected Audience API | 统一 - 5% | 自 2023 年 3 月 13 日起的稳定流量的 6% |
隔离 - 1% - 仅限 Protected Audience API + 围栏框架 | ||
不公开汇总 | 统一 - 1% | 自 2023 年 4 月 17 日起的稳定流量的 1% |
共享存储空间(网址选择) | 统一 - 5% | 自 2023 年 3 月 13 日起的稳定流量的 6% |
独立 - 1% - 共享存储空间(网址选择)+ 围栏框架 | ||
主题 | 统一 - 5% | 自 2023 年 3 月 13 日起的稳定流量的 6% |
独立 - 1% - 仅限主题 |
2023 年 3 月
时间轴更新
我们最初宣布,将分别于周一开始进行单独实验。 新实验将于 2023 年 3 月 13 日(星期四)开始, 2023 年,因为设置实验需要更多时间。1% Protected Audience API 也会在周四从 4% 恢复至 5%, 2023 年 3 月 16 日
Protected Audience API 恢复 1%
上个月,我们暂时将 Protected Audience API 源试用流量从 Chrome 稳定版的 5% 降至 4%(用于测试)。初步测试已结束,我们计划于 2023 年 3 月 16 日(星期四)将 Protected Audience API 从 4% 提升到 5%。
磨合期用户是指已进入磨合阶段的用户。不过,之前的兴趣群体已经到期,因为自停用之日起已经超过 30 天。
隔离的实验
为了改进测试流程并继续观察源试用 API 的指标,除了现有的统一实验之外,我们还为每个 API 创建了独立的实验。我们将针对 Attribution Reporting、Topics(结合使用 Protected Audience API 和 Fenced Frames,并结合使用 Shared Storage 的网址选择操作和 Fenced Frames)创建新实验。在每个孤立实验中,该群组中的用户只能使用分配的 API。
API | 隔离的实验 流量分配 |
---|---|
归因报告 | 1% |
Protected Audience API + 围栏框架 | 1% |
共享存储空间(网址选择)+ 围栏框架 | 1% |
主题 | 1% |
从 3 月 16 日(星期四)开始,您将开始获得 Chrome 稳定版流量,除您获得的 5% 流量之外, 从现有统一实验中获得的收益将分配新用户 每个实验都适用。
流量分配
截至 2 月 28 日(星期二)目前的统一源试用流量分配情况如下:
API | 当前统一实验 流量分配 |
---|---|
归因报告 | 5% |
围栏框架 | 5% |
Protected Audience API | 4% |
共享存储空间(网址选择) | 5% |
主题 | 5% |
从 3 月 16 日(星期四)起,Protected Audience API 会逐步恢复,并且新的隔离实验开始后,流量分配将如下所示:
API | 新流量分配 | 状态 |
---|---|---|
归因报告 | 统一 - 5% | 自 2023 年 3 月 16 日起的稳定流量的 6% |
隔离 - 1% - 仅限 ARA | ||
围栏框架 | 统一 - 5% | 自 2023 年 3 月 16 日起的稳定流量的 7% |
独立 - 1% - 共享存储空间(网址选择)+ 围栏框架 | ||
隔离 - 1% - 仅限 Protected Audience API + 围栏框架 | ||
Protected Audience API | 统一 - 5%(当前分配比例为 4% + 增加 1%) | 自 2023 年 3 月 16 日起的稳定流量的 6% |
隔离 - 1% - 仅限 Protected Audience API + 围栏框架 | ||
共享存储空间 (网址选择) |
统一 - 5% | 自 2023 年 3 月 16 日起的稳定流量的 6% |
独立 - 1% - 共享存储空间(网址选择)+ 围栏框架 | ||
主题 | 统一 - 5% | 自 2023 年 3 月 16 日起的稳定流量的 6% |
独立 - 1% - 仅限主题 |
这些更改不会影响您现有的源试用令牌设置,并且您无需续订或生成新的源试用令牌。
2023 年 1 月
作为 Chrome 回归调查的一部分,自 2023 年 1 月 26 日起,我们会暂时将 Protected Audience API 源试用流量从 Chrome 稳定版的 5% 降至 4%。我们预计该调查大约需要一个月的时间,我们会在流量恢复正常时通知您。
此更改会自动生效,不会影响您现有的源试用令牌。对于这 1% 的流量会逐渐减少的用户,兴趣群体仍会保留在他们的浏览器中。同样的用户也会参与公开范围渐增,并且他们的兴趣群体也可以重复使用。不过,兴趣群体会在 30 天后过期,而回归调查可能需要更长时间。
此外,自 2023 年 1 月 26 日起,Shared Storage 的 网址 Selection API 源试用将增加至 Chrome 稳定版流量的 5%。
API | 备注 |
---|---|
Attribution Reporting | 已在稳定版中提供,自 2022 年 10 月 26 日起提高至 5%。 |
主题 | 已在稳定版中提供,自 2022 年 10 月 26 日起提高至 5%。 |
Protected Audience API | 已在稳定版中提供,从 2023 年 1 月 26 日起暂时将降至 4%。 |
围栏框架 | 已在稳定版中提供,自 2022 年 11 月 9 日起将上调至 5%。 |
共享存储空间 | 已在稳定版中提供,自 2023 年 1 月 26 日起上涨 5%。 |
2022 年 11 月
自 11 月 9 日起,Shared Storage 的 `select网址` API 将加入源试用,占 Chrome 稳定版流量的 1%。
正如之前在将 Privacy Sandbox 相关性和效果衡量源试用提高到 5% 这篇博文中所宣布的,随着 Protected Audience API 和 Fenced Frames 的推出,Attribution Reporting 和 Topics 现已增至 5%。
API | 备注 |
---|---|
Attribution Reporting | 已在稳定版中提供,从 10 月 26 日起,已上调至 5%。 |
主题 | 已在稳定版中提供,从 10 月 26 日起,已上调至 5%。 |
Protected Audience API | 已在稳定版中提供,从 11 月 9 日起将上调至 5%。 |
围栏框架 | 已在稳定版中提供,从 11 月 9 日起将上调至 5%。 |
共享存储空间 | 将于 11 月 9 日起在稳定版中提供,比例为 1%。 |
2022 年 10 月:增长 5%
Attribution Reporting、Topics、Protected Audience API 和 Fenced Frames 目前均在 Chrome 稳定版中提供,并且将成为流量增加的一部分。
我们将从本周开始增加 Attribution Reporting 和 Topics 的流量;自 11 月 9 日起,Protected Audience API 和 Fenced Frames 将增加流量。
如需了解详情,请参阅将 Privacy Sandbox 相关性和效果衡量源试用提高到 5% 博文。
API | 备注 |
---|---|
Attribution Reporting | 已在稳定版中提供,10 月 26 日之后将上调至 5%。 |
主题 | 已在稳定版中提供,10 月 26 日之后将上调至 5%。 |
Protected Audience API | 已在稳定版中提供,从 11 月 9 日起将上调至 5%。 |
围栏框架 | 已在稳定版中提供,从 11 月 9 日起将上调至 5%。 |
共享存储空间 | 目前仅在 M105+ Canary 版、开发者版和 Beta 版中提供。 |
2022 年 10 月
- 源试用已延长至 Chrome 110。
- Chrome 源试用使用入门介绍了如何续订源试用注册。这包括向参与源试用的源提供新令牌,此过程与任何其他源试用延期后的流程相同。
获准延期的目的是让稳定渠道中的生态系统有时间 继续测试和验证 API 改进,同时提供反馈 与现有的公开时间表一致。
整体 Privacy Sandbox 时间表保持不变。
试用中包含的 API:
API | 备注 |
---|---|
归因 报告 | 开发者 源试用指南。 |
Protected Audience API | 开发者 源试用指南。 |
主题 | 开发者 源试用指南。 |
围栏 框架 | 如需了解源试用的使用方法,请参阅 Protected Audience API 指南。 |
共享 存储空间 | 目前仅在 M105+ Canary 版、开发者版和 Beta 版中提供。 |
2022 年 8 月
- Chrome 稳定版 104 起,源试用功能的可用性会逐步上升到 1% 的桌面用户。
- 待该功能推出面向移动设备用户后,我们便会随之更新。
- 预先稳定渠道(Canary 版、Beta 版)的用户占比仍为 50%。
- API 在 iOS Chrome 上不可用。
2022 年 5 月
Chrome 102 Beta 版后,源试用会逐步增加到 50% 的用户。
试用中包含的 API:
API | 备注 |
---|---|
归因 报告 | 开发者 源试用指南。 |
Protected Audience API | 开发者 源试用指南。 |
主题 | Google Play 上 源试用。由于存在一个错误, 影响了浏览器的稳定性 |
围栏 框架 | 源试用中添加了围栏框架。查看 Protected Audience API 指南 用于实验用途。 |
2022 年 4 月
源试用可让一定比例的 Chrome 102 Beta 版用户开始试用。
试用中包含的 API:
API | 备注 |
---|---|
归因 报告 | 个别意图 再到实验 (I2E) 后面的步骤。Attribution Reporting 还可以 单次源试用。 |
Protected Audience API | 个别意图 再到实验 (I2E) 后面的步骤。Protected Audience API 仅适用于桌面设备,且必须具备 部分功能。 |
主题 | 个别意图 再到实验 (I2E) 后面的步骤。 |
注册并配置源试用
如需在您的网站上激活源试用,您需要注册并嵌入 分配的源试用令牌(基于时间的字符串,用于 源试用)。如需了解详情,请参阅 Chrome 的来源使用入门 测试。
源试用令牌会立即授予,您可以将其撤消或重新创建 。
对于您想参与源试用的每个网页,您都需要添加 包含该特定网页的 HTML 或响应的试用令牌。
在网页的 <head>
部分使用 <meta>
标记:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
或者在网页响应中添加以下 HTTP 标头:
Origin-Trial: TOKEN_GOES_HERE
使用 iframe 进行配置
如果您在 iframe 内使用源试用功能(例如 Protected Audience API 的
joinAdInterestGroup()
),则您需要在 iframe 中提供令牌
并与 iframe 的来源相匹配。
使用 JavaScript 配置跨网站
如果您通过跨网站 JavaScript 使用源试用功能(例如 顶级网页中所包含的第三方 JavaScript 的提供商; 那么您需要执行以下操作:
- 注册来源时,选择第三方匹配选项 试用。
- “Web Origin”字段应为脚本的来源。
- 将
<meta>
代码注入顶级网页(即第一方 网页,而不是您自己的内容)。例如:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
调试源试用
您可以在 DevTools > 查看源试用的状态应用 面板。
<ph type="x-smartling-placeholder">![令牌成功状态和已启用。](https://developers.google.cn/privacy-sandbox/assets/images/token-success-status.avif?authuser=7&hl=ca)
- 向下滚动到 Frames 窗格。
- 选择您要在哪个帧中设置令牌。例如,顶部 框架(针对顶级网页)或特定 iframe(针对嵌入式网页)。
- 在右侧窗格中,向下滚动到源试用部分。
- 您应该会看到
PrivacySandboxAdsAPIs
试验的条目。 - 展开此条目即可查看源试用的状态和您的特定 词元。
源试用仅限一小部分 Chrome 用户参与,您的浏览器可能会
不在实验组中。因此,您可能会看到红色 TrialNotAllowed
针对 PrivacySandboxAdsAPIs
发送的邮件。展开该条目即可查看
令牌状态(如果显示绿色 Success
消息),表示您的源试用
配置是否正确。符合条件的用户会看到设置为“Enabled
”的消息。
![令牌成功状态,未启用。](https://developers.google.cn/privacy-sandbox/assets/images/token-success-status-not-enabled.avif?authuser=7&hl=ca)
如果您看到不同的消息,请参阅排查 Chrome 的来源问题 测试 用于验证源试用配置的详细核对清单。
检测特征
与所有网络功能一样,您应该检查它们是否报告为 然后再尝试使用。为此,您可以查看 相关 API 是否位于正确位置:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting enabled
}
if ('runAdAuction' in navigator) {
// Protected Audience API enabled
}
if ('browsingTopics' in document) {
// Topics enabled
}
if ('HTMLFencedFrameElement' in window) {
// Fenced Frames enabled
}
if ('sharedStorage' in window) {
// Shared Storage enabled
}
if (window?.sharedStorage?.selectURL instanceof Function) {
// optionally check specifically for the selectURL function in Shared Storage
}
确定用户资格条件
一小部分 Chrome 用户正在参与源试用。还必须 其设置中启用的相关功能,才有资格使用 试用:
浏览器设置
用户必须满足以下条件,才有资格参与试用:
使用的是源试用的 Chrome 版本和渠道 。
- 如需了解当前配置,请参阅源试用状态。
属于 Chrome 中活跃的实验组。
用户设置
用户还必须满足以下条件,才有资格参与试用:
- 通过“设置”>“启用 Privacy Sandbox 试用”安全和
隐私权 >Privacy Sandbox,也可通过以下方式访问:
chrome://settings/adPrivacy
。 - 已通过“设置”>“启用第三方 Cookie”安全和隐私权 >
Cookie 和其他网站数据集设为“允许所有 Cookie”或“屏蔽
第三方 Cookie”,也可通过
chrome://settings/cookies
。 - 处于标准浏览会话且未处于无痕模式。
虽然源试用只会对符合条件的用户显示为有效,但您也可以 使用开发者标志针对您自己的生产环境进行测试 网站。
控制您参与源试用的情况
源试用的机制保持不变:您获得源试用 您想要在其中试验 API 的上下文的令牌。使用 扩大测试群体,您应该确保主动监控 以及控制要启用试用版的流量级别。
这种情况下,一个很好的方法是:
- 在您希望添加源试用令牌的所有环境中默认添加源试用令牌 实验。
- 使用功能检测功能检查是否存在活跃 API。
- 如果 API 有效(因此,浏览器有资格使用此 API) 实验),您可以根据自己的实验来选择是否要使用这些功能。 条件。例如,如果您已经拥有 A/B 测试基础架构 对一定比例的流量、抽样或某种其他属性进行实验 此时,您就可以确定要主动使用哪些功能了。
您可以针对任何浏览器完全禁止参与源试用 也就是不在响应中包含令牌。例如,如果你的 达到您自己的实验配额,或者需要在实验运行期间解决 则不添加令牌可确保任何实验性功能 在相应网页上可用或有效
按地理区域进行源试用控制
您无法针对特定区域选择退出源试用。源试用 在包含 令牌,包括 通过 HTTP 标头(服务器端)或 HTML 元标记(客户端)发送。
如果您可以确定用户所在位置,您可以编写代码来添加 源试用令牌。例如,您 可能会尝试使用 IP 地址来确定用户的位置。IP 地址 可能会被仿冒,因此这并不是万无一失的解决方案。
不过,特定于地理位置的来源可以设置权限
政策来控制
易于使用。例如,us.example.com
和 uk.example.com
是
特定地理位置的起点,这也是可以控制的。这并不意味着
已选择退出源试用。
有了“权限政策”,网站会向自己的网页添加一小段代码 向浏览器提供说明的代码库。网页加载时,浏览器会 阅读权限政策说明,并允许或禁止使用某些功能(或 如权限政策中所述)。如果网站想限制某个 API 那么开发者可以为请求访问的所有网页设置一项政策, 来自该区域
续订您的令牌
源试用令牌会在发放之日起 6 周后(或 试用期内)。
请务必为您的新服务 词元 不受源试用功能的使用。
续订令牌只需几分钟的时间,您可以为 同一网页的同一次试验。您可以部署已续期的令牌, 现有令牌已到期,因此用户不会遇到服务中断的情况。
在本地测试
如需关于本地开发者测试的具体指南,请参阅:
默认情况下,这些 API 并未启用,您必须通过 标志 测试。您应该确保已启用相同的配置设置 ,然后执行以下操作:
- 使用提供这些功能的 Chrome 版本和渠道。
- 启用
chrome://settings/adPrivacy
下的所有广告隐私权 API。
请参阅开发者指南,了解特定 API 和功能的可用性。 其他标志,用于进行更精细的配置。