SuperAPI AI 工具集

ga-taxonomy

数据与分析

查看项目

更新于 10-15 21:33

技能介绍

用途:解析、管理 GA4 事件分类法(事件定义书)。可将电子表格中的计划事件和参数解析成 taxonomy.json/taxonomy.md,与 GA4 实际收集情况对比,或在无分类法时依据实时数据起草。面向非技术营销人员。

主要能力:解析 Google Sheets URL 或本地 xlsx/csv;自动识别列名(也支持 --map 按表头或列字母映射,映射与 --sheet 会被保存复用);与 GA4 实际收集对比;输出 warnings 覆盖未识别 scope、重复事件、公共参数块位置、items 数组 scope、GA4 收集上限、注册表过期、非法 GA4 名称等问题;支持用 taxonomy_restore.py 回滚到备份版本(保留最近 5 代)。

使用方式:先检查 .ga4/ 状态与依赖,必要时安装库;解析命令:.ga4/venv/bin/python {SKILLS_DIR}/ga-taxonomy/scripts/parse_taxonomy.py "<URL 或文件路径>";csv 用系统 python3,xlsx/URL 需 .ga4/venv/bin/python。查看状态可运行 python3 {SKILLS_DIR}/ga-auth/scripts/ga4_status.py。

适用场景:营销团队整理 GA4 事件定义、核对线上收集情况、从零起草分类法。

限制:需要 GA4 连接(ga-auth)才能使用实时数据功能;平台信息未知时不能假设平台;脚本英文提示需转述为用户语言;未提供定价与具体产出格式等信息。