Google Analytics

核心用法

本技能通过 Maton 代理服务提供对 Google Analytics 4 (GA4) 的双 API 支持：

• Admin API：管理账户层级结构（accounts）、媒体资源（properties）、数据流（data streams）、自定义维度（custom dimensions）及转化事件（conversion events）
• Data API：执行标准报表查询（runReport）、实时数据报表（runRealtimeReport）及批量报表（batchRunReports）

认证采用 OAuth 2.0 托管模式，用户仅需在 Maton 平台创建连接并完成 Google 授权，后续所有请求通过 MATON_API_KEY 自动注入凭证，无需手动处理 token 刷新。

显著优点

1. 零 OAuth 维护成本：Maton 自动处理 token 生命周期管理，开发者只需关注业务查询
2. 双 API 统一入口：Admin 与 Data API 分别通过 /google-analytics-admin 和 /google-analytics-data 路径暴露，语义清晰
3. 丰富的查询能力：支持维度/指标组合、日期范围（相对/绝对）、排序、限制条数等完整 GA4 报表语法
4. 多语言示例完备：提供 Python、JavaScript、curl 的即 copy-paste 代码片段，降低接入门槛

潜在缺点与局限性

• 仅限 GA4：明确不支持已停用的 Universal Analytics 属性
• 双层连接管理：Admin 与 Data API 需分别创建 google-analytics-admin 和 google-analytics-data 连接，增加配置复杂度
• 速率限制：每账户 10 req/sec，高频场景需本地缓存或批处理
• 代理依赖：所有流量经 Maton 中转，存在单点可用性风险及额外网络延迟
• 写入操作需确认：技能文档要求执行 create/update/delete 前必须人工确认，自动化场景受限

适合人群

• 需要程序化查询 GA4 数据的产品经理、数据分析师
• 构建内部数据面板、自动化周报系统的工程团队
• 希望避免自建 OAuth 基础设施的中小型开发者

常规风险

| 风险类型 | 说明 |

|---------|------|

| 数据权限 | 连接授权后，Maton 服务端持有 Google Analytics 数据读取/管理权限，需信任 Maton 安全实践 |

| 密钥泄露 | `MATON_API_KEY` 泄露将导致账户级数据暴露，建议仅存放于环境变量或密钥管理服务 |

| 合规边界 | GA4 数据可能包含用户级行为信息，跨境传输需评估 GDPR/CCPA 合规要求 |

| 供应商锁定 | 深度依赖 Maton 代理路径，迁移至原生 Google API 需改写 URL 及认证逻辑 |

核心用法

google-analytics 是一个纯文档型 API 代理 Skill，通过 Maton 平台桥接 Google Analytics 的 Admin API 与 Data API，实现托管式 OAuth 认证。用户需先在 maton.ai 获取 MATON_API_KEY，并分别创建 google-analytics-admin（账户/属性/数据流管理）和 google-analytics-data（报表查询）两种连接完成 OAuth 授权。

Admin API 支持查看账户摘要、创建 GA4 属性、配置 Web 数据流、管理自定义维度与转化事件；Data API 支持运行标准报表、实时报表、批量报表，并提供丰富的维度（城市、页面路径、流量来源）与指标（活跃用户、会话数、转化率）。

显著优点

• 托管 OAuth：无需自行维护 refresh token，Maton 自动处理 token 生命周期
• 双 API 覆盖：同时支持管理配置与数据查询，满足运营与开发双重需求
• 纯文档零代码：T-MD 类型 Skill，无本地可执行逻辑，静态风险极低
• 多语言示例：提供 Bash、Python、JavaScript 完整代码片段，上手门槛低
• 连接隔离：支持通过 Maton-Connection 头部在多个 GA 账户间切换

潜在缺点与局限性

• 平台依赖：核心功能完全依赖 Maton 代理服务（api.maton.ai），若其服务中断或定价策略变更将影响使用
• GA4 专属：不支持已弃用的 Universal Analytics，历史 UA 数据需迁移
• 速率限制：10 req/sec 每账户，高并发场景需自行实现退避逻辑
• 连接分离：Admin 与 Data API 需分别创建 OAuth 连接，增加配置复杂度
• 社区来源：T3 级来源，无企业 SLA 保障，长期维护不确定性高于官方工具

适合人群

• 需要快速集成 GA4 数据报表的分析师与数据工程师
• 希望避免 OAuth 实现细节的中小团队开发者
• 使用 Maton 生态构建营销数据管道的无代码/低代码用户

常规风险

• 密钥泄露风险：MATON_API_KEY 一旦泄露，攻击者可代理访问绑定的 GA 数据，需严格管控环境变量
• 数据权限范围：OAuth 授权后 Maton 可访问完整 GA 账户，需定期审查已授权连接
• 误操作风险：创建/删除属性、数据流等写操作不可逆，执行前务必确认资源 ID
• 隐私合规：虽 Skill 本身不存储 PII，但 GA 数据可能包含用户信息，需确保符合 GDPR/CCPA 数据处理协议