GA4 Analytics

GA4 数据查询技能评估

核心用法

该技能通过 Google Analytics Data API 实现 GA4 属性的只读数据查询，支持获取页面浏览量、会话数、用户数、流量来源、转化事件等核心网站分析指标。用户可通过命令行参数灵活组合指标（metrics）与维度（dimensions），并支持自定义日期范围、路径过滤及 JSON/CSV/表格三种输出格式。

显著优点

1. 官方 API 直连：基于 Google 官方 Analytics Data API，数据权威性高，与 GA4 控制台实时同步
2. 零侵入设计：纯只读查询，不修改任何 GA4 配置或数据，降低误操作风险
3. 灵活查询能力：支持多指标/维度组合、日期切片、正则过滤，满足从基础报表到深度分析的多元需求
4. 多格式导出：原生支持表格、JSON、CSV 输出，便于下游数据处理与可视化集成

潜在局限

• 认证配置门槛：需预先完成 Google Cloud 项目配置、API 启用及 OAuth 流程，对非技术用户有一定上手成本
• 环境变量依赖：运行时强制依赖 4 项环境变量，配置缺失将导致完全不可用
• 速率限制：受 Google API 配额限制，高频或大数据量查询可能触发限速
• 功能边界：仅支持数据查询，不提供实时预警、可视化看板或归因分析等高级功能

适合人群

• 数据分析师与运营人员：快速提取 GA4 数据用于自定义报表
• 开发者与工程师：将 GA4 数据集成至内部 BI 系统或自动化流程
• 小型团队：替代复杂 ETL 方案，低成本实现网站数据获取

常规风险

• 凭证管理风险：OAuth 凭证以环境变量形式传递，需确保部署环境的安全隔离，避免泄露
• 数据隐私合规：查询结果可能包含用户行为数据，需遵循 GDPR/CCPA 等隐私法规的存储与处理要求
• 查询范围失控：未加限制的查询可能返回海量数据，建议始终配合 --limit 参数使用

核心用法

GA4 Skill 是一款 Google Analytics 4 数据查询工具，通过官方 Analytics Data API 实现只读访问。用户需预先在 Google Cloud Console 启用 API 并配置 OAuth 凭据（Client ID/Secret/Refresh Token）及 GA4 Property ID 环境变量后即可使用。

主要功能覆盖：

• 流量概览：sessions、totalUsers、newUsers、activeUsers
• 页面分析：screenPageViews、pagePath、landingPage、pageTitle
• 渠道归因：sessionSource、sessionMedium、sessionCampaignName
• 转化追踪：conversions、eventCount
• 用户属性：deviceCategory、browser、country、city

支持自定义日期范围（--start/--end）、多指标组合查询（--metrics）、数据过滤（--filter），输出格式可选表格/JSON/CSV。

显著优点

1. 安全认证完备：通过 CLS-Certify S级认证，六维安全检测满分（静态分析、动态行为、依赖审计、网络流量、隐私合规、来源信誉）
2. 只读权限设计：仅调用 analyticsdata.googleapis.com 读取接口，无写入/修改风险
3. 凭证隔离管理：敏感信息强制从环境变量读取，无硬编码密钥泄露风险
4. 官方 API 直连：TLS 1.3 加密通信，无第三方中转或数据外泄
5. 轻量零依赖：纯 Python 实现，无第三方包依赖，供应链攻击面极小

潜在局限

• 配置门槛：需手动完成 Google Cloud OAuth 流程并获取 Refresh Token，对非技术用户不够友好
• 环境依赖：必须预装 Python3，且环境变量管理需用户自行保障安全
• Token 维护：OAuth Refresh Token 存在过期可能，需定期轮换
• 仅 GA4 支持：不兼容旧版 Universal Analytics（UA）属性

适合人群

• 网站运营/增长团队：需要快速拉取流量日报、周报数据
• 数据分析师：进行自定义维度交叉分析
• 产品经理：追踪页面转化漏斗、用户路径
• 开发者：集成 GA4 数据到内部 BI 系统

常规风险

• 凭证泄露风险：若环境变量配置不当（如误提交到 Git），可能导致 GA4 数据被未授权访问
• 权限配置过度：OAuth 凭若未遵循最小权限原则，可能被滥用其他 Google API
• 隐私合规边界：虽工具本身符合 GDPR 最小化原则，但用户查询的数据范围需自行合规审查

建议配合 .env 文件管理凭证并加入版本控制忽略列表，定期审查 GA4 数据访问日志。