Shopify CLI 与 Headless

Hydrogen 站点怎么接 Shopify 像素与 GA4

现象#

迁移到 Hydrogen 后,后台的分析报表几乎没数据,广告归因也断了。

原因#

  • Headless 站点不自动注入 Web Pixel
  • 结账在 Shopify 域名下完成,前端与结账数据割裂
  • 未使用 Analytics.Provider 上报事件

处理步骤#

  1. 用 Hydrogen 的 Analytics.Provider 包裹应用并配置 shopifyAnalytics
  2. 在加购、查看商品、搜索等关键节点调用 publish 上报
  3. 结账完成页用 Analytics.Provider 的 cart 数据补全转化
  4. GA4 与服务端事件用同一 event_id 去重

验收标准#

后台分析与 GA4 都能看到对应事件,订单数与 Shopify 一致,归因链路完整。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。