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