Google Consent Mode（同意模式）

这份文档的核心目的是：指导 WordPress 网站管理员如何在使用 Site Kit 插件时，正确地处理用户同意（尤其是Cookie同意），并让 Site Kit 与网站的同意管理平台（CMP）进行通信，以遵守像 GDPR 这样的数据隐私法规。

---

核心概念解读

1. 什么是 Consent Mode（同意模式）？

Consent Mode 是 Google 推出的一套 API，允许网站在不依赖Cookie的情况下，向 Google 的产品（如 Google Analytics, Google Ads）传达用户的同意选择。

• 传统方式：如果用户拒绝分析Cookie，网站通常会完全阻止加载 Google Analytics 脚本。这意味着你将失去所有来自该用户的数据，包括匿名化的聚合数据。
• Consent Mode 方式：即使被拒绝，Google 标签仍然会加载，但它们的行为会根据用户的同意状态而改变。它会发送“无Cookie”的ping，帮助您进行转化建模、获取关键的聚合流量数据，同时尊重用户的选择。

2. 什么是 wpConsentAPI？

wpConsentAPI 是 WordPress 生态系统中的一个标准化编程接口。它旨在解决一个普遍问题：

WordPress 有成千上万个主题和插件，它们都可能需要处理用户同意。如果每个插件都用自己不同的方式去检测用户的同意状态，那将是一片混乱，且极易出错。

wpConsentAPI 就像一个“翻译官”或“中间人”：

• 对同意管理平台（CMP）：它提供了一个标准的方法来宣布用户的同意状态（例如，“分析”类别被同意，“广告”类别被拒绝）。
• 对其他插件（如 Site Kit）：它提供了一个标准的方法来读取用户的同意状态。

这样，只要您的同意管理插件（CMP）和 Site Kit 都支持这个标准，它们就能自动协作，无需进行复杂的自定义集成。

---

文档内容分步解读

第一步：检查您的设置

文档建议您首先确认两件事：

1. 您有一个同意管理平台（CMP）：例如 Cookiebot、Complianz、Cookie Yes 等。或者您的主题自带的同意弹窗。
2. 您的 CMP 支持 wpConsentAPI：这是关键。您需要查阅您所用 CMP 的文档，确认它已经实现了这个API。

如果您的 CMP 不支持 wpConsentAPI，那么 Site Kit 将无法自动感知用户的同意选择。

第二步：如何实施（两种场景）

文档清晰地指出了两种不同的情况：

场景 A：您的 CMP 已经支持 wpConsentAPI

• 您需要做什么：几乎什么都不用做！
• 工作原理：
  1. 用户访问您的网站，CMP 弹窗询问同意。
  2. 用户做出选择（同意或拒绝）。
  3. CMP 自动通过 wpConsentAPI 将这个状态（如 'analytics': 'allow' 或 'analytics': 'deny'）广播给整个网站。
  4. Site Kit 插件一直在“监听”这个API。一旦接收到状态，它就会自动配置其内部的 Google 标签，使其遵循 Consent Mode 的行为。
  5. 数据会根据同意状态，以符合规范的方式发送给 Google。

场景 B：您的 CMP 不支持 wpConsentAPI

• 您需要做什么：手动编写代码来桥接两者。 这需要一定的技术能力。
• 操作方法：您需要在您的主题的 functions.php 文件或一个自定义插件中添加代码。
• 代码的逻辑是：
  1. 监听您 CMP 的同意状态变化：当用户点击同意或拒绝时，您的 CMP 很可能有自己的 JavaScript 事件或函数被触发。
  2. 将状态“翻译”成 wpConsentAPI 能懂的语言：在您监听到CMP的事件后，您需要手动调用 wp_set_consent 这个函数，来更新标准化的同意状态。
  文档中的代码示例：javascript// 当您的CMP的同意状态改变时 wp_set_consent(‘analytics’, ‘allow’); // 或者 ‘deny’您需要将这段代码与您CMP的具体事件挂钩。例如，如果CMP在同意时触发 my_cmp_did_consent 事件，您的代码就会是：javascriptdocument.addEventListener(‘my_cmp_did_consent’, function() { wp_set_consent(‘analytics’, ‘allow’); });

第三步：验证实施是否成功

文档推荐使用 Google Tag Assistant 这个浏览器扩展来检查。

• 成功迹象：当您拒绝分析Cookie后，刷新页面，在 Tag Assistant 中您应该看到 Google Analytics 标签仍然在加载，但其旁边会有一个“同意模式”的指示器，并且发送的请求中会包含 gdpr=0 等参数。这表明 Consent Mode 正在工作，GA 知道它不能使用Cookie。

---

总结与要点

1. 目的：为了在遵守隐私法规的前提下，最大化数据收集的价值。
2. 核心机制：wpConsentAPI 是连接 WordPress 网站 CMP 和 Site Kit（及其他插件）的标准化桥梁。
3. 行动指南：
   • 首选：选择一个原生支持 wpConsentAPI 的同意管理插件（CMP）。这是最省事、最可靠的方法。
   • 备选：如果当前的 CMP 不支持，您需要手动编写代码进行集成。
   • 错误做法：完全忽略这个问题，导致 Site Kit 在未经同意的情况下设置非必要的Cookie，这可能会违反法律。
4. 对用户的价值：用户拥有选择权，他们的隐私决定得到尊重。对网站主的价值：即使在被拒绝的情况下，仍能通过 Consent Mode 获得有价值的、匿名的洞察。