Automação do Google Ads via Rube MCP

Acesse dados do Google Ads através da integração com o Google Analytics, execute relatórios de desempenho, liste contas de anúncios vinculadas e analise métricas de campanha usando Rube MCP (Composio).

Documentação do Toolkit: composio.dev/toolkits/googleads

Pré-requisitos

• Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa via RUBE_MANAGE_CONNECTIONS com o toolkit google_analytics
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit google_analytics
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a configuração
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Observação: Os dados do Google Ads são acessados através da integração do toolkit do Google Analytics. As ferramentas abaixo usam propriedades GA4 vinculadas a contas do Google Ads.

Fluxos de Trabalho Principais

1. Listar Links do Google Ads para uma Propriedade

Use GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS para recuperar todas as contas do Google Ads vinculadas configuradas para uma propriedade GA4.

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. Executar um Relatório de Desempenho do GA4

Use GOOGLE_ANALYTICS_RUN_REPORT para executar relatórios personalizados com dimensões, métricas, intervalos de datas e filtros.

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. Verificar Compatibilidade de Dimensão/Métrica

Use GOOGLE_ANALYTICS_CHECK_COMPATIBILITY para validar combinações de dimensões e métricas antes de executar um relatório.

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. Listar Contas do GA4

Use GOOGLE_ANALYTICS_LIST_ACCOUNTS para enumerar todas as contas do Google Analytics acessíveis.

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

5. Listar Propriedades do GA4 em uma Conta

Use GOOGLE_ANALYTICS_LIST_PROPERTIES para listar propriedades de uma conta GA4 específica.

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. Obter Dimensões e Métricas Disponíveis

Use GOOGLE_ANALYTICS_GET_METADATA para descobrir todos os campos disponíveis para a criação de relatórios.

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.

Padrões Comuns

• Descobrir e depois relatar: Use GOOGLE_ANALYTICS_LIST_ACCOUNTS para encontrar IDs de conta, depois GOOGLE_ANALYTICS_LIST_PROPERTIES para encontrar IDs de propriedade, depois GOOGLE_ANALYTICS_RUN_REPORT para extrair dados.
• Validar antes de consultar: Use GOOGLE_ANALYTICS_CHECK_COMPATIBILITY para validar combinações de dimensões/métricas antes de executar relatórios para evitar erros 400.
• Desempenho da campanha: Execute relatórios com dimensões como sessionCampaignName, sessionSource, sessionMedium e métricas como sessions, activeUsers, totalRevenue.
• Descoberta de links de anúncios: Use GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS para descobrir quais contas do Google Ads estão vinculadas a cada propriedade GA4.

…