Google Analytics

📊 托管 OAuth · GA4 数据与配置一站管理

analytics榜 #2

通过 Maton 托管 OAuth 连接 Google Analytics,支持 Admin API 管理账户与属性、Data API 运行数据分析报告,无需自行处理 Google 认证流程。

收藏
26.1k
安装
8.6k
版本
1.0.4
CLS 安全性认证2026-06-23
点击查看完整报告 >

使用说明

核心用法

本技能提供 Google Analytics 的双 API 集成能力,通过 Maton 网关代理实现托管式 OAuth 认证:

Admin API —— 用于管理 GA4 账户结构:

  • 查询账户列表、属性(Properties)、数据流(Data Streams)
  • 创建/更新属性、自定义维度、转化事件
  • 典型端点:/accountSummaries/properties/dataStreams

Data API —— 用于运行分析报告:

  • runReport:标准历史数据报告
  • runRealtimeReport:实时活跃用户数据
  • batchRunReports:批量多请求查询

所有请求通过 gateway.maton.ai 代理,自动注入 OAuth Token,开发者仅需提供 Maton API Key。

显著优点

1. 零 OAuth 开发成本:无需实现 Google OAuth 2.0 授权码流程,Maton 托管连接生命周期
2. 双 API 统一入口:Admin 与 Data API 共享同一认证体系,分别通过 -admin-data 子域名访问

3. 原生 API 透传:保留 Google Analytics API 的原生路径和请求格式,学习成本低

4. 灵活的连接管理:支持多 Google 账户切换,通过 Maton-Connection 头指定特定连接

潜在局限

1. 仅限 GA4:不支持已废弃的 Universal Analytics
2. 依赖第三方网关:所有流量经 Maton 中转,存在单点依赖

3. 双连接配置:Admin API 和 Data API 需分别创建 OAuth 连接,增加初次配置步骤

4. 速率限制:10 req/sec 每账户,高频场景需自行缓存

适合人群

  • 需要快速集成 GA4 数据的产品团队
  • 不愿维护 OAuth 令牌刷新逻辑的后端开发者
  • 需同时管理账户配置和查询报告的运营/数据分析师

常规风险

  • 数据隐私:网站流量数据经第三方网关,需评估 Maton 的数据处理条款
  • 连接失效:OAuth 授权可能因用户撤销或 Google 策略变更而失效,需监控连接状态
  • API 兼容性:Google Analytics API 版本更新(v1beta → v1)时需关注网关适配

安全解读

核心用法

本 Skill 提供 Google Analytics 4 (GA4) 的完整 API 集成能力,通过 Maton 托管网关实现 OAuth 认证代理,分为两大功能模块:

Admin API(管理接口):用于配置层面的操作,包括列出账户摘要、创建/管理媒体资源(Properties)、设置数据流(Data Streams)、管理自定义维度和转化事件等。典型场景如为新网站创建 GA4 属性并配置 Web 数据流。

Data API(数据接口):用于分析报表查询,支持标准报告、实时报告和批量报告。可查询活跃用户数、会话数、页面浏览量、跳出率、转化事件等核心指标,支持按国家、城市、设备类别、流量来源等维度拆解。

所有请求需通过 https://gateway.maton.ai 中转,使用 Maton API Key 认证,OAuth 令牌由 Maton 自动注入。

显著优点

  • 零代码负担:纯文档型 Skill,无本地依赖,复制即用
  • 双 API 全覆盖:同时支持 Admin API(配置管理)和 Data API(数据查询),满足从接入配置到报表分析的全链路需求
  • 托管 OAuth 安全:敏感令牌由 Maton 平台托管,避免本地泄露风险
  • 多语言示例完备:提供 curl、JavaScript、Python 的完整调用示例
  • 商业级网关信任:Maton 作为已知商业服务提供商,基础设施可靠性较高

潜在缺点与局限性

  • 数据中转依赖:所有 Google Analytics 数据必须经过 Maton 网关,存在第三方数据可见性,对数据主权敏感的企业需评估接受度
  • GA4 独占:不支持已停止服务的 Universal Analytics(UA)
  • 速率限制严格:每账户 10 req/sec,高频场景需自行实施缓存
  • 文档透明度缺口:未明确说明 Maton 的数据保留政策、加密细节及用户删除权利
  • 连接配置分离:Admin API 与 Data API 需分别创建 OAuth 连接,增加配置复杂度

适合人群

  • 需要快速集成 GA4 报表功能的开发者与数据分析师
  • 希望避免直接管理 Google OAuth 凭证的中小团队
  • 使用 Maton 生态构建数据看板、营销分析工具的用户
  • 对数据中转可接受、追求开发效率优先于完全数据控制的场景

常规风险

  • 第三方网关风险:Maton 网关成为潜在的单点故障与数据可见点,建议确认其数据处理协议(DPA)
  • 密钥管理责任:虽 Skill 本身无硬编码密钥,但用户需自行保障 MATON_API_KEY 的环境变量安全,避免误提交至版本控制
  • 隐私合规盲区:文档未涵盖数据保留期限、跨境传输合规说明,GDPR/CCPA 场景下需额外向 Maton 索取合规证明
  • OAuth 令牌生命周期:长期运行的自动化任务需关注连接状态(ACTIVE)及令牌刷新机制

Google Analytics 内容

手动下载zip · 4.2 kB
LICENSE.txttext/plain
请选择文件