PromptShop

Googleads Automation

This skill automates Google Ads data access and reporting through the Google Analytics integration using Rube MCP.

Install

npx promptshop add googleads-automation

Details

What This Skill Does

This skill automates Google Ads data access and reporting through the Google Analytics integration using Rube MCP. It allows users to list linked Ads accounts, run performance reports, and analyze campaign metrics. It's designed for marketers and analysts who need to automate Google Ads reporting.

When to Use

List linked Google Ads accounts. Run GA4 performance reports. Analyze campaign metrics. Access Google Ads data via GA4. Automate Google Ads reporting. Discover available Google Analytics tools.

Key Features

Automates Google Ads data access via Rube MCP. Uses Google Analytics toolkit integration. Requires an active Google Analytics connection. Lists Google Ads links for a property. Runs customized GA4 performance reports. Analyzes campaign metrics with dimensions and metrics.

Manual Installation

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. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds Call RUBE_MANAGE_CONNECTIONS with toolkit google_analytics If connection is not ACTIVE, follow the returned auth link to complete setup 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/{property Id}")
  • page Size: Max results (1-200, default 50)
  • page Token: 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

  • property (required): Property resource (format: "properties/{property_id}")
  • dimensions: Array of dimension objects (e.g., [{"name": "session Campaign Name"}, {"name": "date"}])
  • metrics: Array of metric objects (e.g., [{"name": "sessions"}, {"name": "total Revenue"}])
  • date Ranges: Array with start Date and end Date (e.g., [{"start Date": "2025-01-01", "end Date": "2025-01-31"}])
  • dimension Filter: Filter by dimension values
  • metric Filter: Filter by metric values (applied after aggregation)
  • order Bys: 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

  • page Size: Max accounts to return
  • show Deleted: 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

  • account (required): Account resource name (format: "accounts/{account_id}")
  • page Size: Max properties (1-200)
  • show Deleted: 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.

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 session Campaign Name, session Source, session Medium and metrics like sessions, active Users, total Revenue. 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., user Age Bracket, user Gender) are often incompatible with session-scoped dimensions/filters (e.g., session Campaign Name, session Source). date Range is NOT a dimension: Do not include date Range in the dimensions array. Use date, date Hour, 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 dimension Filter only for dimension fields and metric Filter only for metric fields. Mixing them will cause errors. Max 9 dimensions and 10 metrics per report request.

Quick Reference

ActionToolKey Parameters
List Ads linksGOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADSparent
Run reportGOOGLE_ANALYTICS_RUN_REPORTproperty, dimensions, metrics, date Ranges
Check compatibilityGOOGLE_ANALYTICS_CHECK_COMPATIBILITY(see full schema via RUBE_SEARCH_TOOLS)
List accountsGOOGLE_ANALYTICS_LIST_ACCOUNTSpage Size
List propertiesGOOGLE_ANALYTICS_LIST_PROPERTIESaccount, page Size
Get metadataGOOGLE_ANALYTICS_GET_METADATA(see full schema via RUBE_SEARCH_TOOLS)

Powered by Composio