SuperAPI AI 工具集

hydrogen-analytics-tracking

数据与分析

查看项目

更新于 10-16 00:20

技能介绍

用途:在 Shopify Hydrogen 店铺上搭建完整追踪链路,适用于默认 Hydrogen Analytics 组件不够用、需要服务端追踪、排查事件未进 GA4/Meta、做浏览器像素与服务端 CAPI 去重、使用 Weaverse 作为 CMS,或排查 Oxygen 全页缓存被禁用等场景。

主要能力:分三层追踪——浏览器层(dataLayer.push→GTM→GA4、Meta Pixel、Google Ads、TikTok)、服务端层(Hydrogen worker→GA4 Measurement Protocol、Meta CAPI、Google Ads 增强转化)、以及 Shopify 自带渠道(Google & YouTube、Customer Events Pixel,用于结账页)。核心是双发+event_id 去重:客户端生成 UUID,同时推 dataLayer 和用 navigator.sendBeacon 发到 /api/track,各厂商按 (event_name, event_id) 去重。还涵盖 Consent Mode v2、CSP strict-dynamic、Oxygen 全页缓存、A/B 实验曝光、webhook 转发与购物车属性暂存。

使用方式:按顺序搭建——根节点接入 <Analytics.Provider> 并在 <CustomAnalytics /> 订阅事件;<head> 内联 Consent Mode v2 默认拒绝块与 dataLayer;带 nonce 的 gtm.js;trackEvent() 助手;/api/track 服务端端点;orders/create webhook 映射 purchase;GTM 容器配置各事件标签;更新 CSP;按路由启用 Oxygen 缓存。约定:服务端代码放 app/.server/tracking/,客户端助手 app/utils/track-client.ts,dataLayer 桥接 app/components/root/custom-analytics.tsx。

限制:资料未提供具体收费、价格与效果数据。若单独安装本技能,../shopify-hydrogen/scripts/ 不存在,需先运行 npx skills add Weaverse/shopify-hydrogen-skills --skill shopify-hydrogen;references/ 文件可作离线备用。