用途:ga-use 用于回答营销人员的自然语言 GA4 分析请求,将其转换为 GA4 Data API 报告。确定性工作由 scripts/ 下的 Python 完成,模型负责请求到查询的映射与结果解读。
主要能力:支持事件数、用户、会话、页面浏览、Top-N 排名、按维度筛选等查询;提供 ga4_query.py、ga4_realtime.py、ga4_pivot.py、ga4_cohort.py、ga4_funnel.py、ga4_metadata.py 等脚本,需用 .ga4/venv/bin/python 运行(依赖 google-analytics-data)。可结合 taxonomy.md 与 custom_definitions.json 映射事件和参数,用 ga4_metadata.py get-metadata --search 检索维度与指标。
使用方式:先做状态检查,确认 .ga4/ 下 config.json(property_id)与 token.json 是否存在,未连接时先用 ga-auth 技能登录;依赖未就绪时本技能自行执行 deps_fix 并复查。随后确认指标、周期、拆分维度与筛选,映射到实际事件/参数名,构建扩展 JSON 规格并查询,例如:echo '<request JSON>' | .ga4/venv/bin/python {SKILLS_DIR}/ga-use/scripts/ga4_query.py。最后整理为表格或摘要作答。
适用场景:面向非技术营销人员的 GA4 数据查询与分析,包括转化分析、路径/旅程、概览、变化诊断、内容表现与行为重要性比较等复合问题。
限制与注意:不要对行求和得到总数,以 ~Users 和 sessions 结尾的指标为去重值,比率与平均值不可相加;totalUsers 与 activeUsers 不可互换;dauPerMau 等滚动比率在跨多天时无维度聚合是每日值之和;收入类表达式指标可能返回原始收入;报告收入须注明 metadata.currency_code;sampling、subject_to_thresholding、data_loss_from_other_row 会影响数字可引用性;缺失日期行是真实零值;(not set) 不是类别;fully_unset 需结合平台判断是否为埋点缺口。脚本输出不直接展示给用户,错误提示需改写为用户语言,标识符、路径与命令保持原样。资料未提供具体收费、价格与平台支持范围。