测试 Privacy Sandbox 广告相关性和效果衡量 API

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() 观察和访问浏览器的 Topics。
  • FLEDGE，用于管理浏览器的兴趣群体，以及根据这些群体和其他信号进行广告出价和选择。
    • 在此源代码试用版中，FLEDGE 适用于桌面设备，并包含所有提议功能中的特定子集。如需了解详情，请参阅 FLEDGE 源试用详情。
  • 围栏帧，用于呈现 FLEDGE 广告竞价胜出方的不透明网址。
    • 归因报告，用于衡量广告生命周期内的效果并生成报告。
    • 在归因报告中，可汇总的报告必须由汇总服务进行处理和汇总，才能生成摘要报告。我们很快就会发布更多用于本地和源试用测试的工具和指南。
    • 如果您之前参与过归因报告的来源测试，请注意，您需要根据最新的 API 更改进行更新。如需了解详情，请参阅迁移指南。

虽然此设置支持对所有这些 API 进行统一测试，但您可以选择要实现哪些方面，根据需要进行增减。

开发者如何注册参与来源测试？

注册 Privacy Sandbox 相关性和效果衡量试用计划。在您要运行 API 代码的每个网页上，使用以下 HTML 代码提供试用令牌：

  • 顶级页面的 <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 API、FLEDGE API 和 Attribution Reporting API 的各个开发者文档针对每个 API 提供了有关本地开发者测试的具体指南。这些 API 默认处于关闭状态，必须使用标志启用才能进行测试。

如需为测试启用 API，您必须满足以下条件：

  • 使用 Chrome 101 Beta 版或更高版本。
    • FLEDGE 需要桌面版 Chrome。
    • iOS 版 Chrome 不支持 API。
  • 使用 chrome://flags/#privacy-sandbox-ads-apis 标志启用 API。
    • 此标志会强制启用这些 API，以便更轻松地进行测试。如果您想模拟符合条件的来源试用用户（其其他设置仍可停用这些 API），则应使用以下 CLI 标志启动 Chrome：--enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs。 * 个别 API 可能具有更多其他标志，以实现更精细的配置，如需了解详情，请参阅各个指南。
    • 其他标志可能会与此标志冲突，因此如果您遇到问题，请考虑仅设置此标志。
  • 在 Chrome 设置中启用 Privacy Sandbox 的试用版功能：依次选择设置 > 安全和隐私 > Privacy Sandbox。您也可以通过 chrome://settings/adPrivacy 访问此页面。
  • 在 Chrome 设置中启用第三方 Cookie：依次选择设置 > 安全和隐私。将Cookie 及其他网站数据设为“允许所有 Cookie”或“在无痕模式下阻止第三方 Cookie”。您也可以通过 chrome://settings/cookies 访问此文件。
  • 处于标准浏览会话中。请勿使用无痕模式。

开发者如何检查来源试用版是否配置正确？

排查 Chrome 源试用版的问题提供了一份详细的核对清单，用于验证您对源试用版的配置。

在“应用”下显示来源试用状态的 DevTools

开发者工具会在“应用”标签页的“框架”下方显示来源试用版的状态。

虽然来源测试仅会向符合条件的用户显示为有效（详见下文），但您还可以使用开发者标志对自己的正式版网站进行测试。

哪些用户可以参与来源试用？

从设计上讲，源代码试用版仅针对一小部分 Chrome 总流量运行，因此您应始终假定，即使您在网站上启用了源代码试用版，用户也可能未启用该 API。来源实验中的有效实验组一开始包含的用户比例较低，但随着实验的进行，该比例可能会逐步提高。请注意，实验中的 Chrome 用户百分比可能与您网站上启用该功能的用户百分比不一致。

不过，为了能够在各个网站上进行统一测试，这组符合条件的用户应保持大致一致。例如，如果用户在参与计划的发布商网站上查看广告时符合来源试用条件，那么当该用户在参与计划的广告客户网站上完成转化时，也应该符合条件。

用户必须满足以下条件，才能获得资格：

  • 使用 Chrome 101 Beta 版或更高版本。
    • FLEDGE 需要桌面版 Chrome。
    • iOS 版 Chrome 不提供源试用。
  • 在有效的源试用期内浏览。
  • 已通过“设置”>“安全和隐私”>“Privacy Sandbox”（也可通过 chrome://settings/adPrivacy 访问）启用 Privacy Sandbox 的试用版功能。
  • 启用了第三方 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 进展”系列文章，其中会总结重要资讯。