对于参与第三方 Cookie 弃用试用计划的网站,Chrome 为其提供了暂时重新启用第三方 Cookie 的宽限期。在宽限期内,即使网站尚未部署试用令牌,也可以在 Chrome 中访问第三方 Cookie。
Chrome 还提供了一种机制,可让网站为一定比例的用户选择退出宽限期。通过选择停用机制,网站可以运行自己的分阶段发布,以帮助网站摆脱对宽限期的依赖,从而测试弃用试用令牌部署并转向长期解决方案。
开发者为何需要拒绝联系机制
网站或服务获准进行第一方或第三方弃用试用后,Chrome 会提供试用令牌并启动宽限期,以便为令牌部署留出时间。宽限期会一直有效,直到其过期,即使在部署令牌后也是如此。这在测试弃用试用令牌部署是否成功时可能会出现问题。
开发者可以设置 Chrome 标志以停用宽限期,从而在本地测试令牌部署,但这不适合大规模测试。为了使网站能够部署生产测试令牌,Chrome 现在提供一种机制,可以为一定比例的用户选择退出宽限期。
配置宽限期内的选择停用百分比
如需选择退出,请在您网站的 .well-known
目录 (/.well-known/tpcd/grace-period.json
) 中提供一个可公开访问的配置文件。grace-period.json
文件提供针对其中一个或两个弃用试用宽限期的选择停用百分比:
FirstPartyOptOutPercentage
ThirdPartyOptOutPercentage
这些键的值可以为 0、25、50 或 100。例如:
{
"ThirdPartyOptOutPercentage": 25
}
测试部署
如果您想在宽限期内选择停用,我们建议您首先尽快部署 grace-period.json
,并将其中一个密钥或两个密钥的值设置为 0
。这样,您就可以验证 Chrome 是否按预期处理文件,而不会影响宽限期的激活。准备就绪后,您可以开始增加该百分比。未来,我们计划为开发者提供工具,以便他们查询其浏览器所访问的网站的宽限期激活状态。
grace-period.json
文件必须采用正确的格式才能生效。为避免出错,请使用宽限期选择停用验证工具检查您的文件。
调试拒绝联系机制
Google 服务器会定期检查处于宽限期的每个网站上的 grace-period.json
文件(如果存在)。然后,系统便会将选择停用百分比分发给所有 Chrome 客户端,但此过程可能需要 24 到 48 小时才能完成。Chrome 将提供一个工具,以便网站开发者可以从 Chrome 开发者工具的“Issues”(问题)面板中检查宽限期激活状态,了解选择停用的生效时间。
示例
第三方示例
在以下示例中,third-party.example
已注册第三方弃用试用,并且为其启用了宽限期。他们将以下文件托管在 third-party.example/well-known/tpcd/grace-period.json:
上
{
"ThirdPartyOptOutPercentage": 25
}
此文件实施后,对于通过 third-party.example
访问网站或服务的 Chrome 客户端,其宽限期将有 25% 停用。对于受跟踪保护约束的 Chrome 客户端,来自 third-party.example
的第三方 Cookie 将受到限制,除非第三方弃用试用处于活跃状态。
第一方示例
在以下示例中,first-party.example
已注册第一方弃用试用版,并且为其启用了宽限期。他们将以下文件托管在 first-party.example/well-known/tpcd/grace-period.json:
上
{
"FirstPartyOptOutPercentage": 50
}
实施这项政策后,系统将为访问其网站的 50% 的 Chrome 客户端停用宽限期。凡是加入跟踪保护组的 Chrome 客户端 都会限制使用第三方 Cookie
了解详情
如果您对拒绝联系机制有任何疑问,请在 Privacy Sandbox 支持代码库中提交问题。