GA4 Analytics

GA4 数据查询技能

核心用法：本技能封装了 Google Analytics Data API v1 的 Python 查询脚本，支持从 GA4 媒体资源中提取标准及自定义分析指标。用户可通过命令行参数组合灵活调用——指定 metrics（如 screenPageViews、conversions）、dimensions（如 pagePath、sessionSource）、日期范围与过滤条件，快速获取 Top 页面、流量来源、落地页表现等关键数据。输出支持表格、JSON、CSV 三种格式，便于后续数据处理。

显著优点：直接对接 Google 官方 GA4 API，数据权威性高；查询语法简洁，无需编写复杂 API 调用代码；支持多指标批量拉取与正则过滤，满足定制化分析需求；日期范围灵活，可追溯历史数据。

潜在缺点/局限性：需预先配置 OAuth 2.0 凭证（Client ID/Secret + Refresh Token），首次设置门槛较高；仅支持已授权 GA4 属性的数据，无法跨账户查询；API 存在每日配额限制（如 200,000 请求/天），大规模数据抽取可能触发限流；无内置数据缓存机制，重复查询消耗配额。

适合人群：网站运营人员、数字营销分析师、产品增长团队及开发者——需定期监控流量趋势、评估内容表现或构建自定义数据报表的用户。

常规风险：凭证管理不当可能导致数据泄露；Refresh Token 过期需重新授权；API 变更或配额调整可能影响服务可用性；过滤条件语法错误将返回空结果或报错。

核心用法

GA4 Skill 是专为 Google Analytics 4 设计的官方 API 查询工具，通过命令行脚本实现灵活的数据提取。用户需先完成一次性 OAuth 配置（设置 GA4_PROPERTY_ID、GOOGLE_CLIENT_ID 等环境变量），即可执行多种分析查询：

• 流量概览：--metric sessions --dimension sessionSource 查看流量来源分布
• 页面表现：--metrics screenPageViews,sessions,totalUsers --dimension pagePath 获取 TOP 页面数据
• 转化追踪：支持 conversions、eventCount 等指标分析用户行为路径
• 灵活筛选：通过 --filter 参数按页面路径过滤，--start/--end 自定义日期范围
• 多格式输出：默认表格展示，可选 --json 或 --csv 便于二次处理

显著优点

1. 官方 SDK 保障：基于 google-analytics-data 和 google-auth-oauthlib 官方库，API 兼容性与稳定性可靠
2. 凭证安全：OAuth 2.0 刷新令牌机制，密钥通过环境变量注入，无硬编码风险
3. 查询维度丰富：涵盖 30+ 核心指标与维度，支持多指标组合与自定义过滤
4. 轻量高效：纯 Python 脚本实现，无需复杂部署，适合 CI/CD 集成与定时报表

潜在局限

• 配置门槛：需手动创建 Google Cloud 项目、启用 API、走 OAuth 授权流，对非技术用户不够友好
• 配额限制：受 GA4 API 每日限额约束（标准属性约 10,000 请求/天），大数据量场景需分批处理
• 无可视化层：输出为原始数据表，需配合 BI 工具或脚本进一步加工
• T3 来源风险：维护者为匿名社区账号，无知名组织背书，长期更新承诺存疑

适合人群

• 网站运营人员：快速拉取周报/月报核心指标
• 数据分析师：将 GA4 数据接入本地分析 pipeline（Python/R）
• 开发者：为内部工具集成网站流量监控能力

常规风险

• 凭证泄露：环境变量若被进程 dump 或日志误打印，可能导致账号接管；建议生产环境改用 Secret Manager
• 权限过宽：OAuth 授权时需确认范围为 analytics.readonly，避免误授写入权限
• 隐私合规：提取的用户地理、设备数据需符合 GDPR/CCPA 等法规的存储与使用要求