针对第三方 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 开发者工具的“Issues”(问题)面板中检查宽限期激活状态,了解选择停用的生效时间。

示例

第三方示例

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

{
  "ThirdPartyOptOutPercentage": 25
}

此文件实施后,对于通过 third-party.example 访问网站或服务的 Chrome 客户端,其宽限期将有 25% 停用。对于受跟踪保护约束的 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 支持代码库中提交问题。