针对第三方 Cookie 弃用试用宽限期的选择停用机制

对于参加任一第三方 Cookie 弃用试用计划的网站,Chrome 提供了宽限期来暂时重新启用第三方 Cookie。在宽限期内,网站可以在 Chrome 中访问第三方 Cookie,即使尚未部署试用令牌也是如此。

Chrome 还提供了一种机制,可让网站为一定比例的用户选择退出宽限期。选择退出机制将使网站能够运行自己的分阶段发布模式,从而帮助他们摆脱对宽限期的依赖,从而测试弃用试用令牌部署并转向长期解决方案。

开发者为何需要选择停用机制

当网站或服务获准进行第一方第三方弃用试用时,Chrome 会提供试用令牌并启动一个宽限期,以便有时间部署令牌。宽限期将继续有效,直到其到期,即使在部署令牌之后也是如此。在测试弃用试用令牌部署是否成功时,这样做可能会遇到问题。

开发者可以设置用于停用宽限期的 Chrome 标志,以在本地测试令牌部署,但这不适用于大规模测试。为了使网站能够在生产环境中测试令牌部署,Chrome 现在提供了一种机制,可供一定比例的用户选择停用宽限期。

配置宽限期退订百分比

如需选择退出,请在您网站的 .well-known 目录 (/.well-known/tpcd/grace-period.json) 中提供可公开访问的配置文件。grace-period.json 文件针对其中一个或两个弃用试用宽限期提供选择停用百分比:

  • FirstPartyOptOutPercentage
  • ThirdPartyOptOutPercentage

其值可以为 0、25、50 或 100。例如:

{
  "ThirdPartyOptOutPercentage": 25
}

测试部署

如果您想利用宽限期选择退出,建议您尽快部署 grace-period.json,并将其中一个或两个密钥的值设置为 0。这样,您就可以验证 Chrome 是否按预期处理文件,而不会影响宽限期的激活。然后,当您准备就绪后,就可以开始提高该百分比。未来,我们计划为开发者提供相关工具,供他们查询通过浏览器访问的网站的宽限期激活状态。

grace-period.json 文件的格式必须正确才能生效。为避免错误,请使用宽限期选择退出验证工具检查您的文件。

调试选择停用机制

Google 服务器会定期检查每个存在宽限期的网站上的 grace-period.json 文件(如果存在)。然后,系统可能会将选择停用百分比分发给所有 Chrome 客户端,但此过程可能需要 24 到 48 小时才能完成。Chrome 将提供一个工具,以便网站开发者可以从 Chrome 开发者工具“问题”面板中查看宽限期的激活状态,了解停用功能何时生效。

示例

第三方示例

在以下示例中,third-party.example 已注册第三方弃用试用,并且已为它们激活宽限期。它们将以下文件托管在 third-party.example/well-known/tpcd/grace-period.json:

{
  "ThirdPartyOptOutPercentage": 25
}

此文件就位后,通过 third-party.example 访问网站或服务的 25% 的 Chrome 客户端将停用宽限期。对于受跟踪保护约束的 Chrome 客户端,除非第三方弃用试用正在进行,否则来自 third-party.example 的第三方 Cookie 将受到限制。

第一方示例

在以下示例中,first-party.example 已注册第一方弃用试用,并且已为它们激活宽限期。它们将以下文件托管在 first-party.example/well-known/tpcd/grace-period.json:

{
  "FirstPartyOptOutPercentage": 50
}

此后,访问其网站的 50% 的 Chrome 客户端将停用宽限期。对于所有属于“跟踪保护”组的 Chrome 客户端,第三方 Cookie 都将受到限制

了解详情

如果您对停用机制有任何疑问,请在 Privacy Sandbox 支持代码库中提交问题。