通过试用第三方 Cookie 来申请延长迁移时间

为方便测试,Chrome 已针对 1% 的 Chrome 用户。为了更方便地过渡到第三方 Cookie 处理方式,我们现提供第三方 Cookie 弃用选项 试用 以便嵌入式网站和服务请求更多时间进行迁移 在非广告用例中摆脱第三方 Cookie 依赖性。

此弃用试用的注册流程已于以下周开始: 2023 年 12 月 4 日。弃用试用本身将于 2024 年 1 月开始 的截止日期为 2024 年 12 月 27 日。开发者应做出必要的更改 和方案

我们了解,从弃用和停用这些变更开始 试用注册申请开放,以及 Chrome 协助测试期的开始时间 阻止 1% 的 Cookie。为了解决这些时间限制,Chrome 提供了 参与的源在部署弃用过程中的宽限期 试用令牌在宽限期内, 注册参与弃用试用的源将有权访问第三方 Cookie,即使他们尚未部署令牌也是如此。目的 此宽限期的另一个好处是,在 过渡阶段。参与计划的源必须部署弃用试用令牌 在宽限期结束前更新。

弃用试用

弃用试用是 Chrome 提供的一个标准选项,可让网站 注册更多时间 已移除。弃用试用是一种来源 试用 用于暂时重新启用某项功能。

此试用方案适用于设置第三方 Cookie 的嵌入式及服务,以及 满足以下部分所述的资格条件。也就是说,如果您的嵌入或 服务是第三方,那么您可以注册参与弃用试用, 在您已嵌入代码的所有情境中暂时重新启用第三方 Cookie 或服务试用仅适用于已注册的嵌入式源 而不是用户访问的整个顶级网站网域

第三方/跨网站 iframe 示例,其中显示了
https://top.example 上的 https://embed.example/iframe.html 和
第三方/跨网站脚本示例,显示来自
https://top.example 上包含 https://third-party.example/script.js

使用依赖 Cookie 的第三方的顶级网站无需 注册此弃用试用。您应当审核第三方 Cookie 请与您的第三方提供商联系 以便为弃用做好准备

资格条件和审核流程

此弃用试用与之前的试用不同,它引入了 参与资格审查和审批流程。这是为了实现平衡 包括加强网络用户的隐私性 并在必要时申请额外的迁移时间。

此弃用试用的指导原则如下:

  • 保留用户关键型功能:此弃用试用将 适用于在以下情况中表现出功能损坏的第三方提供商: 用户体验历程
  • 限制用户跟踪:弃用试用不打算支持 出于广告目的进行跨网站跟踪,以及第三方嵌入代码 和用于广告的服务不符合条件。

广告用例的不符合条件也有助于 弃用试用不会干扰为 (如竞争和市场报告中所述) 职权。 这包括同样用于非广告用途的广告相关网域 目的。

Chrome 最初会使用 Disconnect.me(一种 互联网隐私保护领域的业界领导者,并实现 Disconnect 的跟踪器 以识别被归类为广告的脚本和网域。 已在网络上有其他浏览器将断开连接用于类似用途。

我们将按照以下流程提交注册申请:

  • 如果第三方来源与某个已知的广告网域匹配,包括: 该来源与“取消关联”广告中的条目匹配 列表, 那么注册请求将被拒绝。一般来说, 该列表将匹配指定源下的所有子网域。部分 但条目中含有路径元素。这些更具体的条目 与指定来源匹配,但与子网域不匹配。
  • 必须提供相关步骤来重现不畅的用户体验。在 具体而言,这应该是为操作设备用户提供的体验 Cookie 的存储位置,而不是用户以后对 数据。如果我们无法验证用户体验不佳,则注册 请求会被拒绝
  • 否则,注册请求将获得批准
  • 如果您声明某个来源为“类似”之前批准的应用 用于说明源站之间的关系。

我们计划提供申诉流程,以便登记来源认为 信息可以阐明审核决定。注册人可以申请 在源试用控制台中重新申请提出申诉。申诉的目的是 因缺少请求的信息而遭拒(已知的中断错误) 和/或中断重现步骤),以及/或者注册源认为 信息可以满足这些要求,从而阐明审核决定。

我们还批准反滥用和反欺诈用例, 证实证据欢迎就如何更好地评估这些使用情形提供反馈

申请弃用试用

添加重现步骤,以便我们的团队验证 出现故障或者,如果这样更简单,并且/或您的功能受制于 您可以提供操作步骤录音的链接 使用 Chrome 开发者工具重现问题 录音机

  1. 转到第三方 Cookie 试用 弃用 然后点击“注册”。
  2. 对于“Web 源”,请提供提供嵌入页面的来源或 脚本。
  3. “第三方匹配”取决于您需要以何种方式提供 令牌。如需详细了解这些选项,请参阅添加实验轮次 令牌
    • 如果您要自行在 HTTP 标头或元标记中提供令牌 嵌入式网页中,请勿选中“第三方匹配”。
    • 如果您通过 JavaScript 将令牌注入其他网站, 必须选中“第三方匹配”。
    • 如果您需要同时执行这两项操作,则需要单独注册。
  4. 如果您在多个子网域中托管跨网站内容,请检查 选项“我需要一个令牌来匹配源的所有子网域。”
    • 选择此选项后,提供的令牌将与网域匹配 及其下属的网域例如:将 https://example.com 注册到 匹配“example.com”、“www.example.com”、“foo.example.com”和 bar.foo.example.com如果您注册了 https://www.example.com,您的令牌将 将与 www.example.comfoo.www.example.com 匹配,但不会匹配 foo.example.com
    • 令牌匹配多个子网域的方式与通配符匹配类似, 例如 *.<domain>。为 example.com 请求一个令牌,该令牌可以是 提供日期:a.example.com,内容:b.example.com。第三方 Cookie 访问 但系统仍然只会为提供 令牌,而不是所有子网域。请参见启用 Cookie 时 子网域匹配为 ?
    • 如果您将跨网站内容托管在非 则需要单独注册 每个源站。
  5. 确认“披露和确认”中包含的所有条件作者: 选中所有复选框
  6. 提交申请。
  7. 我们需要更多信息才能处理您的请求。你将获得 电子邮件通知,其中包含自动生成的工单,要求提供 以下:
    • 与您请求的源关联的子网域数量
    • 关联的第三方中断存储库 bug 的 bug ID 或链接 是之前报告给 goo.gle/report-3pc-broken
    • 与您遇到的服务中断情况/使用情形有关的任何其他信息/背景信息 (在针对审判遭拒提出申诉的情况下 请说明您的来源为何/如何符合所列的条件 )。

提交后,我们会审核您的申请,并在审核完成后通知您 或是否需要其他信息,以及您的请求是否处于 批准或拒绝。您还会收到 结果。如果申请获批,您就可以根据需要继续提供试用令牌。 如果被拒,您可以按照请求工单中的指导操作。

设置用于测试的标志

目前,我们建议您设置以下标志(Chrome 123 中提供), 以便进行有效的测试。这种标志设置组合有助于 模式 B 用户体验。

  • chrome://flags/#third-party-cookie-deprecation-trialenabled
    这是默认设置。允许参与试用。

  • chrome://flags/#tracking-protection-3pcdenabled
    开启跟踪保护: 在地址栏中显示眼睛图标界面 用户暂时为网站启用第三方 Cookie,并提供 chrome://settings/trackingProtection,而不是 chrome://settings/cookies。

  • chrome://flags/#tpcd-metadata-grantsdisabled
    让 Chrome 假定宽限期未生效。这可用于 检查您的网站是否已正确部署弃用试用令牌, 宽限期结束(针对处于宽限期的网站)。

  • chrome://flags/#tpcd-heuristics-grantsdisabled
    不允许使用基于启发法的缓解措施。这有助于测试 在不使用第三方 Cookie 的情况下,长期修复 可以按预期运行, 启发式缓解措施,以及参与弃用试用计划的效果 符合预期。

如果您需要手动测试宽限期是否按预期运行, 测试部署之前,你需要启用 chrome://flags/#tpcd-metadata-grants,而不是停用。

添加试用令牌

请参阅 Origin 使用入门 试用第三方来源 试用、 和排查 Chrome 源问题 试用 了解详情。

您应在所有要设置的网页响应中添加试用令牌 或在跨网站环境中发送 Cookie。

在 HTTP 标头中提供令牌

如果您需要为 跨网站 iframe,您可以在网页中添加 Origin-Trial HTTP 标头 回答:

Origin-Trial: TOKEN_GOES_HERE

这相当于不启用“第三方匹配” 测试注册,因为您在自己的响应中提供令牌。

网页响应可以设置 Cookie。向同一来源发出后续请求后 例如该页面中的子资源或该页面的导航元素 网站的跨网站 Cookie,还可能会设置 Cookie。

此示意图,用于重申页面响应中提供的令牌。

如果您需要在 会话,那么您还可以使用 Critical-Origin-Trial 标头传递 试验名称:

Critical-Origin-Trial: Tpcd

这会导致浏览器使用第三方 Cookie 重试请求 。

弃用试用以永久试用的形式提供,也就是说,一旦 浏览器收到令牌后,系统会应用试用行为 直到加载 iframe 且未提供试用令牌为止。建议 每次加载 iframe 时始终发送试用令牌。

在元标记中提供令牌

在网页中,您可以在文档 <head> 中使用元标记:

<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">

该元标记将为后续请求或 JavaScript,但如果需要,您需要使用 HTTP 标头 现有 Cookie。

使用 JavaScript 注入令牌

是否需要在之前或之后为源启用第三方 Cookie 例如,如果网页需要使用 Cookie 跨网站图片请求,或者您打算使用 JavaScript 创建 iframe,则 您可以使用 JavaScript 将令牌注入顶级网站:

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

为此,您必须启用“第三方匹配” 测试注册,因为您为源(即 第三方)复制到其他网站。

启用了第三方匹配的令牌可以在任何源上注入, (包括您自己的资源),一切都行得通。

该示意图重申了第三方脚本在
父级页面。

如果在不使用 测试令牌。您必须始终在加载的所有 iframe 上提供试用令牌 即使试用最初是通过第三方脚本加载启用的,也是如此。

验证您的令牌

打开 Chrome DevTools,选择 Application 面板,然后展开 Frames 标签。 在以下情况下,选择任意帧都将显示“源试用”部分: 任何令牌。如果您要将令牌注入顶级 您会在网站“顶部”看到条目。否则,您应选择 与嵌入网页对应的框架。

在“源试用”部分,如果您已提供令牌,您应该会看到 “Tpcd”的条目如果此操作已成功启用该功能,您会看到 绿色“已启用”状态。否则,您会看到红色的错误状态, 展开该条目即可查看问题。

您只需提供一个有效的令牌即可激活弃用试用。如果您有 同时注册了第一方匹配和第三方匹配,但如果存在以下情况,则不会引发问题: 您需要在网页中提供这两个令牌。例如,如果您有一个网页 则不需要动态地 选择令牌:您可以同时提供这两种令牌,系统会在 两种上下文。

启用了哪些 Cookie?

弃用试用仅会为来源启用第三方 Cookie 已申请参与试用。启用后,将会有第三方 Cookie 发送到该源的 iframe 和子资源请求第三方 Cookie 还会 也可在具有该源的 iframe 中通过 document.cookie 提供。

此处未考虑 Cookie Domain 属性。仅请求网址来源 。一旦 Google 确定您的要求包含第三方 Cookie, 即使 Cookie 的域名 宽容模式。

例如,如果 https://one.test.example 已注册,其令牌为 https://one.test.example iframe 中提供的:

  • https://one.test.example/image.jpg 将接收通过 https://one.test.example
  • https://one.test.example/image.jpg将接收其他方设置的 Cookie Domain=.test.example的源站
  • https://test.example/image.jpghttps://two.test.example/image.jpg 请求将不会接收第三方 Cookie,因为它们 same-origin。

启用子域名匹配后,会启用哪些 Cookie?

“匹配所有子网域”选项允许将一个令牌用于 注册来源或具有更具体的子网域的任何来源。令牌 具有子网域匹配的https://test.example可用于激活试用 使用 https://test.examplehttps://one.test.examplehttps//two.test.example iframe 和第三方脚本加载。

此外,启用子网域匹配后,第三方 Cookie 也会 可在与相应 子网域。例如,如果 https://test.example 使用子网域匹配, 像https://cdn.one.test.example/image.jpg这样的子资源请求 第三方 Cookie。

试用停用时不考虑子网域匹配。停用 试用 iframe 必须与注册中的来源完全匹配 未使用令牌加载。因此,使用https://test.example 子网域匹配只能通过 https://test.example iframe 停用 没有令牌。这种情况以后可能会发生变化,因此我们建议您提供 (如果您想启用试用并移除) 令牌。

试用令牌问题排查

排查 Chrome 源问题 试用 提供了全面的核对清单,可帮助您调试试用令牌的注册和部署。

您在试用期间可能会遇到以下常见问题:

  • 使用“我需要一个令牌来匹配源站的所有子网域”。选项,提供的令牌将与注册的域名及其下面的域名匹配。例如:注册 https://example.com 以匹配 example.comwww.example.comfoo.example.combar.foo.example.com。如果您注册了 https://www.example.com,则您的令牌将匹配 www.example.comfoo.www.example.com,但不会匹配 foo.example.com
  • 您网站上嵌入的第三方网站或服务需要自行注册试用。请勿申请不归您控制/拥有的域名。
  • 如果您在源试用注册时出错,则必须重新注册才能更正错误并获取新令牌。

常见问题解答

  1. 如果我对 Disconnect.me 有疑问,该怎么办? 列表?
  2. 如果我的域名同时用于以下两个方面,我可以注册参与弃用试用吗? 广告和非广告目的?
    • 用于广告的第三方嵌入内容和服务不符合条件 适用于弃用试用,原因在本博客中说明 。这包括同样使用的广告相关网域 用于非广告目的。有关详情,请参阅资格要求 标准和审核流程 部分。
  3. 网站能否看到哪些合作伙伴已注册 弃用试用?他们能否限制其 合作伙伴?
    • 是的,网站可以查看哪些嵌入和服务依赖于 弃用试用令牌。 请参阅对 Chrome 源进行问题排查 试用
    • 顶级网站将无法限制其 合作伙伴或其网页上的嵌入内容和服务。与合作伙伴联系 如果需要的话
  4. 此试验与 User-Agent 等其他试验有何不同 源试用?
    • 此弃用试用的主要不同之处在于新的注册 包括满足参与条件,以及新的 源试用控制台中的界面和页面。
    • 第二个不同之处在于 第三方嵌入式网站来解决所面临的最大 多个网站/服务客户端之间的兼容性问题。
  5. 是否会针对第三方 Cookie 提供第一方弃用试用 弃用了顶级网站可以注册以便为其启用第三方 Cookie 该怎么办?
  6. 审核我的弃用试用申请需要多长时间?在哪里可以 我查看自己的申请状态了吗?
    • 回复时间可能会有所不同;建议您开始注册 流程,确保您为第三方变更做好准备。如果您尚未收到任何 在提交注册后的 1-2 周内收到回复,请联系 3pcd-deprecationtrial@google.com
    • 关于待解决对话、决策状态和理由的 bug 会话。
  7. 我们的弃用试用注册已获得批准,并部署了 试用令牌。不过,弃用试用期并不像 符合预期。我们该怎么做?