名称: googleads-自动化描述: “通过Rube MCP (Composio)自动化Google Ads分析任务：列出Google Ads链接、运行GA4报告、检查兼容性、列出属性和账户。始终首先搜索工具以获取当前模式。” 要求: mcp: [rube]

通过Rube MCP实现Google Ads自动化

通过Google Analytics集成访问Google Ads数据，运行性能报告，列出关联的Ads账户，并使用Rube MCP (Composio)分析广告系列指标。

工具包文档: composio.dev/toolkits/googleads

先决条件

Rube MCP必须已连接（RUBE_SEARCH_TOOLS可用）
通过RUBE_MANAGE_CONNECTIONS与工具包google_analytics建立活动连接
始终首先调用RUBE_SEARCH_TOOLS以获取当前工具模式

设置

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

通过确认RUBE_SEARCH_TOOLS响应来验证Rube MCP可用
使用工具包google_analytics调用RUBE_MANAGE_CONNECTIONS
如果连接未激活，请按照返回的认证链接完成设置
在运行任何工作流之前，确认连接状态显示为ACTIVE

注意: Google Ads数据通过Google Analytics工具包集成访问。以下工具使用关联到Google Ads账户的GA4属性。

核心工作流

1. 列出属性的Google Ads链接

使用GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS检索为GA4属性配置的所有Google Ads账户链接。

工具: GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS
参数:
  - parent（必需）: 属性资源名称（格式: "properties/{propertyId}"）
  - pageSize: 最大结果数（1-200，默认50）
  - pageToken: 分页令牌

2. 运行GA4性能报告

使用GOOGLE_ANALYTICS_RUN_REPORT运行自定义报告，包括维度、指标、日期范围和过滤器。

工具: GOOGLE_ANALYTICS_RUN_REPORT
参数:
  - property（必需）: 属性资源（格式: "properties/{property_id}"）
  - dimensions: 维度对象数组（例如: [{"name": "sessionCampaignName"}, {"name": "date"}]）
  - metrics: 指标对象数组（例如: [{"name": "sessions"}, {"name": "totalRevenue"}]）
  - dateRanges: 包含startDate和endDate的数组（例如: [{"startDate": "2025-01-01", "endDate": "2025-01-31"}]）
  - dimensionFilter: 按维度值过滤
  - metricFilter: 按指标值过滤（聚合后应用）
  - orderBys: 排序结果
  - limit: 返回的最大行数（1-250000）

3. 检查维度/指标兼容性

使用GOOGLE_ANALYTICS_CHECK_COMPATIBILITY在运行报告前验证维度和指标组合。

工具: GOOGLE_ANALYTICS_CHECK_COMPATIBILITY
描述: 在运行报告前验证所选维度或指标的兼容性。
注意: 调用RUBE_SEARCH_TOOLS以获取此工具的完整模式。

4. 列出GA4账户

使用GOOGLE_ANALYTICS_LIST_ACCOUNTS枚举所有可访问的Google Analytics账户。

工具: GOOGLE_ANALYTICS_LIST_ACCOUNTS
参数:
  - pageSize: 要返回的最大账户数
  - pageToken: 分页令牌
  - showDeleted: 包括软删除的账户

5. 列出账户下的GA4属性

使用GOOGLE_ANALYTICS_LIST_PROPERTIES列出特定GA4账户的属性。

工具: GOOGLE_ANALYTICS_LIST_PROPERTIES
参数:
  - account（必需）: 账户资源名称（格式: "accounts/{account_id}"）
  - pageSize: 最大属性数（1-200）
  - pageToken: 分页令牌
  - showDeleted: 包括已删除的属性

6. 获取可用维度和指标

使用GOOGLE_ANALYTICS_GET_METADATA发现所有可用于构建报告的字段。

工具: GOOGLE_ANALYTICS_GET_METADATA
描述: 获取GA4属性的维度、指标和比较的元数据。
注意: 调用RUBE_SEARCH_TOOLS以获取此工具的完整模式。

常见模式

先发现后报告: 使用GOOGLE_ANALYTICS_LIST_ACCOUNTS查找账户ID，然后GOOGLE_ANALYTICS_LIST_PROPERTIES查找属性ID，最后GOOGLE_ANALYTICS_RUN_REPORT拉取数据。
查询前验证: 使用GOOGLE_ANALYTICS_CHECK_COMPATIBILITY在运行报告前验证维度/指标组合，以避免400错误。
广告系列性能: 运行包含维度如sessionCampaignName、sessionSource、sessionMedium和指标如sessions、activeUsers、totalRevenue的报告。
Ads链接发现: 使用GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS查找哪些Google Ads账户关联到每个GA4属性。
字段发现: 使用GOOGLE_ANALYTICS_GET_METADATA在构建复杂报告前列出所有可用维度和指标。

已知陷阱

维度/指标兼容性: GA4 API有严格的兼容性规则。并非所有维度都能与所有指标组合。人口统计维度（例如userAgeBracket、userGender）通常与会话范围维度/过滤器（例如sessionCampaignName、sessionSource）不兼容。
dateRange不是维度: 不要在维度数组中包含dateRange。使用date、dateHour、year、month或week代替。
exits无效: exits作为维度或指标在GA4中均无效。
属性ID格式: 必须是properties/{numeric_id}（例如properties/123456789）。不要使用Google账户ID（长OAuth ID）。
账户ID格式: 必须是accounts/{numeric_id}，其中数字ID为6-10位。
过滤器分离: 仅对维度字段使用dimensionFilter，仅对指标字段使用metricFilter。混合使用将导致错误。
每个报告请求最多9个维度和10个指标。

快速参考

操作	工具	关键参数
列出Ads链接	`GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS`	`parent`
运行报告	`GOOGLE_ANALYTICS_RUN_REPORT`	`property`、`dimensions`、`metrics`、`dateRanges`
检查兼容性	`GOOGLE_ANALYTICS_CHECK_COMPATIBILITY`	（通过RUBE_SEARCH_TOOLS查看完整模式）
列出账户	`GOOGLE_ANALYTICS_LIST_ACCOUNTS`	`pageSize`
列出属性	`GOOGLE_ANALYTICS_LIST_PROPERTIES`	`account`、`pageSize`
获取元数据	`GOOGLE_ANALYTICS_GET_METADATA`	（通过RUBE_SEARCH_TOOLS查看完整模式）

由Composio提供支持

名称: googleads-自动化 描述: “通过Rube MCP (Composio)自动化Google Ads分析任务：列出Google Ads链接、运行GA4报告、检查兼容性、列出属性和账户。始终首先搜索工具以获取当前模式。” 要求: mcp: [rube]