技能介绍

要解决什么问题

在 Agent 里直接查 Google Ads 投放效果，往往卡在 OAuth、API 选型以及 GA4 与 Ads 账号的关联关系上。本技能通过 Rube MCP（Composio） 走 Google Analytics 工具包：在 GA4 属性已关联 Google Ads 的前提下，列出关联账户、拉自定义维度/指标报表，并在查询前校验字段组合是否合法。

核心能力与典型流程

使用前需确认 RUBE_SEARCH_TOOLS 可用，并通过 RUBE_MANAGE_CONNECTIONS 将 google_analytics 连接置为 ACTIVE（未完成授权时按返回链接完成绑定）。

常见工作流包括：

用 GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS 查看某 GA4 属性下绑定的 Ads 账户
用 GOOGLE_ANALYTICS_LIST_ACCOUNTS / GOOGLE_ANALYTICS_LIST_PROPERTIES 逐级拿到 accounts/{id} 与 properties/{id}
用 GOOGLE_ANALYTICS_GET_METADATA 发现可用维度与指标，再用 GOOGLE_ANALYTICS_CHECK_COMPATIBILITY 避免不兼容组合导致 400
用 GOOGLE_ANALYTICS_RUN_REPORT 按日期范围、维度和指标拉数（例如 sessionCampaignName、sessions、totalRevenue 等）

推荐模式是 先发现再报表：账户 → 属性 → 元数据/兼容性检查 → RUN_REPORT。

边界与坑点

Ads 数据不是独立 Ads API 直连，而是依赖 GA4 与 Google Ads 的链接；未关联的属性看不到对应投放侧上下文。

GA4 Reporting API 对维度/指标组合很严格：人口统计类维度常与会话级维度（如 sessionCampaignName）冲突；dateRange 不能放进 dimensions，应使用 date、dateHour 等；exits 在 GA4 中无效。单次请求最多 9 个维度、10 个指标；dimensionFilter 与 metricFilter 不可混用。属性 ID 必须是 properties/{数字}，不要用 OAuth 长账号 ID。