对于参加任一第三方 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 开发者工具“问题”面板中查看宽限期的激活状态,了解停用功能何时生效。
示例
第三方示例
在以下示例中,third-party.example
已注册第三方弃用试用,并且已为它们激活宽限期。它们将以下文件托管在 third-party.example/well-known/tpcd/grace-period.json:
{
"ThirdPartyOptOutPercentage": 25
}
此文件就位后,通过 third-party.example
访问网站或服务的 25% 的 Chrome 客户端将停用宽限期。对于受跟踪保护约束的 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 支持代码库中提交问题。