此页面由 Cloud Translation API 翻译。

相关性和衡量统一源试用

Privacy Sandbox 包含一系列提案，旨在实现广告用例，而无需进行跨网站跟踪。源试用为开发者提供了一个机会，让他们可以通过实际测试来评估新的 Web 技术并提供反馈。Privacy Sandbox 相关性和效果衡量源试用提供了一项单一的试用，允许网站针对 Attribution Reporting、Protected Audience API、Topics、Fenced Frames 和 Shared Storage 运行统一的实验。开发者可以注册参加此单一源试用，以便测试 Topics API、Protected Audience API 和 Attribution Reporting API。本指南将引导您完成访问 API 的配置步骤，说明如何验证配置，并提供更多资源来针对 API 进行测试。

查看源试用状态

2023 年 6 月

在稳定版中将不公开汇总功能增加 7%

自 2023 年 6 月 6 日（星期二）起，Private Aggregation API 将在 7% 的 Chrome 稳定版流量中提供。该 API 将在主要统一源试用组 (5%)、Protected Audience 隔离组 (1%) 和 Shared Storage 隔离组 (1%) 中提供。由于 Private Aggregation 是添加到现有的隔离实验中，因此 Protected Audience 和 Shared Storage 的流量分配不会发生变化。

截至 6 月 6 日（星期二）的流量分配：

API	流量分配	状态
Attribution Reporting	统一 - 5%	截至 2023 年 3 月 13 日，稳定版流量的 6%
	隔离 - 1% - 仅限 ARA
Fenced Frames	统一 - 5%	截至 2023 年 3 月 13 日，稳定版流量的 7%
	隔离 - 1% - 仅限 Shared Storage + Private Aggregation + Fenced Frames
	隔离 - 1% - 仅限 Protected Audience + Private Aggregation + Fenced Frames
Protected Audience	统一 - 5%	截至 2023 年 3 月 13 日，稳定版流量的 6%
	隔离 - 1% - 仅限 Protected Audience + 私密聚合 + 受限框架
不公开汇总	统一 - 5%	截至 2023 年 6 月 6 日，稳定版流量的 7%
	隔离 - 1% - 仅限 Protected Audience + 私密聚合 + 受限框架
	隔离 - 1% - 仅限 Shared Storage + Private Aggregation + Fenced Frames
Shared Storage	统一 - 5%	截至 2023 年 3 月 13 日，稳定版流量的 6%
	隔离 - 1% - 仅限 Shared Storage + Private Aggregation + Fenced Frames
主题	统一 - 5%	截至 2023 年 3 月 13 日，稳定版流量的 6%
	隔离 - 1% - 仅限主题

过往动态

查看有关源试用的先前更新。

2023 年 4 月

在稳定版中将 Private Aggregation 增加 1%

Private Aggregation API 源试用将从 4 月 17 日（星期一）开始，面向 1% 的 Chrome 稳定版统一实验流量提供。Private Aggregation 的 sendHistogramReport() 函数可在 Protected Audience API 和 Shared Storage 的工作程序中使用。

自 4 月 17 日（周一）起，流量分配将如下所示：

API	流量分配	状态
Attribution Reporting	统一 - 5%	从 2023 年 3 月 13 日起，稳定版流量的 6%
	隔离 - 1% - 仅限 ARA
Fenced Frames	统一 - 5%	从 2023 年 3 月 13 日起，稳定版流量的 7%
	隔离 - 1% - 共享存储空间（网址选择）+ 仅限围栏框架
	隔离 - 1% - 仅限 Protected Audience API + Fenced Frame
Protected Audience API	统一 - 5%	从 2023 年 3 月 13 日起，稳定版流量的 6%
	隔离 - 1% - 仅限 Protected Audience API + Fenced Frame
不公开汇总	统一 - 1%	自 2023 年 4 月 17 日起，稳定版流量的 1%
Shared Storage（网址选择）	统一 - 5%	从 2023 年 3 月 13 日起，稳定版流量的 6%
	隔离 - 1% - 共享存储空间（网址选择）+ 仅限围栏框架
主题	统一 - 5%	从 2023 年 3 月 13 日起，稳定版流量的 6%
	隔离 - 1% - 仅限主题

2023 年 3 月

时间轴更新

我们最初通知您，我们将于 2023 年 3 月 13 日（星期一）开始进行隔离实验，但由于需要更多时间来设置实验，新实验现在将于 2023 年 3 月 16 日（星期四）开始。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	隔离实验流量分配
Attribution Reporting	1%
Protected Audience API + Fenced Frames	1%
共享存储空间（网址选择）+ 受限框架	1%
主题	1%

自 3 月 16 日（周四）起，您将开始接收额外的 1% Chrome 稳定版流量，用于测试上述 API，这部分流量是在您从现有统一实验中接收的 5% 流量的基础上增加的。新用户将分配到每个实验。

流量分配

截至 2 月 28 日（星期二），当前统一的来源试用流量分配如下：

API	当前统一实验流量分配
Attribution Reporting	5%
Fenced Frames	5%
Protected Audience API	4%
Shared Storage（网址选择）	5%
主题	5%

在 Protected Audience API 重新开始逐步推出后，从 3 月 16 日（星期四）开始，流量分配将如下所示，并且新的隔离实验将开始：

API	新的流量分配	状态
Attribution Reporting	统一 - 5%	从 2023 年 3 月 16 日起，稳定版流量的 6%
Attribution Reporting	隔离 - 1% - 仅限 ARA	从 2023 年 3 月 16 日起，稳定版流量的 6%
Fenced Frames	统一 - 5%	从 2023 年 3 月 16 日起，稳定版流量的 7%
	隔离 - 1% - 共享存储空间（网址选择）+ 仅限围栏框架
	隔离 - 1% - 仅限 Protected Audience API + Fenced Frame
Protected Audience API	统一 - 5%（当前分配比例为 4%，另有 1% 的比例用于逐步恢复）	从 2023 年 3 月 16 日起，稳定版流量的 6%
Protected Audience API	隔离 - 1% - 仅限 Protected Audience API + Fenced Frame	从 2023 年 3 月 16 日起，稳定版流量的 6%
Shared Storage （网址选择）	统一 - 5%	从 2023 年 3 月 16 日起，稳定版流量的 6%
Shared Storage （网址选择）	隔离 - 1% - 共享存储空间（网址选择）+ 仅限围栏框架	从 2023 年 3 月 16 日起，稳定版流量的 6%
主题	统一 - 5%	从 2023 年 3 月 16 日起，稳定版流量的 6%
主题	隔离 - 1% - 仅限主题	从 2023 年 3 月 16 日起，稳定版流量的 6%

这些更改不会影响您现有的源试用令牌设置，您也不必续订或生成新的源试用令牌。

2023 年 1 月

为了调查 Chrome 回归问题，我们将从 2023 年 1 月 26 日起，暂时将 Protected Audience API 源试用流量从 Chrome 稳定版的 5% 减少到 4%。我们估计调查大约需要一个月的时间，并且会在流量恢复时通知您。

这项变更将自动完成，不会影响您现有的源试用令牌。对于将逐渐减少的 1% 流量中的用户，兴趣组将保留在他们的浏览器中。同一批用户将参与回升阶段，并且可以重复使用其兴趣群体。不过，兴趣组会在 30 天后过期，而回归调查可能需要更长时间。

此外，自 2023 年 1 月 26 日起，Shared Storage 的网址选择 API 源试用将增加到 Chrome 稳定版流量的 5%。

API	备注
Attribution Reporting	自 2022 年 10 月 26 日起，稳定版中的比例已从 1% 提高到 5%。
主题	自 2022 年 10 月 26 日起，稳定版中的比例已从 1% 提高到 5%。
Protected Audience API	在稳定版中提供，自 2023 年 1 月 26 日起暂时降至 4%。
Fenced Frames	在稳定版中提供，从 2022 年 11 月 9 日起增加到 5%。
Shared Storage	在稳定版中提供，自 2023 年 1 月 26 日起增加 5%。

2022 年 11 月

Shared Storage 的 `select网址` API 将于 11 月 9 日开始加入源试用，并面向 1% 的 Chrome 稳定版流量进行测试。

正如之前在将 Privacy Sandbox 相关性和效果衡量源试用的比例提高到 5% 这篇博文中宣布的那样，Attribution Reporting 和 Topics 的比例现已达到 5%，Protected Audience API 和 Fenced Frames 也将于 11 月 9 日跟进。

API	备注
Attribution Reporting	在稳定版中提供，自 10 月 26 日起增加到 5%。
主题	在稳定版中提供，自 10 月 26 日起增加到 5%。
Protected Audience API	在稳定版中提供，自 11 月 9 日起增加到 5%。
Fenced Frames	在稳定版中提供，自 11 月 9 日起增加到 5%。
Shared Storage	将于 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%。
Fenced Frames	在稳定版中提供，自 11 月 9 日起增加到 5%。
Shared Storage	目前仅在 M105 及更高版本的 Canary 版、开发版和 Beta 版中提供。

2022 年 10 月

源试用已延长至 Chrome 110。
Chrome 源试用入门一文介绍了如何续订源试用注册。这包括向参与的源站提供新令牌，这与任何其他源试用延期所遵循的流程相同。

之所以延长此期限，是为了让生态系统有时间在稳定版渠道中继续测试和验证 API 改进，同时提供与我们现有公开时间表一致的反馈。

Privacy Sandbox 的总体时间表保持不变。

试用版中包含的 API：

API	备注
归因报告	源试用的开发者指南。
Protected Audience API	源试用的开发者指南。
主题	源试用的开发者指南。
Fenced Frames	请参阅 Protected Audience API 指南，了解源试用使用情况。
Shared Storage	目前仅在 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	源试用的开发者指南。
主题	源试用的开发者指南。由于存在影响浏览器稳定性的 bug，Topics 在源试用中曾短暂停用。
Fenced Frames	已将 Fenced Frames 添加到源试用中。如需了解实验用法，请参阅 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 > 应用面板中查看源试用的状态。

向下滚动到帧窗格。
选择您希望设置令牌的帧。例如，顶级网页的顶部框架或嵌入式网页的特定 iframe。
在右侧窗格中，向下滚动到源试用部分。
您应该会看到 PrivacySandboxAdsAPIs 试用版条目。
展开此条目可查看源试用的状态和您的具体令牌。

源试用仅面向部分 Chrome 用户，您的浏览器可能不在实验组中。因此，您可能会看到红色 TrialNotAllowed 消息，而不是 PrivacySandboxAdsAPIs。展开相应条目以检查令牌状态时，如果显示绿色 Success 消息，则表示您的源试用配置正确无误。符合条件的用户将看到设置为 Enabled 的消息。

如果您看到其他消息，请参阅针对 Chrome 的源试用进行问题排查，获取详细的清单来验证源试用的配置。

检测特征

与所有 Web 功能一样，您应先检查它们是否在浏览器中报告为可用，然后再尝试使用它们。您可以通过检查相关 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”或“在无痕模式下屏蔽第三方 Cookie”（也可通过 chrome://settings/cookies 访问）。
处于标准浏览会话中，而非无痕模式。

虽然源试用版只会向符合条件的用户显示为有效，但您也可以使用开发者标志针对自己的正式版网站进行测试。

控制您参与源试用的情况

源试用的机制保持不变：您需要为要试用 API 的上下文获取源试用令牌。随着测试人口的扩大，您应确保主动监控和控制您选择启用试验的流量水平。

这里的好方法是：

默认情况下，在您希望进行实验的所有情境中都包含源试用令牌。
使用功能检测来检查有效 API。
如果这些 API 处于有效状态（因此浏览器符合此实验的条件），请根据您自己的实验条件选择是否使用它们。例如，如果您已有 A/B 测试基础架构，可用于对一部分流量、抽样或其他属性进行实验，那么此时您可以决定要主动使用哪些功能。

您可以通过不在响应中添加令牌，完全阻止任何浏览器实例参与源试用。例如，如果您已达到实验的配额，或者需要在试用期间解决问题，那么不添加令牌可确保网页中不会提供或启用任何实验性功能。

按地理区域控制源试用

您无法针对特定区域选择不参与源试用。如果网页包含令牌（通过 HTTP 标头 [服务器端] 或 HTML 元标记 [客户端] 包含），则源试用会在该网页上处于有效状态。

如果您可以确定用户的位置，则可以编写代码，根据该位置信息添加源试用令牌。例如，您可以尝试使用 IP 地址来确定用户的位置。IP 地址可能会被欺骗，因此这不是一种有保障的解决方案。

不过，特定地理位置的来源可以设置权限政策来控制可使用的功能。例如，us.example.com 和 uk.example.com 是可以控制的特定地理位置来源。这并不意味着某个地区已选择退出源试用。

借助权限政策，网站可以向网页添加一小段代码，为浏览器提供指令。当网页加载时，浏览器会读取权限政策指令，并根据权限政策的规定允许或阻止功能（或 API）。如果网站想要限制特定区域中的 API，开发者可以为从该区域请求的所有网页设置政策。

续用令牌

源试用令牌自签发之日起六周后过期（如果试用期更短，则在试用期结束时过期）。

请务必在该时间范围内续订并部署新令牌，以便不间断地使用源试用功能。

续订令牌只需几分钟，您可以在同一页面中为同一试用期部署多个令牌。您可以在现有令牌过期之前部署续订的令牌，这样用户就不会遇到服务中断的情况。

在本地测试

如需有关本地开发者测试的具体指导，请参阅：

这些 API 默认处于停用状态，必须通过标志启用才能进行测试。您应确保已启用上述相同的配置设置，然后：

使用提供相应功能的 Chrome 版本和渠道。
启用 chrome://settings/adPrivacy 下的所有广告隐私权 API。

查看开发者指南，了解特定 API 和功能的可用性，以及用于更精细配置的其他标志。

相关性和衡量统一源试用 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

查看源试用状态

2023 年 6 月

在稳定版中将不公开汇总功能增加 7%

过往动态

2023 年 4 月

在稳定版中将 Private Aggregation 增加 1%

2023 年 3 月

时间轴更新

Protected Audience API 重新开始 1% 的小范围测试

隔离实验

流量分配

2023 年 1 月

2022 年 11 月

2022 年 10 月：增加 5%

2022 年 10 月

2022 年 8 月

2022 年 5 月

2022 年 4 月

注册并配置源试用

使用 iframe 进行配置

使用 JavaScript 配置跨网站

调试源试用

检测特征

确定用户是否符合条件

浏览器设置

用户设置

控制您参与源试用的情况

按地理区域控制源试用

续用令牌

在本地测试

相关性和衡量统一源试用