核心用法
本技能提供 Google Analytics API 的双向集成能力，通过 Maton 网关代理访问 Google 官方 Admin API 与 Data API。用户可通过 RESTful 接口完成账户管理（创建属性、数据流、自定义维度）和数据分析（运行报表、实时监控、批量查询）。
关键工作流程：
1. 身份认证：获取 Maton API Key 后，在 ctrl.maton.ai 分别创建 google-analytics-admin 和 google-analytics-data 两个 OAuth 连接
2. 账户管理：使用 Admin API 列出账户摘要、创建 GA4 属性、配置 Web 数据流、定义转化事件
3. 数据查询：使用 Data API 执行 runReport、runRealtimeReport 或 batchRunReports，支持相对日期（如 30daysAgo）与绝对日期格式
显著优点
- 托管 OAuth 简化授权：无需自行处理 Google OAuth 2.0 流程，Maton 集中管理令牌刷新与权限
- 双 API 完整覆盖：同时支持资源配置（Admin）与数据分析（Data），满足运维与业务双重需求
- 实时数据能力：提供
runRealtimeReport端点，可获取当前活跃用户等实时指标 - 批量查询效率：
batchRunReports支持单次请求多个报表，减少网络开销 - 多语言示例完备：提供 cURL、JavaScript、Python 的完整代码片段，降低接入门槛
潜在缺点与局限性
- 仅支持 GA4：Universal Analytics 已弃用，历史 UA 数据无法通过此技能访问
- 双连接配置负担：Admin 与 Data API 需分别建立 OAuth 连接，增加初期配置复杂度
- 速率限制：每账户 10 req/sec 的限流可能制约高频监控场景
- 网关依赖：所有请求经由 Maton 网关代理，存在单点延迟与可用性风险
- 功能边界：不支持 Google Analytics 360 的高级功能（如 BigQuery 导出配置）
适合人群
- 数字营销团队：需要快速拉取流量来源、转化漏斗等常规报表
- SaaS 产品经理：集成用户行为数据至内部 BI 或运营后台
- 中小技术团队：缺乏 OAuth 与 Google Cloud 运维经验，希望降低接入成本
- 自动化运维场景：通过 API 批量创建客户属性或监控多账户数据健康度
常规风险
- 数据隐私合规：传输用户行为数据需确保符合 GDPR、CCPA 等法规要求
- OAuth 权限泄露：Maton 连接一旦授权，具备读写 Google Analytics 配置的完整权限，需妥善保管 API Key
- 报表维度误用：GA4 与 UA 的维度/ metrics 命名差异较大，历史查询逻辑可能失效
- 实时数据延迟：
runRealtimeReport实际存在分钟级延迟，不宜用于秒级精确监控