google-analytics

核心用法

本Skill提供Google Analytics 4（GA4）的双API集成能力，通过Maton网关服务代理所有请求。用户需先在Maton平台创建OAuth连接，获取MATON_API_KEY后即可调用：

• Admin API：管理账户层级结构（accounts）、媒体资源（properties）、数据流（dataStreams）、自定义维度（customDimensions）及转化事件（conversionEvents）
• Data API：执行标准报告（runReport）、实时报告（runRealtimeReport）及批量报告（batchRunReports），支持日期范围、维度、指标、排序等完整参数

典型工作流为：通过accountSummaries快速定位可访问资源 → 使用runReport查询活跃用户、页面浏览、转化等核心指标 → 利用metadata端点发现可用维度/指标。

显著优点

1. 零OAuth开发成本：Maton托管Google OAuth流程，用户无需处理token刷新、授权回调等复杂逻辑
2. 双API统一入口：Admin与Data API通过同一网关访问，降低多端点管理成本
3. 多语言示例完备：提供Python（urllib/requests）和JavaScript（fetch）的即插即用代码
4. 连接隔离机制：支持多Google账户场景，通过Maton-Connection头指定特定连接
5. 原生API兼容：网关路径直接映射Google官方API，文档与官方参考100%对应

潜在缺点与局限性

1. 第三方网关锁定：所有数据流经Maton基础设施，存在供应商依赖风险
2. 仅支持GA4：Universal Analytics已废弃，历史UA数据无法查询
3. 速率限制：10 req/sec/账户的硬限制，大规模数据抽取需分批处理
4. 连接管理复杂度：Admin与Data API需分别创建连接，新手易混淆
5. 环境变量敏感：MATON_API_KEY泄露将导致账户级访问权限暴露

适合的目标群体

• 数据分析师：需要快速搭建GA4报表流水线，无需后端开发资源
• 营销运营团队：监控campaign效果、转化漏斗，实时获取流量洞察
• SaaS产品经理：集成用户行为数据至内部BI系统
• 中小技术团队：缺乏专职数据工程师，希望以低代码方式接入Google生态

使用风险

• 数据隐私合规：业务数据经Maton中转，需评估其SOC 2/ISO 27001认证状态
• 服务连续性：Maton网关故障将完全阻断功能，建议设计降级方案
• OAuth范围过度授权：默认连接可能请求超出必要范围的权限，应在Google账户侧定期审计
• 密钥管理：MATON_API_KEY需纳入企业密钥管理系统，避免硬编码或日志泄露