跳到正文
Stape Server-Side Tracking Blog·· 3 天前精选AI 评分75

Stape 详解 Shopify Cookie 授权横幅 CMP 配置与调试方法

Shopify cookie banner: Stape's CMP setup and debugging

AI 导读

Stape 针对 Shopify 独立站发布 CMP 配置与调试实操指南,解决原生 Cookie 横幅无法覆盖 GA4 等第三方工具及授权状态无法同步至结账页的痛点。

推荐理由

针对独立站店面与结账页授权状态脱节问题,梳理了服务端追踪环境下对接 Customer Privacy API 的实操排查路径。

正文 · AI 翻译

核心要点

  • Cookie 横幅用于收集访客的授权选择;而 CMP(同意管理平台)不仅能存储和管理这些偏好设置,还会将其同步至第三方工具,并依此控制后续的数据追踪。

  • Shopify 自带的 Cookie 横幅只能管理平台自有工具的授权;如果你同时在使用 GA4、Google Ads、Meta 等第三方工具,仅靠自带横幅就远远不够了。

  • Shopify 商家在同意管理上面临诸多挑战,比如 CMP 与 Shopify 之间的授权状态不同步,以及授权信息无法传递至结账页面等。

  • Stape 的 CMP 通过集成 Shopify 客户隐私 API(Customer Privacy API)、部署自定义加载器(Custom Loader)以及支持 Google Consent Mode v2,有效化解了这些痛点。

  • 将 Stape 的 CMP 与服务端追踪结合使用,不仅能提升数据采集质量、加强对共享数据的控制,还能减少访客浏览器中运行的第三方脚本数量。

  • 若要在网站上正确配置同意管理,还需要配置相关集成项与 GTM 标签,选择合适的授权设置,并在 GTM 和 Shopify 结账页面上充分测试授权信号。

🤔 本文适合哪些读者? 本文适合正在为店铺主页及结账页面的 Cookie 授权管理而困扰、急需 CMP 配置与调试指南的 Shopify 店主、数据追踪专家及营销人员。

Shopify Cookie 横幅是向访客展示的提示信息,主要说明店铺如何使用 Cookie 及其他追踪技术,访客可通过它接受、拒绝或管理自己的隐私偏好。

同意管理平台(CMP)则是一套更全面的用户授权解决方案。它不仅收集并存储访客的授权选择,还会将这些设置同步应用到网站配置的各项脚本与集成工具中。

换句话说,Cookie 横幅只是 CMP 的一部分。CMP 不仅包含横幅本身,还提供了管理用户授权所需的整套技术功能。

Shopify Cookie 横幅Shopify CMP
向访客展示授权提示管理完整的授权流程
允许访客接受或拒绝 Cookie存储并管理授权偏好
提供修改 Cookie 偏好的途径将授权选择同步至第三方工具
集成选项可能较为有限支持集成分析平台、广告平台及隐私合规平台

Shopify 已在其客户隐私设置中内置了 Cookie 横幅,可管理 Shopify 专属工具(如 Shopify Cookie 和 Pixel)的授权。但如果你在网站上配置了第三方脚本和 Pixel,则需要额外配置才能遵循访客的选择。

如果你使用了 Google Analytics、Google Ads、Meta Pixel、TikTok Pixel 等多种追踪与广告工具,就需要对授权数据的收集、存储和共享拥有更细致的掌控权。此时,配置 CMP 是管理用户授权的必要手段。CMP 能将授权横幅与各类追踪工具打通:当访客在 Cookie 横幅中做出选择后,CMP 会将数据传递给已配置的平台,并在需要授权的场景下阻止非必要的追踪行为。

当网站使用的 Cookie 或类似追踪技术受到隐私法规的授权要求约束时,就必须配置 Shopify Cookie 授权横幅。这主要取决于网站访客所在地区以及店铺使用的 Cookie 类型。

例如,如果你的 Shopify 店铺面向欧盟(EU)或欧洲经济区(EEA)的用户,数据追踪与处理就必须符合 GDPR 和《电子隐私指令》(ePrivacy)的规定。这些法规要求,在植入非必要 Cookie(即广告、分析和追踪等维持网站基本运行所非必需的 Cookie)之前,必须先征得访客同意。对于英国访客,英国版 GDPR 和 PECR 也有相同的原则要求。

而在美国部分州,你可能需要向访客提供退出(opt-out)出售、共享个人信息或定向广告的途径。美国知名度最高的几部地方法规包括:

  • 《加州消费者隐私法》(CCPA)——赋予加州居民退出出售或共享其个人信息的权利,其中也涵盖用于跨语境行为广告的共享。

  • 《科罗拉多州隐私法》(CPA)与《康涅狄格州数据隐私法》(CTDPA)——赋予两地居民退出个人数据出售及用于定向广告的权利。

相比其他平台,Shopify 上的追踪与知情同意管理要更复杂。在评估各类 Shopify Cookie 授权横幅方案时,除了看提示弹窗的外观,更要考察它如何处理系统集成与同意信号。以下是几项值得关注的核心功能:

✅ 集成 Shopify Customer Privacy API。CMP(知情同意管理平台)应能将访客的授权偏好与 Shopify 自身的隐私设置实时同步。

✅ 支持 Google 同意模式 v2(Google Consent Mode v2)。如果你在使用 Google Analytics 或 Google Ads,CMP 必须能把对应的授权信号传递给 Google 代码标签。

✅ 第三方脚本拦截控制。重点看方案是否能在获得必要授权前,自动拦截非必要脚本,以及是否需要你手动逐个配置脚本。

✅ 与现有追踪方案打通。如果你接入了 GTM、配置了服务端追踪或对接了广告平台,务必确保 CMP 能把用户的授权选择同步给这些工具。

✅ 符合适用的隐私法规。确保该方案全面支持适用于你的网站及受众的各项隐私法规。

✅ 授权日志留存。优先选择支持存储和查阅授权互动记录的平台,方便排查配置问题或留存合规凭证。

✅ 支持退出(Opt-out)机制。如果你的店铺面向美国受众,需确认该方案是否支持全球隐私控制(GPC)和 IAB 全球隐私平台(GPP)等主流退出信号与框架。

你真的需要安装 Shopify Cookie 横幅应用吗?

在 Shopify 应用商店里能搜到各种各样的 Cookie 横幅 App。它们可以帮你展示授权提示、收集访客的隐私偏好,并为分析和广告工具管理授权状态。

但这类应用也有一些不容忽视的弊端,例如:

  • 额外引入的脚本会拖慢网站性能。部分 Cookie 横幅 App 会加载外部 JavaScript 文件和第三方资源。根据具体实现方式的不同,这些脚本可能会直接拉长页面的加载时间。

  • 对追踪的控制力有限。并非每款 Cookie 横幅应用都能对第三方脚本和像素提供足够的控制。如果你接入了 Google Analytics、Google Ads、Meta Pixel 或服务端追踪,可能需要额外配置,才能确保这些工具遵从访客的授权选择。

  • 与其他追踪方案存在兼容性问题。Cookie 横幅应用可能会与现有的 GTM 配置、其他隐私工具或 Shopify 内置的授权功能产生冲突。

其实并不一定需要专门装一个 Shopify Cookie 横幅应用。例如,Stape 的 CMP 允许 Shopify 商家直接在 Stape 账户中配置和管理 Cookie 授权,无需额外安装 Shopify 应用。 

面向 Shopify 店主的 Stape CMP

对于配置了多个分析与广告平台、或者通过 Stape 进行服务端数据追踪的 Shopify 商家来说,Stape 的 CMP 尤为实用。该 CMP 直接集成在你的 Stape 账户中,且面向所有 Stape 用户开放,不收取任何 CMP 授权费。

Stape’s CMP

Stape CMP 最亮眼的特性之一,就是它通过 Custom Loader 加载,并直接由你自己的域名提供服务,无需经由第三方域名(第三方域名可能会被广告拦截插件屏蔽)。这样一来,CMP 就成了服务端追踪架构的一部分。 

如果你对服务端追踪还不熟悉,可以点击下方折叠面板,快速了解这种追踪方式及其能为 Shopify 店铺带来的优势:

在客户配置 Stape 的 Shopify 转化追踪应用时,我们的团队全程提供了支持。在这些交流中,许多问题并不局限于应用本身,而是涉及 Shopify 商家在授权管理上面临的更广泛挑战。我们结合这些洞察与反馈开发了 Stape CMP,重点解决其中几大常见痛点。下面我们来看看这些挑战,以及 Stape CMP 是如何化解它们的。

CMP 与 Shopify 之间的授权状态未同步

Shopify 使用 Customer Privacy API 在各项 Shopify 服务中管理隐私偏好。如果第三方授权管理系统没有通过 Shopify 的 Customer Privacy API 共享授权信息,双方记录的访客选择就可能不一致。

受店铺隐私配置的影响,有时即使访客已在 CMP 中同意授权,Shopify 仍可能拦截数据追踪,从而造成数据偏差。

Stape CMP 如何解决这个问题

Stape CMP 支持与 Shopify Customer Privacy API 集成,访客在 Cookie 横幅中所做的授权选择会同步反映在 Shopify 的隐私设置中。

Shopify Customer Privacy API

授权状态无法自动传递到结账页面

Shopify 的店面和结账使用的是两套不同环境。正因如此,访客在店面做出的授权选择并不总能自动同步到结账环节。这会导致第三方平台收到错误的授权状态,或默认将其设为“已拒绝”。我们的一位客户在为 Shopify 配置第三方 CMP 后就遇到了这一问题。

问题出在集成方式上——该商家是通过在 Shopify 上直接编辑 theme.liquid 来添加 CMP 的。把 CMP 的初始化改由 GTM 代码来触发后,结账页面就能正常获取到授权状态了。 

Stape CMP 如何解决这一问题

由于 Stape CMP 是通过 Custom Loader 部署的,它能与现有配置完全集成,无需修改 theme.liquid。访客在店面做出的同意选择也会同步应用到结账流程中。

Google Consent Mode v2 配置难度较大

在 Shopify 上配置 Google Consent Mode v2 并不轻松,尤其当店铺同时启用了 GTM、服务端跟踪和第三方 CMP 时。这些组件必须协同运作,准确传递同意状态信息。

例如,有些 Cookie 横幅方案会在访客同意之前直接拦截 GTM。乍看之下,这确实能在获得同意前阻止跟踪,但它可能会干扰 Google Consent Mode v2 的运作,特别是在使用高级模式(Advanced Consent Mode)时。高级模式要求 Google 代码在访客做出同意选择之前加载,以便向 Google 工具发送无 Cookie 信号(cookieless ping)。

Stape CMP 如何解决这一问题

Stape CMP 支持 Google Consent Mode v2,可将访客的同意选择准确传递给 Google 代码。

Stape CMP supports Google Consent Mode v2

使用设置向导配置数据跟踪!

通过设置向导从零配置网站和服务器端 GTM 模板,绑定 Shopify 店铺,免费启用跟踪功能。

首先在账户中启用 CMP 配置:

登录 Stape 账户 → 点击你的 sGTM 容器 → 进入 Stape 账户中的 CMP 板块 → 添加网站网址并点击“Create CMP”开始配置 CMP。

Create CMP

注意:本文主要介绍与 Shopify 店铺密切相关的要点;如需了解常规 CMP 配置(包括 Cookie 扫描、同意分类、横幅自定义、区域设置及其他集成),请参阅帮助中心的 CMP 配置指南。

1. 在“Integrations & consent signals”中,务必开启 Shopify Customer Privacy API 开关,以便 Stape CMP 与 Shopify 同步访客的同意偏好。

Shopify Customer Privacy API

2. 打开 Shopify 版 Stape 转化跟踪应用,并在设置中确保关闭“Rely on Shopify Customer Privacy API consent states”选项。

如果不取消勾选该项,一旦访客拒绝了任意一个同意类别,Shopify 应用就可能阻止加载 GTM。这样一来,Custom Loader 也无法加载,导致 CMP 脚本无法初始化、同意横幅无法显示。这就陷入了一个死循环:访客既看不到同意横幅也无法修改偏好,而 GTM 和 Custom Loader 又始终处于被拦截状态。

Rely on Shopify Customer Privacy API consent states

请务必填写正确的容器标识符(Container identifier,如果你在 Stape 上托管了多个容器)。容器标识符可以在 sGTM 容器的“Settings”标签页中找到。

Container identifier

3. 根据你的 Shopify 跟踪配置开启对应的开关。

  • Google Consent Mode v2——适用于使用 Google Analytics 或 Google Ads 等 Google 代码的场景。

  • Push dataLayer event——适用于需要通过 GTM 或自定义脚本接收 CMP 同意状态更新的场景。 

  • Delete cookies on withdrawal——当偏好发生更改或页面加载时,自动删除与被拒绝同意类别相关的 Cookie、localStorage 和 sessionStorage 项。该功能有助于确保在撤回同意后彻底清除跟踪数据。

  • 页面内拦截(In-page blocking):如果跟踪脚本直接写在网站 HTML 中,或者通过其他不支持 GTM 基于用户许可进行拦截的系统加载,请启用此项。

  • Microsoft Clarity / UET Consent API:如果使用了 Microsoft Clarity 或 Microsoft Advertising UET 标签,并希望向其同步访客的授权选择,请启用此项。

  • IAB TCF 与 IAB GPP - US opt out signal:适用于与广告供应商合作的企业。

Enable toggles that correspond to your Shopify tracking setup

4. 指定向网站访客展示的隐私相关信息:

  • Privacy Policy URL(隐私政策链接):输入网站隐私政策的网址。该链接会显示在授权弹窗中,方便访客查看个人数据的处理方式。 

  • Privacy Contact Details(隐私联系方式):提供联系信息,以便访客咨询隐私问题或提出个人数据相关请求。

  • Displayed Contact Role(展示的联系人身份):为授权弹窗中显示的隐私联系人添加称谓,例如“数据保护官”、“隐私团队”或“隐私联系人”。 

privacy-related information

5. 查看扫描结果,只需点击几下即可将检测到的 Cookie 添加到库中。

Check the scanning results

如果某些 Cookie 不在 Stape 库中,你可以点击“+”手动添加。记得选好提供商和用途,然后点击“Create”。 

Create

如有需要,你随时可以在“Cookies”标签页中手动添加新的 Cookie。

You can always add a new cookie manually in the “Cookies” tab

6. 在“Consent Builder”中,你可以调整 Cookie 弹窗的外观,并按不同合规法规和设备类型预览呈现效果。

In the “Consent Builder” you can adjust the cookie banner design

完成这些基础设置后,如果无需显示多语言弹窗、手动添加 Cookie 或更改已有配置,直接点击“Publish”即可。

发布后,还需要调整 Web 端 GTM 设置(具体操作见下一步说明)。 

After publishing, adjust web GTM settings

7. 调整 Web 端 GTM 设置。

Stape CMP 不需要额外的标签或平台应用配置。不过,为了保证跟踪符合合规要求,你必须在 Web 端 GTM 容器中对相关标签进行调整。

具体配置方式取决于你在“Integrations & Consent Signals”配置项中启用了哪些集成,以及网站本身使用了哪些标签。

点击对应的折叠项,配置 Web 端 GTM 设置:

为了方便调试,我们使用 Stape Chrome 扩展程序。它不仅支持调试结账页面,还提供许多实用的调试功能,包括实体过滤、请求 URL 格式化、网站跟踪扫描与评估,以及在服务端 GTM 中显示用户授权状态。

1. 同时在 Web 端和服务端 GTM 容器中启动预览模式。

web and server GTM containers

2. 在弹窗上进行操作(例如接受或拒绝所有 Cookie)。

Interact with the banner

3. 返回 Web 端 GTM 容器的预览窗口。 

如果在 Stape CMP 设置中开启了 Push dataLayer event 选项,Consent Update 事件之后还应该会出现 stape_cmp_consent_update 事件。

如果是通过设置向导配置的 Web 端 GTM,则会改推送 stape_consent_update 事件。

打开对应事件并切换到 Consent 标签页,检查以下内容:

  • Default Statuses(第一列):根据 Stape CMP 中配置的默认授权设置,所有许可类型都应显示为 Denied。

  • On-page Update(第二列):显示访客通过 Cookie 弹窗做出的授权变更。

  • Current State(第三列):显示访客当前的授权状态。

Open the relevant event and navigate to the Consent tab

请确保在处理任何其他跟踪事件(例如 page_view 或 add_to_cart)之前,许可状态已完成更新。这样可以确保分析和营销标签从会话一开始就遵循访客的许可偏好。

page_view or add_to_cart

如果访客在 Cookie 横幅中修改了偏好设置(例如拒绝了此前已同意的 Cookie 类别),系统应再次触发 stape_cmp_consent_update 事件。

stape_cmp_consent_update

此时,Consent(许可)选项卡中的数值应当反映访客更新后的许可偏好。

4. 检查许可状态是否已同步至结账页面。

受 Shopify 相关限制(包括 Shopify Customer Privacy API、Checkout Extensibility 以及 Web Pixels 沙箱机制)的影响,结账事件可能不会出现在 GTM 预览窗口中。

在控制台中运行以下命令,即可检查许可状态:

google_tag_data.ics.entries

The consent statuses can be checked via running the following command in the console

打开 Inject GTM 选项卡 → 点击 Enable injection → 输入你的域名和 GTM ID → 保存更改。

Enable injection

5. 检查服务端 GTM 中的许可状态。

接下来,在服务端 GTM 容器的预览模式中检查许可状态。

由于 sGTM 的机制限制,许可状态默认不会在预览中显示。但这步检查非常关键,因为服务端容器接收到的浏览数据后续可能会发送给第三方平台。

前面提到的 Stape GTM Helper Chrome 扩展程序可以帮助显示这些信息。

如需启用,打开该扩展程序的 Settings 选项卡 → 启用 Consent mode server side 即可。

Consent mode server side

检查服务端 GTM 预览接收到的请求中,许可状态是否与网页端 GTM 中显示的一致。

这样可以确保许可信息在两个容器之间正确传递,并确保数据跟踪遵循访客的隐私选择。

许可日志

Stape 的 CMP 中提供了一个 Consent logs(许可日志)选项卡。 

许可日志的核心用途是满足合规监管要求。它记录了访客许可决定的凭据,便于网站所有者证明自己符合隐私规范;一旦面临监管审查或审计,也能证实许可收集流程合规。Stape 会将许可日志保留 3 年。

除了满足合规要求,在测试阶段以及 Cookie 横幅正式上线后,这项功能同样非常实用。

通过它,你可以查看服务端 GTM 容器从 Stape CMP 接收到的许可记录。借助这些记录,你能核对访客的许可决定、排查许可相关问题,并确保许可信息准确传递至跟踪体系中。

Consent logs

你可以利用许可日志完成以下操作:

  • 确认许可决定已成功传输至服务端 GTM 容器。

  • 排查许可状态异常或非预期的跟踪行为。

  • 查看特定访客所作出的许可选择。

Stape CMP 能够帮助 Shopify 商家有效化解各类常见挑战。它支持 Custom Loader 部署、深度整合 Shopify Customer Privacy API,并支持 Google Consent Mode v2,是 Shopify 应对 GDPR 及其他数据隐私法规的理想 Cookie 横幅解决方案。只要合理配置并充分调试,你就能搭建出一套既充分尊重访客隐私偏好、又能确保数据采集精准可靠的跟踪体系。

来源:Stape Server-Side Tracking Blog · stape.io

EVAOO 主站实战落地 · 追踪归因、CRO 与用户留存

看完情报?回到 EVAOO 主站直接上手工具与完整 SOP

返回 EVAOO 主站