SuperAPI AI 工具集

analytics-tracking-automation

数据与分析

查看项目

更新于 10-16 07:27

技能介绍

用途:该技能让 AI 智能体规划、实施并部署 GA4 + GTM 追踪方案,覆盖站点分析、页面分组、事件架构设计、GTM 容器同步、预览验证与发布,支持普通网站和 Shopify 店铺。

主要能力:爬取页面并识别业务意图;按用途分组页面(如产品、定价、联系);生成 GA4 事件、参数与触发器架构;通过 Google Tag Manager API 创建/更新标签、触发器、变量;用 Playwright 自动检查预览模式;验证通过后发布容器版本;对 Shopify 提供购物车、结账、购买流程的专用追踪;产物可审阅、可编辑、可断点续跑。

使用方式:安装可克隆仓库后执行 npm install 与 npm run install:skills,或使用 npx skills add jtrackingai/analytics-tracking-automation;用 npx event-tracking --version 验证。核心命令包括 init(初始化并爬取分析)、resume(从检查点续跑)、audit(审计现有 GTM)、sync(同步架构到 GTM)、verify(预览验证)、publish(发布容器)。同步需 Google OAuth,需在 Google Cloud Console 启用 Tag Manager API 并创建 OAuth 2.0 凭据,重定向 URI 为 http://localhost:3000/oauth/callback,首次同步会打开浏览器授权,凭据缓存于产物目录的 oauth-tokens.json。也提供 TypeScript API,如 analyzeSite、generateEventSchema、syncToGTM、verifyPreview、publishContainer、auditGTM、resumeWorkflow。

适用场景:从零搭建 GA4 + GTM 追踪、审计或重构现有追踪、Shopify 店铺追踪、跨多站点自动化重复追踪任务、需要可审阅可续跑流程及面向非技术方的业务化产物。

限制:不适合实时生产调试(应使用 GTM Debug View);资料中关于服务端追踪的内容被截断,暂未提供完整说明;Shopify 追踪需在 Shopify 后台手动验证;需 Node.js 18+,首次安装会自动安装 Playwright Chromium;GTM 用户需至少具备容器的发布权限;默认发送匿名启动信号,可用 npx event-tracking config telemetry --disable 关闭。