跳转到内容
搜索文档

Google Consent Mode

最后更新 查看 MarkdownAgent 设置

背景

Google Consent Mode 由 Google 工具用于管理有关使用私人数据和个人身份信息 (PII) 的同意。Zaraz 提供对 Consent Mode v2 的自动支持,以及对 Consent Mode v1 的手动支持。

你也可以通过选择 **Permissions(权限)**并禁用 Access client key-value store(访问客户端键值存储),在不使用 cookie 的情况下使用 Google Analytics 和 Google Ads。


Consent Mode v2 指定通常在会话开始时设置的“默认”同意状态,以及在访问者配置其同意偏好时设置的“更新”状态。当正确的事件属性可用时,Consent Mode v2 将自动开启,这意味着无需更改相应工具或其操作中的任何设置。

设置默认同意状态

网站通常希望设置拒绝所有类别的默认同意状态。你无需任何代码即可完成此操作,方法是在 Zaraz **Settings(设置)**页面中勾选 Set Google Consent Mode v2 state(设置 Google Consent Mode v2 状态)

如果这不是你的网站所需的,而是希望以更细粒度的方式设置默认同意状态,请使用保留的 google_consent_default 属性:

zaraz.set("google_consent_default",  {
  'ad_storage': 'denied',
  'ad_user_data': 'denied',
  'ad_personalization': 'denied',
  'analytics_storage': 'denied'
})

执行上述代码后,同意状态将保存到 localStorage,并包含在每个后续 Zaraz 事件中。

请注意,该代码应作为网站 HTML 代码的一部分包含,通常位于 <body> 元素内的 <script> 元素中。不建议使用 Custom HTML Zaraz 工具来包含它,因为应在 Zaraz 加载任何其他工具之前指定同意偏好。

更新同意状态

用户提供其同意偏好后,你可以使用保留的 google_consent_update 属性设置新状态。如果你使用 Zaraz Consent Management Platform,可以使用 Consent Choices Updated 事件 来了解何时更新 Google Consent 状态。

zaraz.set("google_consent_update",  {
  'ad_storage': 'granted',
  'ad_user_data': 'denied',
  'ad_personalization': 'granted',
  'analytics_storage': 'denied'
})

所有后续事件都将包含有关默认同意状态和更新后同意状态的信息。

你可以通过启用 Zaraz Debugger 来验证 Zaraz 是否正在处理 Consent Mode 设置。对 Google Analytics 和 Google Ads 的服务器端请求应包含 gcd 参数。

Consent Mode v1 已于 2023 年 11 月被 Google 弃用,但仍受支持。与 Zaraz 的集成比 Consent Mode v2 更复杂。如果你已实现 Consent Mode v2,则无需使用 Consent Mode v1。

配置 Consent Mode v1 需要为每个工具手动完成。前往工具页面并选择 Settings(设置)。选择 Add field(添加字段),然后从下拉菜单中选择 Consent Mode(同意模式)。然后选择 Confirm(确认)

Consent Mode 的值必须遵循 Google 定义的格式,即一个以 G1 开头的四字符字符串,后跟两个字符,分别表示 Marketing 和 Analytics 的同意状态。1 表示同意,0 表示不同意,- 表示不需要同意。例如,将值设置为 G111 表示用户已为 Marketing 和 Analytics 授予同意,G101 表示仅同意 Analytics,G10- 表示不同意 Marketing,但对 Analytics 不需要同意。

由于 Consent Mode 的值可能因用户或会话而异,建议在网站代码中使用 zaraz.set 动态设置此值。例如,在页面加载时使用 zaraz.set("google_consent_v1", "G100"),在用户为 Marketing 和 Analytics 授予同意后使用 zaraz.set("google_consent_v1", "G111")。在 **Consent Mode(同意模式)**字段中,选择 + 符号,选择 Event Property(事件属性),并将属性名称键入为 google_consent_v1。Zaraz 将使用 google_consent_v1 Event Property 的最新值作为 Consent Mode 字符串。

支持的工具

Consent Mode v1 和 v2 均受 Google Analytics 4 和 Google Ads 支持。

这篇文档对您有帮助吗?