AGENT SKILL

googleads-automation

Automate Google Ads analytics tasks via Rube MCP (Composio): list Google Ads links, run GA4 reports, check compatibility, list properties and accounts. Always search tools first for current schemas.

License 许可
MIT
最近更新
2026-10-22
Stars
★ 0
Forks
0

01 前言 Front Matter

name
googleads-automation
requires
{ "mcp": [ "rube" ] }
description
Automate Google Ads analytics tasks via Rube MCP (Composio): list Google Ads links, run GA4 reports, check compatibility, list properties and accounts. Always search tools first for current schemas.

03 SKILL.md 正文

Google Ads Automation via Rube MCP

Access Google Ads data through Google Analytics integration, run performance reports, list linked Ads accounts, and analyze campaign metrics using Rube MCP (Composio).

Toolkit docs: composio.dev/toolkits/googleads

Prerequisites

  • Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
  • Active connection via RUBE_MANAGE_CONNECTIONS with toolkit google_analytics
  • Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

  1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
  2. Call RUBE_MANAGE_CONNECTIONS with toolkit google_analytics
  3. If connection is not ACTIVE, follow the returned auth link to complete setup
  4. Confirm connection status shows ACTIVE before running any workflows

Note: Google Ads data is accessed through the Google Analytics toolkit integration. The tools below use GA4 properties linked to Google Ads accounts.

Core Workflows

1. List Google Ads Links for a Property

Use GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS to retrieve all Google Ads account links configured for a GA4 property.

Tool: GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS
Parameters:
  - parent (required): Property resource name (format: "properties/{propertyId}")
  - pageSize: Max results (1-200, default 50)
  - pageToken: Pagination token

2. Run a GA4 Performance Report

Use GOOGLE_ANALYTICS_RUN_REPORT to run customized reports with dimensions, metrics, date ranges, and filters.

Tool: GOOGLE_ANALYTICS_RUN_REPORT
Parameters:
  - property (required): Property resource (format: "properties/{property_id}")
  - dimensions: Array of dimension objects (e.g., [{"name": "sessionCampaignName"}, {"name": "date"}])
  - metrics: Array of metric objects (e.g., [{"name": "sessions"}, {"name": "totalRevenue"}])
  - dateRanges: Array with startDate and endDate (e.g., [{"startDate": "2025-01-01", "endDate": "2025-01-31"}])
  - dimensionFilter: Filter by dimension values
  - metricFilter: Filter by metric values (applied after aggregation)
  - orderBys: Sort results
  - limit: Max rows to return (1-250000)

3. Check Dimension/Metric Compatibility

Use GOOGLE_ANALYTICS_CHECK_COMPATIBILITY to validate dimension and metric combinations before running a report.

Tool: GOOGLE_ANALYTICS_CHECK_COMPATIBILITY
Description: Validates compatibility of chosen dimensions or metrics
  before running a report.
Note: Call RUBE_SEARCH_TOOLS to get the full schema for this tool.

4. List GA4 Accounts

Use GOOGLE_ANALYTICS_LIST_ACCOUNTS to enumerate all accessible Google Analytics accounts.

Tool: GOOGLE_ANALYTICS_LIST_ACCOUNTS
Parameters:
  - pageSize: Max accounts to return
  - pageToken: Pagination token
  - showDeleted: Include soft-deleted accounts

5. List GA4 Properties Under an Account

Use GOOGLE_ANALYTICS_LIST_PROPERTIES to list properties for a specific GA4 account.

Tool: GOOGLE_ANALYTICS_LIST_PROPERTIES
Parameters:
  - account (required): Account resource name (format: "accounts/{account_id}")
  - pageSize: Max properties (1-200)
  - pageToken: Pagination token
  - showDeleted: Include trashed properties

6. Get Available Dimensions and Metrics

Use GOOGLE_ANALYTICS_GET_METADATA to discover all available fields for building reports.

Tool: GOOGLE_ANALYTICS_GET_METADATA
Description: Gets metadata for dimensions, metrics, and comparisons
  for a GA4 property.
Note: Call RUBE_SEARCH_TOOLS to get the full schema for this tool.

Common Patterns

  • Discover then report: Use GOOGLE_ANALYTICS_LIST_ACCOUNTS to find account IDs, then GOOGLE_ANALYTICS_LIST_PROPERTIES to find property IDs, then GOOGLE_ANALYTICS_RUN_REPORT to pull data.
  • Validate before querying: Use GOOGLE_ANALYTICS_CHECK_COMPATIBILITY to validate dimension/metric combinations before running reports to avoid 400 errors.
  • Campaign performance: Run reports with dimensions like sessionCampaignName, sessionSource, sessionMedium and metrics like sessions, activeUsers, totalRevenue.
  • Ads link discovery: Use GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS to find which Google Ads accounts are linked to each GA4 property.
  • Field discovery: Use GOOGLE_ANALYTICS_GET_METADATA to list all available dimensions and metrics before constructing complex reports.

Known Pitfalls

  • Dimension/metric compatibility: The GA4 API has strict compatibility rules. Not all dimensions can be combined with all metrics. Demographic dimensions (e.g., userAgeBracket, userGender) are often incompatible with session-scoped dimensions/filters (e.g., sessionCampaignName, sessionSource).
  • dateRange is NOT a dimension: Do not include dateRange in the dimensions array. Use date, dateHour, year, month, or week instead.
  • exits is NOT valid: Neither exits as a dimension nor as a metric is valid in GA4.
  • Property ID format: Must be properties/{numeric_id} (e.g., properties/123456789). Do not use Google Account IDs (long OAuth IDs).
  • Account ID format: Must be accounts/{numeric_id} where the numeric ID is 6-10 digits.
  • Filter separation: Use dimensionFilter only for dimension fields and metricFilter only for metric fields. Mixing them will cause errors.
  • Max 9 dimensions and 10 metrics per report request.

Quick Reference

Action Tool Key Parameters
List Ads links GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS parent
Run report GOOGLE_ANALYTICS_RUN_REPORT property, dimensions, metrics, dateRanges
Check compatibility GOOGLE_ANALYTICS_CHECK_COMPATIBILITY (see full schema via RUBE_SEARCH_TOOLS)
List accounts GOOGLE_ANALYTICS_LIST_ACCOUNTS pageSize
List properties GOOGLE_ANALYTICS_LIST_PROPERTIES account, pageSize
Get metadata GOOGLE_ANALYTICS_GET_METADATA (see full schema via RUBE_SEARCH_TOOLS)

Powered by Composio

04 同仓库更多 Skills

wsmsistemassuporte
wsmsistemassuporte/SISTEMAS-INTEGRADOS

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

★ 0
wsmsistemassuporte
wsmsistemassuporte/SISTEMAS-INTEGRADOS

youtube-downloader

Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

★ 0
wsmsistemassuporte
wsmsistemassuporte/SISTEMAS-INTEGRADOS

theme-factory

Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.

★ 0
wsmsistemassuporte
wsmsistemassuporte/SISTEMAS-INTEGRADOS

template-skill

Replace with description of the skill and when Claude should use it.

★ 0
wsmsistemassuporte
wsmsistemassuporte/SISTEMAS-INTEGRADOS

tailored-resume-generator

Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances

★ 0
wsmsistemassuporte
wsmsistemassuporte/SISTEMAS-INTEGRADOS

slack-gif-creator

Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like "make me a GIF for Slack of X doing Y".

★ 0