官方 GA4 数据一键查询分析

通过 Google Analytics Data API 只读查询 GA4 数据，支持页面流量、用户行为、转化追踪等多维度分析，需 OAuth 环境变量配置。

基本信息

• 技能名称?GA4 Analytics
• 中文名称?官方 GA4 数据一键查询分析
• 作者?jdrhyne
• 分类?专业技能
• 版本?1.2.2
• 标签?analytics, google-api, data-query, oauth, ga4, website-metrics, business-intelligence

使用方法

使用说明
核心用法
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 次请求）