name: 谷歌分析 description: 分析 Google Analytics 数据，评估网站性能指标，识别流量模式，并建议数据驱动的改进。当用户询问分析、网站指标、流量分析、转化率、用户行为或性能优化时使用。

Google Analytics 分析

使用 Google Analytics 数据分析网站性能，提供可操作的见解和改进建议。

快速开始

1. 设置认证

此技能需要 Google Analytics API 凭据。设置环境变量：

export GOOGLE_ANALYTICS_PROPERTY_ID="您的属性ID"
export GOOGLE_APPLICATION_CREDENTIALS="/路径/到/服务账户密钥.json"

或在项目根目录创建 .env 文件：

GOOGLE_ANALYTICS_PROPERTY_ID=123456789
GOOGLE_APPLICATION_CREDENTIALS=/路径/到/服务账户密钥.json

切勿将凭据提交到版本控制。 服务账户 JSON 文件应安全存储在仓库外部。

2. 安装所需包

# 选项1：从需求文件安装（推荐）
pip install -r cli-tool/components/skills/analytics/google-analytics/requirements.txt

# 选项2：单独安装
pip install google-analytics-data python-dotenv pandas

3. 分析您的项目

配置完成后，我可以：

审查当前流量和用户行为指标
识别表现最佳和表现不佳的页面
分析流量来源和转化漏斗
比较不同时间段的性能
建议数据驱动的改进

如何使用

向我提问，例如：

“审查我们过去30天的 Google Analytics 性能”
“我们的主要流量来源是什么？”
“哪些页面的跳出率最高？”
“分析用户参与度并建议改进”
“将本月的性能与上月进行比较”

分析工作流程

当您要求我分析 Google Analytics 数据时，我将：

连接到 API 使用辅助脚本
获取相关指标 基于您的问题
分析数据 寻找：
- 流量趋势和模式
- 用户行为见解
- 性能瓶颈
- 转化机会
提供建议 包括：
- 具体改进建议
- 优先级（高/中/低）
- 预期影响
- 实施指导

常见指标

详细指标定义和维度，请参见 REFERENCE.md。

流量指标

会话、用户、新用户
页面浏览量、每次会话屏幕数
平均会话时长

参与度指标

跳出率、参与率
事件计数、转化
滚动深度、点击率

获取指标

流量来源/媒介
广告活动性能
渠道分组

转化指标

目标完成
电子商务交易
按来源的转化率

分析示例

完整分析模式和用例，请参见 EXAMPLES.md。

脚本

此技能包含用于 API 交互的实用脚本：

获取当前性能

python scripts/ga_client.py --days 30 --metrics sessions,users,bounceRate

分析并生成报告

python scripts/analyze.py --period last-30-days --compare previous-period

脚本处理 API 认证、数据获取和基本分析。我将解释结果并提供可操作建议。

故障排除

认证错误：验证：

GOOGLE_APPLICATION_CREDENTIALS 指向有效的服务账户 JSON 文件
服务账户对您的 GA4 属性具有“查看者”访问权限
GOOGLE_ANALYTICS_PROPERTY_ID 匹配您的 GA4 属性 ID（不是测量 ID）

无数据返回：检查：

属性 ID 正确（在 GA4 管理 > 属性设置中查找）
日期范围包含数据
服务账户已在 GA4 中被授予访问权限

导入错误：安装所需包：

pip install google-analytics-data python-dotenv pandas

安全注意事项

切勿硬编码 API 凭据或属性 ID 在代码中
将服务账户 JSON 文件存储在版本控制外部
使用环境变量或 .env 文件进行配置
将 .env 和凭据文件添加到 .gitignore
定期轮换服务账户密钥
使用最低权限访问（仅查看者角色）

数据隐私

此技能仅访问聚合的分析数据。它不：

访问个人可识别信息（PII）
持久存储分析数据
与外部服务共享数据
修改您的 Google Analytics 配置

所有数据在本地处理，仅在对话期间用于生成建议。