---

name: google-analytics-automation description: "通过Rube MCP（Composio）自动化Google Analytics任务：运行报告、列出账户/属性、漏斗、数据透视、关键事件。始终先搜索工具以获取当前模式。" risk: critical source: community date_added: "2026-02-27"

通过Rube MCP实现Google Analytics自动化

通过Composio的Google Analytics工具包，经由Rube MCP自动化Google Analytics 4（GA4）报告和属性管理。

前提条件

• Rube MCP必须已连接（RUBE_SEARCH_TOOLS可用）
• 通过RUBE_MANAGE_CONNECTIONS使用工具包google_analytics建立活跃的Google Analytics连接
• 始终先调用RUBE_SEARCH_TOOLS获取当前工具模式

设置

获取Rube MCP：在你的客户端配置中添加https://rube.app/mcp作为MCP服务器。无需API密钥——只需添加端点即可使用。

1. 通过确认RUBE_SEARCH_TOOLS响应来验证Rube MCP可用
2. 使用工具包google_analytics调用RUBE_MANAGE_CONNECTIONS
3. 如果连接不是ACTIVE状态，按照返回的认证链接完成Google OAuth
4. 在运行任何工作流之前确认连接状态显示ACTIVE

核心工作流

1. 列出账户和属性

使用场景：用户想要发现可用的GA4账户和属性

工具序列：

1. GOOGLE_ANALYTICS_LIST_ACCOUNTS - 列出所有可访问的GA4账户 [必需]
2. GOOGLE_ANALYTICS_LIST_PROPERTIES - 列出账户下的属性 [必需]

关键参数：

• pageSize：每页结果数
• pageToken：上一响应的分页令牌
• filter：属性的过滤表达式（例如parent:accounts/12345）

注意事项：

• 属性ID是带'properties/'前缀的数字字符串（例如'properties/123456'）
• 账户ID带'accounts/'前缀（例如'accounts/12345'）
• 始终先列出账户，然后列出每个账户下的属性
• 拥有多个属性的组织需要分页

2. 运行标准报告

使用场景：用户想要从GA4数据中查询指标和维度

工具序列：

1. GOOGLE_ANALYTICS_LIST_PROPERTIES - 获取属性ID [前提]
2. GOOGLE_ANALYTICS_GET_METADATA - 发现可用的维度和指标 [可选]
3. GOOGLE_ANALYTICS_CHECK_COMPATIBILITY - 验证维度/指标兼容性 [可选]
4. GOOGLE_ANALYTICS_RUN_REPORT - 执行报告查询 [必需]

关键参数：

• property：属性ID（例如'properties/123456'）
• dateRanges：包含startDate和endDate的日期范围对象数组
• dimensions：包含name字段的维度对象数组
• metrics：包含name字段的指标对象数组
• dimensionFilter / metricFilter：过滤表达式
• orderBys：排序配置
• limit：返回的最大行数
• offset：分页的行偏移量

注意事项：

• 日期格式为'YYYY-MM-DD'或相对值如'today'、'yesterday'、'7daysAgo'、'30daysAgo'
• 并非所有维度和指标都兼容；先使用CHECK_COMPATIBILITY
• 使用GET_METADATA发现有效的维度和指标名称
• 每个报告请求最多9个维度
• 行限制默认值各异；对大数据集应明确设置
• offset用于结果分页，不是日期分页

3. 运行批量报告

使用场景：用户需要在一次调用中从同一属性获取多个不同报告

工具序列：

1. GOOGLE_ANALYTICS_LIST_PROPERTIES - 获取属性ID [前提]
2. GOOGLE_ANALYTICS_BATCH_RUN_REPORTS - 一次执行多个报告 [必需]

关键参数：

• property：属性ID（必需）
• requests：单个报告请求对象数组（与RUN_REPORT结构相同）

注意事项：

• 每次批量调用最多5个报告请求
• 批量中的所有报告必须针对同一属性
• 每个单独报告与RUN_REPORT具有相同的维度/指标限制
• 批量错误可能影响所有报告；检查各个报告响应

4. 运行数据透视报告

使用场景：用户想要交叉表格数据（行与列），类似数据透视表

工具序列：

1. GOOGLE_ANALYTICS_LIST_PROPERTIES - 获取属性ID [前提]
2. GOOGLE_ANALYTICS_RUN_PIVOT_REPORT - 执行数据透视报告 [必需]

关键参数：

• property：属性ID（必需）
• dateRanges：日期范围对象
• dimensions：任何透视中使用的所有维度
• metrics：要聚合的指标
• pivots：包含fieldNames、limit和orderBys的透视定义数组

注意事项：

• 透视中使用的维度也必须列在顶层dimensions中
• 透视的fieldNames引用顶层列表中的维度名称
• 具有多个维度的复杂透视可能产生非常大的结果集
• 每个透视有自己独立的limit和orderBys

5. 运行漏斗报告

使用场景：用户想要分析转化漏斗和流失率

工具序列：

1. GOOGLE_ANALYTICS_LIST_PROPERTIES - 获取属性ID [前提]
2. GOOGLE_ANALYTICS_RUN_FUNNEL_REPORT - 执行漏斗报告 [必需]