Privacy Sandbox 包含一个选项, 可在无需跨网站的情况下实现广告用例的提案 跟踪。源试用为 开发者可通过 进行实际测试在之前的源试用中,网站能够测试 针对个别 API。对于 Topics API、FLEDGE API 和 Attribution Reporting API 我们提供单一源试用,让网站能够以统一的方式运行 跨 API 进行多项实验,形成端到端广告的初始版本 生命周期这些 API 可在 Chrome 101 Beta 版中进行测试 及更高级别。Chrome 浏览器 101 Beta 版还 用户控件更新 我们会继续对配置选项做出改进
作为开发者,您可以注册参与此单源试用, 让您可以对 Topics、FLEDGE 和 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 源试用入门指南。
开发者如何在本地进行测试?
有关 主题、 FLEDGE 和归因 报告 有关每个 API 的本地开发者测试的具体指南。这些 API 未启用 且必须启用 标志 测试。
如需启用 API 以进行测试,您必须执行以下操作:
- 使用 Chrome 101 Beta 版或更高版本。
- FLEDGE 需要桌面版 Chrome。
- API 不适用于 iOS 版 Chrome。
- 使用
chrome://flags/#privacy-sandbox-ads-apis
启用 API 标志。- 如果您希望
复制符合条件的源试用用户,
但仍然可以停用 API,则应启动 Chrome
使用 CLI 标志:
--enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs
。 - 个别 API 可能会提供更多额外标志,以实现更精细的控制 配置,请查看各个指南了解详情。
- 其他标志可能会与此标志冲突,因此建议仅设置 这一标记。
- 如果您希望
复制符合条件的源试用用户,
但仍然可以停用 API,则应启动 Chrome
使用 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=1&hl=ca)
DevTools 会在“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 支持?
与任何网络平台功能一样,您应检测对该功能的支持 然后再使用它
主题
检查 document
中的 browsingTopics()
函数,
权限政策](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature)
搜索主题。
if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
// Topics enabled
}
FLEDGE
如果您想加入广告兴趣组,请在以下位置查找 joinAdInterestGroup
函数:
navigator
以及“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
对象,
“归因报告”的权限政策
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting API enabled
}
开发者可以在哪里提供反馈和获取支持?
反馈概览页面详细介绍了 各种途径,针对 Privacy Sandbox 的不同方面提供反馈。 该版块有 主题、 FLEDGE 和归因 报告: 每个 API 的单独链接。
我们还会定期提供有关“隐私保护进展”的 提供重要新闻摘要的沙盒系列视频。