对于参与 第三方 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 支持代码库。