SuperAPI AI 工具集

googleads-automation

智能体与模型

查看项目

更新于 10-15 20:25

技能介绍

用途:该技能用于通过 Rube MCP(Composio)访问 Google Analytics 数据,进而完成与 Google Ads 相关联的分析任务,例如查看 GA4 属性关联的 Google Ads 账户链接,以及运行 GA4 性能报告分析广告系列指标。工具包文档见 composio.dev/toolkits/googleads。

前置条件:Rube MCP 必须已连接且 RUBE_SEARCH_TOOLS 可用;需通过 RUBE_MANAGE_CONNECTIONS 使用 google_analytics 工具包建立有效连接;始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。配置方式为在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器,无需 API key。随后确认 RUBE_SEARCH_TOOLS 响应,调用 RUBE_MANAGE_CONNECTIONS(toolkit 为 google_analytics),若连接非 ACTIVE 则按返回的授权链接完成设置,确认状态为 ACTIVE 后再运行工作流。

主要能力与用法:1)列出属性关联的 Ads 链接,使用 GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS,必填 parent(格式 properties/{propertyId}),可选 pageSize、pageToken。2)运行 GA4 报告,使用 GOOGLE_ANALYTICS_RUN_REPORT,必填 property,另需 dimensions、metrics、dateRanges,以及可选的 dimensionFilter、metricFilter、orderBys、limit。3)检查兼容性,使用 GOOGLE_ANALYTICS_CHECK_COMPATIBILITY 验证维度与指标组合,避免 400 错误。4)列出 GA4 账户,使用 GOOGLE_ANALYTICS_LIST_ACCOUNTS。5)列出账户下的属性,使用 GOOGLE_ANALYTICS_LIST_PROPERTIES,必填 account(格式 accounts/{account_id})。6)获取可用维度与指标,使用 GOOGLE_ANALYTICS_GET_METADATA。

常见模式:先发现后报告(先列账户与属性,再运行报告);查询前先做兼容性校验;用 sessionCampaignName、sessionSource、sessionMedium 等维度配合 sessions、activeUsers、totalRevenue 指标分析广告系列表现。

已知限制:GA4 API 对维度与指标组合有严格兼容规则,人口统计维度常与会话级维度或筛选不兼容;dateRange 不是维度,应使用 date、dateHour、year、month 或 week;exits 在 GA4 中既非有效维度也非有效指标;属性 ID 必须为 properties/{numeric_id},账户 ID 必须为 accounts/{numeric_id}(6-10 位数字);dimensionFilter 仅用于维度字段,metricFilter 仅用于指标字段,混用会报错;单次报告最多 9 个维度与 10 个指标。Google Ads 数据通过 Google Analytics 工具包集成访问,使用与 Google Ads 账户关联的 GA4 属性。