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

对于参与 第三方 Cookie 弃用试用 Chrome 提供了一种 宽限期 暂时重新启用第三方 Cookie。在宽限期内,网站可以 在 Chrome 中访问第三方 Cookie,即使这些 Cookie 尚未部署试用版 词元。

Chrome 还提供了允许网站选择退出宽限期的机制 特定时间段停用机制 他们自己的分阶段发布,帮助他们不再依赖 以便测试弃用试用令牌部署,并逐步实现 长期解决方案。

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

当网站或服务获准 第一方第三方 弃用试用,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 的“Issues”面板查看激活状态,以了解 。

示例

第三方示例

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

{
  "ThirdPartyOptOutPercentage": 25
}

设置此文件后,宽限期将在 用于访问网站的 Chrome 客户端 third-party.example的服务或服务。适用于受制于 跟踪保护、 来自 third-party.example 的第三方 Cookie 将受到限制,除非 处于第三方弃用试用阶段。

第一方示例

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

{
  "FirstPartyOptOutPercentage": 50
}

实施这项设置后,系统将停用 50% 的 Chrome 用户的宽限期 客户。这些 Chrome 浏览器客户端 跟踪保护组,第三方 Cookie 将受到限制

了解详情

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