Leading Consent Management Platform

Compliant with GDPR, CCPA, COPPA, LGPD, PECR, PDPA, PIPEDA, and more.

电商、SaaS 和营销网站:按地区集成常用代码

本指南面向网店、SaaS 产品和营销网站。它介绍如何为您网站使用的分析、广告和营销代码设置 UniConsent,使每个代码在欧洲及您访客所在的其他地区都能获得所需的同意。

所需时间: 约 1 小时:第 1 步和第 2 步约需 10 分钟,第 4 步中每个代码需 5 至 10 分钟,第 6 步和第 7 步的测试与检查约需 30 分钟。在控制台发布的更改可能需要几分钟才能在您的网站上生效。

分工: 第 1、3、6、7 步在 UniConsent 控制台和浏览器中完成。第 2、4、5 步需要修改网站代码或 Google Tag Manager,您可能需要网站开发人员的协助。

第 1 步:选择横幅类型

选择 同意类别。访客在四个类别中进行选择,Google Consent Mode 会跟随其选择:

类别涵盖内容示例
1. 严格必要网站运行必不可少的 Cookie,始终开启。购物车、结账、支付、登录、安全
2. 性能 / 分析衡量访客如何使用您的网站Google Analytics 4、Hotjar、Microsoft Clarity
3. 功能功能和个性化在线客服、已保存的偏好、嵌入的视频和地图
4. 定向 / 广告广告、再营销和转化跟踪Google Ads、Meta Pixel、TikTok Pixel、LinkedIn、Pinterest、Microsoft Advertising

如果您的网站也投放程序化广告,或您的广告合作伙伴需要 IAB TCF 或 IAB GPP 信号,请改为选择 IAB TCF Advanced。

第 2 步:首先安装 UniConsent 代码

将 UniConsent 代码添加到 <head> 顶部、所有其他代码之前,使其能在访客的选择确定前暂缓其他代码。请参阅为网站安装 UniConsent 代码。另有 WordPress 插件和 Shopify 应用:请参阅同一页面和为 Shopify 设置 CMP。

如果您在 Google Tag Manager 中管理代码,请改用 Consent Initialization - All Pages 触发器加载 UniConsent CMP 代码。请参阅 Google Tag Manager 的 Consent Mode。

第 3 步:各地区获得的内容

地区访客看到的内容您的代码会怎样
欧洲同意类别横幅代码等待访客的选择。访客同意前 Google Consent Mode 为拒绝。
美国(开启 Show Banner in the US 时)在所有州或您选择的州显示同意类别横幅代码会立即加载,访客可以关闭类别。浏览器发送的 Global Privacy Control 信号会关闭定向或广告类别,直到访客保存选择。
您添加到横幅的其他国家同意类别横幅代码会加载,访客可以关闭类别。
其他所有地区无横幅代码会加载,Google Consent Mode 为授予。

欧洲 包括欧盟、挪威、冰岛和列支敦士登、英国、瑞士,以及阿尔巴尼亚、安道尔、白俄罗斯、波斯尼亚和黑塞哥维那、科索沃、摩尔多瓦、摩纳哥、黑山、北马其顿、圣马力诺、塞尔维亚和乌克兰。

在英国,英国 GDPR 和 ICO 的指引要求在设置非必要 Cookie 前取得同意,因此请将英国保留在您的欧洲地区中:代码会暂缓,直到访客同意。

如果您为某个地区关闭横幅,该地区的访客将被视为网站未安装 CMP:不会显示横幅,也不会屏蔽任何代码或 Cookie。

第 4 步:集成您的代码

有些供应商会自行读取访客的选择,因此您无需屏蔽它们:按常规加载即可,它们会根据选择自动调整。这包括通过 Google Consent Mode 的 Google 代码、通过 Microsoft Consent Mode 的 Microsoft Clarity 和 Microsoft Advertising、通过 UniConsent 同意代码的 Meta Pixel 和 TikTok Pixel,以及通过 Customer Privacy API 的 Shopify。屏蔽它们是可选的:如果您希望它们在同意前完全不加载,Google 代码请使用基本同意模式,其他代码请使用 UnicScript。

代码方法指南
Google Analytics 4、Google Ads 转化和再营销Google Consent Mode。对于欧洲访客,Google 需要 Consent Mode V2 信号才能继续进行转化衡量和再营销。使用高级同意模式时,在每个页面加载这些代码:它们会根据访客的选择调整。Google 代码、Google Tag Manager、Google Consent Mode
Meta Pixel使用 fbq('consent', 'revoke') 暂缓像素,并添加 UniConsent 的 Meta Pixel 同意代码。Meta Pixel
TikTok Pixel使用 ttq.holdConsent() 暂缓像素,并添加 UniConsent 的 TikTok Pixel 同意代码。TikTok Pixel
Microsoft Advertising (UET)、Microsoft ClarityMicrosoft Consent Mode,由 UniConsent 根据访客的选择更新。Microsoft UET、Microsoft Clarity
Shopify 店铺的代码UniConsent 的 Shopify 应用会将访客的选择传递给 Shopify。Shopify
其他分析、客服和营销代码使用对应类别的 UnicScript(见下文)。UnicScript
YouTube 视频、地图和社交媒体嵌入内容UnicScript 占位块,在访客允许该内容前显示提示信息。UnicScript
您无法编辑的代码控制台中的 Tags Loader。Tags Loader

对于页面代码中的其他代码,将代码的 type 设置为 text/unicscript,并添加第 1 步中的类别:

<!-- Performance / Analytics, for example Hotjar -->
<script type="text/unicscript" unic-e-purpose-id="2">
  // your analytics tag code
</script>

<!-- Functionality, for example a live chat widget -->
<script type="text/unicscript" unic-e-purpose-id="3">
  // your chat widget code
</script>

<!-- Targeting / Advertising, for example LinkedIn or Pinterest -->
<script type="text/unicscript" unic-e-purpose-id="4">
  // your advertising tag code
</script>

不要暂缓结账、支付、登录或购物车所需的脚本:它们属于严格必要,必须始终加载。对于 Google Tag Manager 中不读取 Consent Mode 的代码,请参阅第三方 JavaScript 代码集成。

使用 Google Tag Manager

如果您的代码在 Google Tag Manager 中,请使用 UniConsent 发送的同意信号进行设置:

  1. 从社区模板库 添加 UniConsent CMP 代码,输入您的许可证 ID,并使用 Consent Initialization - All Pages 触发器。在该代码的 Consent Mode Default Consent Settings 中,将欧洲(或所有地区)的每种同意类型设为拒绝。请参阅 Google Tag Manager 的 Consent Mode。
  2. 在 管理 > 容器设置 中,开启 启用同意概览。
  3. Google 代码(Google Analytics 4、Google Ads、Floodlight、转化链接器)会自行读取 Consent Mode:保留它们原有的触发器,例如 All Pages。
  4. 其他代码(Meta Pixel、TikTok Pixel、LinkedIn、Hotjar、在线客服插件):将触发器设为名为 unic_data 的自定义事件,UniConsent 会随访客的选择发送该事件。在代码的 高级设置 > 同意设置 中,选择 需要额外同意才能触发代码,并按下表添加其类别对应的同意类型。在 代码触发选项 中,选择 每个网页一次。
  5. 发布 容器,然后打开 预览:Consent 标签页会显示默认值(拒绝)以及访客做出选择后的更新。
类别需要的同意类型
2. 性能 / 分析analytics_storage
3. 功能functionality_storage
4. 定向 / 广告ad_storage

unic_data 会在页面加载时发送,并在每次选择后再次发送,且总在 Consent Mode 更新之后。按此设置的代码会在其同意被授予时立即触发,且每个页面只触发一次。如需对类别设置条件,请参阅第三方 JavaScript 代码集成。

第 5 步:添加隐私设置链接

访客必须能随时更改其选择。请添加隐私设置链接,例如放在页脚:

<a href="#" onclick='__unicapi("openunic");return false;'>Privacy Settings</a>

请参阅为网站安装 UniConsent 代码。

如需保留每位访客的选择记录(例如用于回应数据保护请求),请开启同意日志。

第 6 步:测试每个地区

使用测试位置打开您的网站,然后对 US、USCA(加利福尼亚)及您使用的其他地区重复测试:

https://www.example.com/?uniconsent_test=1&uniconsent_reset=1&uniconsent_geo=EU

请参阅 UniConsent 测试与调试工具。

检查您的代码和 Cookie 是否遵循访客的选择。每次检查都使用无痕浏览窗口,以免沿用之前的选择和 Cookie。

在免费的 Consent Mode Checker 中输入您的网站地址。它会确认您的网站上能检测到 UniConsent,以及您的 Google 代码能收到访客的同意信息。请参阅如何使用 Consent Mode Checker。

在欧洲检查

  1. 使用 EU 测试位置打开您的网站,暂时不要点击横幅。
  2. 点击地址栏左侧的图标,打开该网站的 Cookie 列表。做出选择前,列表中只有严格必要的 Cookie:没有 Google Analytics(_ga)、Google Ads(_gcl_au)、Meta(_fbp)、TikTok(_ttp)或 Hotjar(_hjSessionUser)的 Cookie。
  3. 全部接受。 您的分析和广告代码的 Cookie 现在出现在列表中。
  4. 在新的无痕窗口中打开同一地址并 全部拒绝。分析和广告 Cookie 仍不存在。将商品加入购物车、登录并进入结账:一切仍正常运行。
  5. 重新加载页面。 横幅不再出现,Cookie 仍遵循您的选择。
  6. 打开隐私设置链接,只允许性能 / 分析,并检查是否只出现分析 Cookie。

在美国检查

  1. 使用测试位置 USCA(加利福尼亚)打开您的网站。代码会立即加载。
  2. 打开横幅或隐私设置链接,关闭定向或广告并保存。广告代码停止,分析继续运行。

在控制台中打开项目的 Cookie 列表。Cookie 扫描器每天列出一次在您网站上发现的 Cookie。请检查每个 Cookie 的类别是否正确,并确认没有跟踪 Cookie 被列为严格必要。请参阅管理 Cookie 列表。

供开发人员参考

开发人员可以在浏览器的开发者工具中确认这些信号:

  • 在 网络 中,欧洲访客做出选择前,没有发往 facebook.com/tr 或 analytics.tiktok.com 等广告像素的请求。使用高级同意模式时,Google Analytics 请求(/g/collect)在访客同意前带有 gcs=G100(存储被拒绝),同意后为 gcs=G111。
  • 在 控制台 中,此命令显示当前选择:UNIC_EP_1 至 UNIC_EP_4 即四个类别。
unicUpdate(console.log)

如果某个代码在同意前仍设置 Cookie 或发送请求,说明它是在 UniConsent 控制之外加载的。请在页面代码、Google Tag Manager 或插件中找到它,并按第 4 步进行集成。

常见错误

  • 安装了 CMP 却没有集成您的代码。 横幅会显示,但未集成的代码仍会在同意前加载并设置 Cookie。请按第 4 步集成每个代码,并用第 7 步确认。
  • 设置后未检查供应商的报告。 上线几天后,打开您各代码的报告(例如 Google Analytics、Google Ads 转化和 Meta Events Manager),并与之前几天进行比较。与拒绝访客比例相当的下降属于正常。下降幅度大得多或数据中断,通常意味着某个代码被完全屏蔽或未收到同意信号。控制台中项目的 Insights 会显示有多少访客同意。

还有问题?

联系我们:support@uniconsent.com