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

对于参与第三方 Cookie 弃用试用的网站,Chrome 会提供宽限期,以便暂时重新启用第三方 Cookie。在宽限期内,即使网站尚未部署试用令牌,也能在 Chrome 中访问第三方 Cookie。

Chrome 还提供了一种机制,允许网站针对部分用户选择停用宽限期。通过停用机制,网站可以运行自己的分阶段发布,以帮助它们从依赖宽限期过渡,从而测试弃用试用令牌的部署,并逐步转向长期解决方案。

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

当网站或服务获得第一方第三方 Cookie 弃用试用计划的批准后,Chrome 会提供试用令牌并启动宽限期,以便您有时间部署令牌。宽限期将继续 在令牌到期之前始终有效,即使在部署令牌之后也是如此。这可以 在测试系统是否已部署弃用试用令牌 成功。

开发者可以设置 Chrome 标志以停用宽限期,以便在本地测试令牌部署,但这不适合大规模测试。为了支持网站对令牌部署进行生产测试,Chrome 现在 提供一种机制,供用户选择退出 用户。

配置宽限期内用户选择停用服务的百分比

要参与“选择停用”页面,请提供可公开访问的配置 文件(位于 .well-known 网站目录 (/.well-known/tpcd/grace-period.json)。通过 grace-period.json 文件提供针对上述任一或二者的拒绝联系百分比 弃用试用宽限期:

  • FirstPartyOptOutPercentage
  • ThirdPartyOptOutPercentage

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

{
  "ThirdPartyOptOutPercentage": 25
}

更改宽限期选择停用百分比不会影响受 Chrome 跟踪保护机制约束的 Chrome 客户端比例,该机制会限制 1% 的 Chrome 客户端使用第三方 Cookie。

例如,如果将某网站的宽限期设置为 50%, 那么 0.5% (1% * 50%) 的 Chrome 客户端将会限制第三方 Cookie 。

测试部署

如果您想利用宽限期选择退出,我们建议您: 首先尽快部署 grace-period.json,值为 0 一个或两个键这样,您就可以验证 Chrome 是否按预期处理文件,而不会影响宽限期激活。然后,您可以根据需要开始提高百分比。未来,我们计划 为开发者提供相关工具,供他们查询 用户的浏览器访问的网站

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 小时 操作完成。Chrome 将提供一款工具,以便网站开发者通过 Chrome DevTools 中的“问题”面板查看宽限期激活状态,了解停用功能生效的时间。

示例

第三方示例

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

{
  "ThirdPartyOptOutPercentage": 25
}

添加此文件后,系统会为通过 third-party.example 访问网站或服务的 25% Chrome 客户端停用宽限期。对于受跟踪保护功能约束的 Chrome 客户端,除非第三方 Cookie 弃用试用版处于有效状态,否则系统会限制来自 third-party.example 的第三方 Cookie。

第一方示例

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

{
  "FirstPartyOptOutPercentage": 50
}

这样一来,对于访问其网站的 Chrome 客户端,50% 的客户端将无法享受宽限期。这些 Chrome 浏览器客户端 跟踪保护组,第三方 Cookie 将受到限制

了解详情

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