SuperAPI AI 工具集

google-analytics

数据与分析

查看项目

更新于 10-16 05:05

技能介绍

用途:通过 Google Analytics 数据评估网站表现,输出可执行的优化建议,适用于流量复盘、页面表现排查、渠道与转化分析等场景。

主要能力:查看会话、用户、新用户、页面浏览量、平均会话时长等流量指标;分析跳出率、互动率、事件数、转化等互动指标;识别流量来源/媒介、渠道分组与广告系列表现;分析转化目标与电商交易;对比不同时间段表现,找出高表现与低表现页面,并给出带优先级和预期影响的改进建议。

使用方式:先配置环境变量 GOOGLE_ANALYTICS_PROPERTY_ID 与 GOOGLE_APPLICATION_CREDENTIALS,或在项目根目录创建 .env 文件;再安装依赖,可执行 pip install -r cli-tool/components/skills/analytics/google-analytics/requirements.txt,或 pip install google-analytics-data python-dotenv pandas。随后可直接提问,例如“回顾最近 30 天的 Google Analytics 表现”“哪些页面跳出率最高”。技能内置脚本:python scripts/ga_client.py --days 30 --metrics sessions,users,bounceRate 用于拉取数据;python scripts/analyze.py --period last-30-days --compare previous-period 用于分析与生成报告。

限制与安全:需要 GA4 属性 ID(非衡量 ID)及具备 Viewer 权限的服务账号;凭据不得提交到版本控制,应存放于仓库外并加入 .gitignore,定期轮换密钥。仅访问聚合数据,不涉及个人身份信息,不持久化存储数据,不修改 GA 配置。若认证失败或无数据,需检查凭据路径、属性 ID、日期范围与账号授权。详细指标定义见 REFERENCE.md,分析示例见 EXAMPLES.md。