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">
- 向下滚动到 Frames 窗格。
- 选择您要在哪个帧中设置令牌。例如，顶部 框架（针对顶级网页）或特定 iframe（针对嵌入式网页）。
- 在右侧窗格中，向下滚动到源试用部分。
- 您应该会看到
PrivacySandboxAdsAPIs试验的条目。 - 展开此条目即可查看源试用的状态和您的特定 词元。
源试用仅限一小部分 Chrome 用户参与，您的浏览器可能会
不在实验组中。因此，您可能会看到红色 TrialNotAllowed
针对 PrivacySandboxAdsAPIs 发送的邮件。展开该条目即可查看
令牌状态（如果显示绿色 Success 消息），表示您的源试用
配置是否正确。符合条件的用户会看到设置为“Enabled”的消息。
如果您看到不同的消息，请参阅排查 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 和功能的可用性。 其他标志，用于进行更精细的配置。