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 源试用问题排查提供了详细的核对清单,用于验证源试用的配置。
![开发者工具在“Applications”下显示源试用状态](https://developers.google.cn/static/privacy-sandbox/assets/images/blog/devtools-showing-origin-t-ca92b0341055a.png?authuser=0&hl=sr)
开发者工具会在“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 系列进度的最新动态,其中简要介绍了重要新闻。