SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场google-analytics-automation

google-analytics-automation

数据与分析

查看项目

更新于 10-15 07:58

技能介绍

用途

本技能用于通过 Composio 的 Google Analytics 工具包，经由 Rube MCP 自动执行 Google Analytics 4（GA4）的报告运行与媒体资源管理任务。

前提条件

  • 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）。
  • 通过 RUBE_MANAGE_CONNECTIONS 并指定工具包 google_analytics，建立有效的 Google Analytics 连接。
  • 始终先调用 RUBE_SEARCH_TOOLS，以获取当前的工具 schema。

设置方式

  1. 获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器。无需 API 密钥——只需添加该端点即可使用。
  2. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
  3. 调用 RUBE_MANAGE_CONNECTIONS，指定工具包 google_analytics。
  4. 如果连接不是 ACTIVE 状态，请按照返回的授权链接完成 Google OAuth。
  5. 在运行任何工作流之前，确认连接状态显示为 ACTIVE。

主要能力与工作流

  1. 列举账户与媒体资源：用于发现可用的 GA4 账户和媒体资源。所需工具为 GOOGLE_ANALYTICS_LIST_ACCOUNTS 和 GOOGLE_ANALYTICS_LIST_PROPERTIES。关键参数包括 pageSize、pageToken 和 filter。注意：媒体资源 ID 是以 'properties/' 为前缀的数字字符串，账户 ID 以 'accounts/' 为前缀；应先列举账户，再列举各账户下的媒体资源；资源较多时需要分页。
  2. 运行标准报告：用于查询 GA4 数据中的指标和维度。所需工具为 GOOGLE_ANALYTICS_LIST_PROPERTIES、GOOGLE_ANALYTICS_GET_METADATA、GOOGLE_ANALYTICS_CHECK_COMPATIBILITY 和 GOOGLE_ANALYTICS_RUN_REPORT。关键参数包括 property、dateRanges、dimensions、metrics、dimensionFilter/metricFilter、orderBys、limit 和 offset。注意：日期格式为 'YYYY-MM-DD' 或相对值；并非所有维度和指标都兼容，应先使用 CHECK_COMPATIBILITY；每次报告请求最多 9 个维度；offset 用于结果分页而非日期分页。
  3. 运行批量报告：用于在一次调用中获取同一媒体资源的多个不同报告。所需工具为 GOOGLE_ANALYTICS_BATCH_RUN_REPORTS。每个批量调用最多 5 个报告请求，且所有报告必须针对同一媒体资源，批量错误可能影响所有报告。
  4. 运行透视报告：用于获取交叉制表数据（行与列），类似透视表。所需工具为 GOOGLE_ANALYTICS_RUN_PIVOT_REPORT。透视中使用的维度也必须列在顶层维度中；每个透视有自己独立的 limit 和 orderBys；复杂透视可能产生非常大的结果集。
  5. 运行漏斗报告：用于分析转化漏斗和流失率。所需工具为 GOOGLE_ANALYTICS_RUN_FUNNEL_REPORT。漏斗步骤有序，各步骤定义用户必须满足的条件；开放式漏斗允许从任意步骤进入，封闭式漏斗要求顺序推进；漏斗报告处理时间可能比标准报告更长。
  6. 管理关键事件：用于查看或管理 GA4 中的转化事件（关键事件）。所需工具为 GOOGLE_ANALYTICS_LIST_KEY_EVENTS。关键参数包括 parent、pageSize 和 pageToken。关键事件在 GA4 中此前称为“conversions”。

常见模式

  • ID 解析：通过账户 displayName 查找并提取 name 字段获取账户 ID；通过 filter 调用 LIST_PROPERTIES 并按 displayName 查找获取媒体资源 ID。
  • 维度/指标发现：先用 GET_METADATA 浏览可用维度与指标，再用 CHECK_COMPATIBILITY 验证组合，最后用于 RUN_REPORT。
  • 分页：报告使用 offset 与 limit 进行行分页；账户/媒体资源使用响应中的 pageToken，直到 pageToken 缺失或达到 rowCount。

常用维度与指标

维度：date、city、country、deviceCategory、sessionSource、sessionMedium、pagePath、pageTitle、eventName。指标：activeUsers、sessions、screenPageViews、eventCount、conversions、totalRevenue、bounceRate、averageSessionDuration。

已知限制

  • 媒体资源 ID 必须使用完整资源名称格式 'properties/123456'，仅用数字 ID 会报错。
  • 日期范围格式为 'YYYY-MM-DD' 或相对值（'today'、'yesterday'、'7daysAgo'、'30daysAgo'）；数据处理延迟意味着当天数据可能不完整；最大日期范围因媒体资源配置而异。
  • 并非所有维度都适用于所有指标，复杂报告前应先用 CHECK_COMPATIBILITY 验证；自定义维度/指标有特定的命名模式。
  • 响应解析：报告数据嵌套在 rows 数组中的 dimensionValues 和 metricValues 里；值以字符串返回，需显式解析数字；空报告不返回 rows 键（而非空数组）。

快速参考

列举账户：GOOGLE_ANALYTICS_LIST_ACCOUNTS，参数 pageSize、pageToken。 列举媒体资源：GOOGLE_ANALYTICS_LIST_PROPERTIES，参数 filter、pageSize。 获取元数据：GOOGLE_ANALYTICS_GET_METADATA，参数 property。 检查兼容性：GOOGLE_ANALYTICS_CHECK_COMPATIBILITY，参数 property、dimensions、metrics。 运行报告：GOOGLE_ANALYTICS_RUN_REPORT，参数 property、dateRanges、dimensions、metrics。 批量报告：GOOGLE_ANALYTICS_BATCH_RUN_REPORTS，参数 property、requests。 透视报告：GOOGLE_ANALYTICS_RUN_PIVOT_REPORT，参数 property、dateRanges、pivots。 漏斗报告：GOOGLE_ANALYTICS_RUN_FUNNEL_REPORT，参数 property、dateRanges、funnel。 列举关键事件：GOOGLE_ANALYTICS_LIST_KEY_EVENTS，参数 parent、pageSize。

适用场景

适用于需要对 GA4 进行自动化报告与媒体资源管理的场景，例如列举账户与资源、查询指标与维度、批量获取多份报告、制作透视交叉表、分析转化漏斗以及查看关键事件。