用途：通过 Google Analytics 数据分析网站表现，提供可执行的洞察与改进建议，适用于流量复盘、页面表现评估、来源与转化分析等场景。
主要能力：查看流量与用户行为指标（会话、用户、新用户、页面浏览量、平均会话时长等）；识别表现最好与最差的页面；分析流量来源与转化漏斗；对比不同时间段表现；给出带优先级和预期影响的改进建议。常见指标涵盖流量、互动（跳出率、互动率、事件数、转化）、获客（来源/媒介、广告系列、渠道分组）与转化（目标完成、电商交易、来源转化率）。
使用方式：先配置认证，设置环境变量： export GOOGLE_ANALYTICS_PROPERTY_ID="your-property-id" export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json" 或在项目根目录创建 .env 文件写入上述两项。然后安装依赖： pip install -r cli-tool/components/skills/analytics/google-analytics/requirements.txt 或单独安装： pip install google-analytics-data python-dotenv pandas 配置后可直接提问，例如“回顾最近 30 天的 Google Analytics 表现”“我们的主要流量来源是什么”“哪些页面跳出率最高”“对比本月与上月表现”。技能会连接 API、按问题获取指标、分析趋势与瓶颈并给出建议。附带脚本示例： python scripts/ga_client.py --days 30 --metrics sessions,users,bounceRate python scripts/analyze.py --period last-30-days --compare previous-period
限制与安全：需服务账号对 GA4 属性具备 Viewer 权限，属性 ID 须为 GA4 属性 ID 而非衡量 ID。凭据不得提交到版本控制，应存放于仓库外并加入 .gitignore，定期轮换密钥，遵循最小权限。该技能仅访问聚合分析数据，不涉及个人身份信息，不持久化存储数据，不向外部服务共享数据，也不修改 Google Analytics 配置。若认证失败、无数据返回或导入报错，需检查凭据路径、属性 ID、日期范围与依赖安装。详细指标定义见 REFERENCE.md，分析模式见 EXAMPLES.md。