Privacy Sandbox 包含一系列提案，无需跨网站跟踪即可实现广告用例。源试用让开发者有机会通过实际测试来评估新的 Web 技术并提供反馈。在之前的源试用中，网站可以针对各个 API 进行测试。对于 Topics API、FLEDGE API 和 Attribution Reporting API，我们将提供单个源试用，以允许网站跨所有 API 运行统一实验，从而构成端到端广告生命周期的初始版本。这些 API 可用于在 Chrome 101 Beta 版及更高版本中进行测试。随着我们持续迭代配置选项，Chrome 101 Beta 版还会看到用户控件更新。
作为开发者，您可以注册参加此单一源试用，从而跨 Topics API、FLEDGE API 和 Attribution Reporting API 进行测试。本指南介绍了访问 API 的配置步骤，说明了如何验证配置，并提供了用于测试 API 的其他资源。
源试用包含哪些内容？
此源试用的目标是让跨多个网站的广告生命周期进行有意义的测试。为了顺利完成此历程，源试用包括：
- Topics，用于通过
document.browsingTopics()观察和访问浏览器的主题。 - FLEDGE - 用于管理浏览器的兴趣组，以及基于这些兴趣组和其他信号的广告出价和选择。
- 在此源试用中，FLEDGE 可在桌面设备上使用，并且包含所有提议的功能中的部分特定功能。如需了解详情，请参阅 FLEDGE 源试用详情。
- 围栏框架：用于呈现 FLEDGE 广告竞价胜出者的不透明网址。
- Attribution Reporting - 用于衡量和报告广告生命周期内的效果。
虽然此设置允许对所有这些 API 进行统一测试，但您可以选择要实现哪些方面，无论多大都符合您的需求。
开发者如何注册源试用？
注册参加 Privacy Sandbox 相关性和效果衡量试用。使用以下 HTML 标记，在您要运行 API 代码的每个网页上提供一个试用令牌：
- 顶级网页的
<head>部分中的<meta>标记：<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE"> - 顶级网页响应中的 HTTP 标头：
Origin-Trial: TOKEN_GOES_HERE
源试用中提供的某些功能适用于跨网站情境，例如当您在顶级网站上以第三方身份提供服务时。如果您需要针对这些其他情境启用源试用，请务必选择“第三方匹配”选项。如需启用来自第三方 JavaScript 的源试用，请从脚本中将 <meta> 标记注入顶级网页（即第一方网页，而不是您自己的内容）。例如：
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
有关详情，请参阅 Chrome 源试用入门指南。
开发者如何进行本地测试？
Topics、FLEDGE 和 Attribution Reporting 的相关开发者文档提供了有关每个 API 的本地开发者测试的具体指导。这些 API 并非默认启用，必须通过标志启用才能进行测试。
如需启用 API 以进行测试，您必须执行以下操作：
- 使用 Chrome 101 Beta 版或更高版本。
- FLEDGE 需要使用桌面版 Chrome。
- iOS 版 Chrome 不支持 API。
- 使用
chrome://flags/#privacy-sandbox-ads-apis标志启用 API。- 此标志会强制启用 API，以简化测试。如果您想复制符合条件的源试用用户（并且其其他设置仍然可以停用这些 API），则应使用 CLI 标志 (
--enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs) 启动 Chrome。 - 各个 API 可能具有更多其他标志，以实现更精细的配置，详情请参阅各指南。
- 其他标志可能会与这个标志冲突，因此请考虑仅在遇到问题时设置这个标志。
- 此标志会强制启用 API，以简化测试。如果您想复制符合条件的源试用用户（并且其其他设置仍然可以停用这些 API），则应使用 CLI 标志 (
- 在 Chrome 设置中启用 Privacy Sandbox 试用：依次点击设置 > 安全和隐私 > Privacy Sandbox。您也可以通过
chrome://settings/adPrivacy访问它。 - 在 Chrome 设置中启用第三方 Cookie：依次点击设置 > 安全和隐私。将 Cookie 及其他网站数据设置为“允许所有 Cookie”或“在无痕模式下阻止第三方 Cookie”。您也可以通过
chrome://settings/cookies访问此文件。 - 使用的是标准浏览会话。请勿使用无痕模式。
开发者如何检查源试用是否已正确配置？
Chrome 源试用问题排查提供了详细的核对清单，用于验证源试用的配置。
开发者工具会在“Frames”下的“Applications”标签页中显示源试用的状态。
虽然源试用只会对符合条件的用户显示处于活跃状态（详见下文），但您也可以使用开发者标志对您自己的正式版网站进行测试。
哪些用户有资格参与源试用？
根据设计，源试用仅针对总 Chrome 流量中的一小部分运行，因此，您应始终假定：即使您已在网站上启用源试用，用户也可能尚未启用该 API。源试用中的活跃实验组最初的用户比例较低，并且可能会随着试验的进行而逐步增加。请注意，实验中的 Chrome 用户百分比可能与您网站上已启用用户的百分比不一致。
不过，为了能够跨网站进行统一测试，这组符合条件的用户应保持大致的一致性。例如，如果用户在参与此计划的发布商网站上查看广告，并且符合源试用的条件，那么当该用户在参与此计划的广告主网站上完成转化时，应该仍符合条件。
用户必须满足以下条件，才能使用此功能：
- 使用的是 Chrome 101 Beta 版或更高版本。
- FLEDGE 需要使用桌面版 Chrome。
- iOS 版 Chrome 不支持源试用。
- 有效源试用期间浏览的内容。
- 依次点击“设置”>“安全和隐私”>“Privacy Sandbox”来启用 Privacy Sandbox 试用（也可通过
chrome://settings/adPrivacy访问）。 - 依次点击“设置”>“安全和隐私”>“Cookie 及其他网站数据”，启用第三方 Cookie，然后设置为“允许所有 Cookie”或“在无痕模式下阻止第三方 Cookie”（也可通过
chrome://settings/cookies访问）。 - 使用的是标准浏览会话，而不是无痕模式。
- 位于 Chrome 中的有效实验组。
开发者功能应如何检测 API 支持？
与任何 Web 平台功能一样，您应该先检测对该功能的支持情况，然后再使用。
主题
请检查 document 中的 browsingTopics() 函数以及“browsing-topics”的权限政策](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature)。
if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
// Topics enabled
}
FLEDGE
如果您想加入某个广告兴趣群体，请查看 navigator 中的 joinAdInterestGroup 函数以及“join-ad-interest-group”的权限政策。
if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
// FLEDGE interest group enabled
}
如果您想要运行竞价，请查看 navigator 中的 runAdAuction 函数，以及“run-ad-auction”的权限政策。
if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
// FLEDGE auction enabled
}
Attribution Reporting
查看 window 中的 attributionReporting 对象以及“attribution-reporting”的权限政策。
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting API enabled
}
开发者可以在哪里提供反馈和获取支持？
反馈概览页面详细介绍了针对 Privacy Sandbox 的不同方面提供反馈的各种途径。Topics、FLEDGE 和 Attribution Reporting 中的特定部分提供了每个 API 对应的单独链接。
我们还会定期提供有关 Privacy Sandbox 系列进度的最新动态，其中简要介绍了重要新闻。