Conector Google Ads

Conecte o Google Ads ao Brevo através do Tajo para sincronizar audiências de publicidade, importar dados de conversão e criar perfis de cliente unificados que conectam aquisição paga com marketing de ciclo de vida.

Visão geral

Recursos

• Sincronização Customer Match - Faça upload de listas de contatos do Brevo para o Google Ads como audiências Customer Match
• Rastreamento de conversões - Importe conversões offline de eventos do Brevo para o Google Ads
• Sincronização de audiência - Sincronização bidirecional entre listas do Brevo e audiências do Google Ads
• Relatórios de campanha - Traga dados de desempenho de campanha para os dashboards do Tajo
• Rastreamento de GCLID - Capture Google Click IDs para atribuição de conversão offline
• Dados de smart bidding - Envie dados de valor de conversão de volta ao Google para otimização de lance
• Sincronização de formulários de lead - Importe submissões de formulários de lead do Google Ads para contatos do Brevo

Pré-requisitos

Antes de começar, certifique-se de ter:

1. Uma conta Google Ads com acesso à API habilitado
2. Um projeto Google Cloud com a Google Ads API habilitada
3. Credenciais OAuth 2.0 (Client ID e Client Secret)
4. Um Google Ads Developer Token (solicite em Google Ads API Center)
5. Uma conta Brevo com acesso à API
6. Uma conta Tajo com credenciais de API

Autenticação

OAuth 2.0

A Google Ads API usa OAuth 2.0 para autenticação. Você precisa obter um refresh token através do fluxo de consentimento OAuth.

# Required OAuth scopes
https://www.googleapis.com/auth/adwords

Developer Token

Um Developer Token é necessário para todas as requisições da Google Ads API e deve ser aprovado pelo Google.

# Set up authentication headers
curl -X POST https://googleads.googleapis.com/v18/customers/1234567890/googleAds:search \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "developer-token: DEVELOPER_TOKEN" \
  -H "login-customer-id: MANAGER_ACCOUNT_ID"

Configuração

Configuração básica

connectors:
  google_ads:
    enabled: true
    developer_token: "your-developer-token"
    oauth:
      client_id: "your-client-id"
      client_secret: "your-client-secret"
      refresh_token: "your-refresh-token"
    customer_id: "123-456-7890"
    login_customer_id: "111-222-3333"  # Manager account (optional)

    # Data sync options
    sync:
      customer_match: true
      conversions: true
      campaigns: true
      lead_forms: true

    # Conversion tracking
    conversions:
      action_id: "123456789"
      default_currency: "USD"

Configuração Customer Match

Faça upload de contatos do Brevo como audiências do Google Ads:

customer_match:
  enabled: true
  lists:
    - brevo_list_id: 5
      audience_name: "All Customers"
      match_type: "CONTACT_INFO"
    - brevo_list_id: 7
      audience_name: "High Value Customers"
      match_type: "CONTACT_INFO"

  # Data fields to match
  match_fields:
    - email
    - phone
    - first_name
    - last_name
    - country_code
    - zip_code

  # Sync schedule
  schedule: "daily"
  sync_mode: "mirror"  # mirror, append, or remove

Importação de conversões offline

conversion_import:
  enabled: true
  conversion_action: "purchase"
  gclid_attribute: "GCLID"  # Brevo attribute storing GCLID
  conversion_events:
    - brevo_event: "order_completed"
      conversion_name: "Purchase"
      value_field: "revenue"
    - brevo_event: "subscription_created"
      conversion_name: "Subscription"
      value_field: "plan_value"

Endpoints da API

Exemplos de código

Inicializar o conector Google Ads

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Google Ads account
await tajo.connectors.connect('google-ads', {
  developerToken: process.env.GOOGLE_ADS_DEV_TOKEN,
  clientId: process.env.GOOGLE_OAUTH_CLIENT_ID,
  clientSecret: process.env.GOOGLE_OAUTH_CLIENT_SECRET,
  refreshToken: process.env.GOOGLE_OAUTH_REFRESH_TOKEN,
  customerId: '123-456-7890'
});

Fazer upload de audiência Customer Match

// Sync a Brevo list to Google Ads Customer Match
await tajo.connectors.syncAudience('google-ads', {
  brevoListId: 5,
  audienceName: 'High Value Customers',
  matchType: 'CONTACT_INFO',
  syncMode: 'mirror'
});

Importar conversões offline

// Upload offline conversions from Brevo order events
await tajo.connectors.uploadConversions('google-ads', {
  conversionAction: 'customers/123456/conversionActions/789',
  conversions: [
    {
      gclid: 'CjwKCAiA...',
      conversionDateTime: '2024-01-15 10:30:00-05:00',
      conversionValue: 89.99,
      currencyCode: 'USD'
    }
  ]
});

Consultar desempenho de campanha (GAQL)

// Query campaign metrics using Google Ads Query Language
const query = `
  SELECT
    campaign.name,
    campaign.status,
    metrics.impressions,
    metrics.clicks,
    metrics.cost_micros,
    metrics.conversions
  FROM campaign
  WHERE segments.date DURING LAST_30_DAYS
  ORDER BY metrics.impressions DESC
  LIMIT 20
`;

const results = await tajo.connectors.query('google-ads', { gaql: query });

Limites de taxa

Solução de problemas

Melhores práticas

1. Use uma conta Manager - Gerencie várias contas Ads através de uma única conta Manager (MCC)
2. Faça hash dos dados do Customer Match - Sempre aplique SHA-256 em PII antes de fazer upload para Customer Match
3. Rastreie GCLIDs - Armazene Google Click IDs em atributos do Brevo para rastreamento de conversão offline
4. Agrupe uploads de conversão em lote - Agrupe conversões em lotes diários em vez de uploads em tempo real
5. Use GAQL para relatórios - Aproveite a Google Ads Query Language para relatórios flexíveis de campanha
6. Monitore as taxas de correspondência - Acompanhe as taxas de correspondência de audiências Customer Match e melhore a qualidade dos dados
7. Configure Enhanced Conversions - Use Enhanced Conversions para medição de conversão mais precisa

Segurança

• OAuth 2.0 - Autenticação segura baseada em token com refresh tokens
• Hashing SHA-256 - Dados do Customer Match são hasheados antes do upload
• Minimização de dados - Apenas campos obrigatórios são transmitidos ao Google
• Conformidade Google Cloud - SOC 2, ISO 27001 e GDPR compatíveis
• Acesso com escopo - Permissões de API com escopo para contas de cliente específicas
• Log de auditoria - Todas as requisições de API são registradas no histórico de alterações do Google Ads

Recursos relacionados

• Conector Meta Ads
• Conector Klaviyo
• Conector Brevo
• Skill de sincronização de clientes