Chrome 第三方 Cookie 宽限期的停用机制

Chrome 的第三方 Cookie 宽限期让遇到服务中断问题的网站可以申请更多时间,弃用第三方 Cookie 并改用替代解决方案。符合条件的宽限期参与者可在限定时间内继续访问第三方 Cookie。我们计划至少保持该宽限期,直到我们在 Chrome 中推出全新体验,让用户可以在浏览网页时做出明智的选择。

Chrome 还提供了一种机制,允许网站针对一定比例的 Chrome 客户端选择停用宽限期。选择退出机制将使网站能够进行自己的分阶段发布,从而帮助它们摆脱对宽限期的依赖,以便进行测试并朝着长期解决方案过渡。

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

开发者可以设置 Chrome 标志以停用宽限期,以便在本地测试停用宽限期,但这不适合大规模测试。为了实现生产规模测试,Chrome 提供了一种机制,可让网站针对受 Chrome 跟踪保护机制约束的 Chrome 客户端(该机制会限制 1% 的 Chrome 客户端使用第三方 Cookie)的一定比例,选择停用宽限期。

配置宽限期退订百分比

如需选择停用,您需要在网站的 .well-known 目录 (/.well-known/tpcd/grace-period.json) 中提供可公开访问的配置文件。您可以访问 goo.gle/3pc-lookup,输入您的网站或服务的网址,查看停用配置文件的预期网址。grace-period.json 文件提供了宽限期的用户选择停用百分比:

  • ThirdPartyOptOutPercentage
    作为第三方提供商,您可以为一定比例的 Chrome 客户端(在任何顶级网站上)访问您的嵌入式内容或服务,选择退出宽限期。

  • FirstPartyOptOutPercentage
    作为第一方(顶级网站),对于访问您网站上嵌入内容或服务的一定比例的 Chrome 客户端,您可以选择退出宽限期。只有在顶级网站已进入宽限期时,才会使用此参数,即 goo.gle/3pc-lookup 中的第一方网站模式不是 * 通配符。

这些百分比的值可以是 02550100。例如:

{
  "ThirdPartyOptOutPercentage": 25
}

更改宽限期的选择退出百分比只会影响受 Chrome 跟踪保护机制约束的 Chrome 客户端,但不会影响这些客户端总体上是否启用跟踪保护。

测试部署

如果您想利用宽限期选择退出,建议您尽快部署 grace-period.json,并将其中一个或两个密钥的值设置为 0。这样,您就可以验证 Chrome 是否按预期处理文件,而不会影响宽限期的激活。然后,您可以根据需要逐步提高百分比。开发者可以通过我们的第三方 Cookie 网站兼容性查询工具查询网站的宽限期启用状态。

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

子网域

如以下示例所示,停用范围与注册了宽限期的来源范围相同。停用宽限期功能的操作会应用于已注册的来源及其子网域。

.well-known/tpcd/grace-period.json 配置文件必须托管在已注册宽限期的来源中。

已注册的来源 子网域匹配? 配置文件 停用范围
https://foo.example https://foo.example/.well-known/tpcd/grace-period.json https://foo.example
https://sub.foo.example https://sub.foo.example/.well-known/tpcd/grace-period.json https://sub.foo.example
https://foo.example https://foo.example/.well-known/tpcd/grace-period.json https://*.foo.example

调试选择停用机制

Google 服务器会定期检查每个网站上存在宽限期的 grace-period.json 文件(如果有)。然后,系统会将选择停用功能的百分比分发给所有 Chrome 客户端,不过此过程可能需要 24 到 48 小时才能完成。开发者可以通过第三方 Cookie 网站兼容性查询工具查看宽限期的启用状态,了解停用设置何时生效。

第三方示例

在以下示例中,third-party.example 已注册宽限期。它们在 third-party.example/well-known/tpcd/grace-period.json: 中托管以下文件

{
  "ThirdPartyOptOutPercentage": 25
}

设置此文件后,对于从 third-party.example 访问网站或服务且受跟踪保护功能约束的 1% Chrome 客户端,其中 25% 的客户端将失去宽限期。

第一方示例

在以下示例中,first-party.example 已注册宽限期。它们在 first-party.example/well-known/tpcd/grace-period.json 中托管以下文件:

{
  "FirstPartyOptOutPercentage": 50
}

这项变更实施后,在受跟踪保护功能的 1% 中,有 50% 访问其网站的 Chrome 客户端将停用宽限期。

了解详情

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