SuperAPI AI 工具集

add-google-analytics

数据与分析

查看项目

更新于 10-16 01:08

技能介绍

用途:为受支持项目配置 Google Analytics 4,每个项目创建一个生产 GA4 媒体资源和 Web 数据流,加入标准页面浏览与增强衡量,并支持非破坏性修复。

主要能力:支持 Next.js App Router 与 Pages Router、纯静态 HTML、Vite 原生 JavaScript、使用 Jinja 模板的 Flask 应用;不支持的项目会拒绝而非临时改造。流程包括检查项目、生成完整干跑计划、一次性引导无密钥服务账号、创建或对账 GA 资源、集成代码、验证配置与浏览器请求。

使用方式:先运行 node <skill-dir>/scripts/inspect-project.mjs . 检查;用 node <skill-dir>/scripts/ga4-admin.mjs doctor 检查配置,必要时执行 bootstrap(需 --quota-project、--time-zone、--currency、--confirmed);用 accounts、set-account 选择账号;用 plan 与 apply 创建或对账资源,apply 需 --confirmed,采用已有资源时加 --adopt-property properties/<id>;用 verify 校验。集成规则见 references/integrations.md。

限制与安全规则:任何变更前需一次明确确认;apply 要求 Git 工作区干净;不提交、推送或部署代码;不删除 Analytics 资源或数据;不与现有分析工具并存;存在多个路由、包管理器、GA 资源或生产 URL 时不猜测;严格 CSP 影响集成目标时停止并提议 nonce/hash 方案,禁止 unsafe-inline 或宽泛来源;凭据不得进入仓库、输出、shell 参数或日志;该流程默认不设同意门控,需在计划中说明。仅跟踪生产环境,每页一个标签,不添加自定义业务事件。安装期间不等待 GA 报告,数据摄取有延迟。