核心用法
GA4 技能是连接 Google Analytics 4 的官方数据查询工具，基于 Analytics Data API v1 构建。用户通过环境变量配置 OAuth 凭证后，可执行只读查询获取网站分析数据，包括页面浏览量、会话数、用户数、流量来源、转化率等核心指标。
显著优点
1. 官方 API 集成：直接对接 Google 官方 Analytics Data API，数据准确性与实时性有保障
2. 只读安全设计：明确限定为读取权限，无法修改 GA4 属性配置或数据
3. 灵活查询能力：支持多指标/维度组合、自定义日期范围、正则过滤、多种输出格式（表格/JSON/CSV）
4. 开箱即用示例：提供覆盖常见场景（热门页面、流量来源、着陆页等）的现成命令模板
潜在局限
- 配置门槛：需预先完成 Google Cloud 项目设置、API 启用、OAuth 授权流程，对非技术用户不够友好
- 凭证管理风险：依赖四个环境变量（含 client_secret 和 refresh_token），若配置不当存在凭证泄露隐患
- 仅限 GA4：不支持 Universal Analytics（已停止服务），历史 UA 数据需迁移
- 无可视化：纯 CLI/文本输出，需配合其他工具做数据可视化
适合人群
- 网站运营人员、增长黑客、数据分析师
- 需要将 GA4 数据集成到自动化报告或数据管道的技术团队
- 熟悉 OAuth 流程、具备基础 Python 环境的开发者
常规风险
- OAuth refresh_token 长期有效，需妥善保管环境变量
- 查询范围受 GA4 账号权限限制，无法越权访问未授权属性
- 频繁 API 调用可能触及 Google 配额限制（每日 200,000 次请求）