Conector Google Ads

Conectați Google Ads la Brevo prin Tajo pentru a sincroniza audiențele publicitare, a importa datele de conversie și a crea profiluri unificate ale clienților care leagă achiziția plătită de marketingul ciclului de viață.

Prezentare generală

Funcționalități

• Sincronizare Customer Match - Încărcați listele de contacte Brevo ca audiențe Customer Match în Google Ads
• Urmărire conversii - Importați conversii offline din evenimentele Brevo în Google Ads
• Sincronizare audiențe - Sincronizare bidirecțională între listele Brevo și audiențele Google Ads
• Raportare campanii - Extrageți datele de performanță ale campaniilor în tablourile de bord Tajo
• Urmărire GCLID - Capturați ID-urile de clic Google pentru atribuirea conversiilor offline
• Date Smart Bidding - Transmiteți înapoi datele valorii conversiei la Google pentru optimizarea licitațiilor
• Sincronizare formulare lead - Importați trimiterile formularelor lead Google Ads în contactele Brevo

Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

1. Un cont Google Ads cu acces API activat
2. Un proiect Google Cloud cu API-ul Google Ads activat
3. Credențiale OAuth 2.0 (Client ID și Client Secret)
4. Un Developer Token Google Ads (aplicați la Google Ads API Center)
5. Un cont Brevo cu acces API
6. Un cont Tajo cu credențiale API

Autentificare

OAuth 2.0

API-ul Google Ads utilizează OAuth 2.0 pentru autentificare. Trebuie să obțineți un refresh token prin fluxul de consimțământ OAuth.

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

Developer Token

Un Developer Token este necesar pentru toate cererile API Google Ads și trebuie aprobat de 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"

Configurare

Configurare de bază

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"

Configurare Customer Match

Încărcați contactele Brevo ca audiențe 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

Import conversii 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"

Puncte finale API

Exemple de cod

Inițializare 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'
});

Încărcare audiență 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'
});

Import conversii 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'
    }
  ]
});

Interogare performanță campanie (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 });

Limite de rată

Depanare

Bune practici

1. Utilizați un cont Manager - Gestionați mai multe conturi Ads printr-un singur cont Manager (MCC)
2. Hash-uiți datele Customer Match - Hash SHA-256 întotdeauna PII înainte de încărcarea în Customer Match
3. Urmăriți GCLID-urile - Stocați ID-urile de clic Google în atributele Brevo pentru urmărirea conversiilor offline
4. Grupați încărcările de conversii - Grupați conversiile în loturi zilnice, nu încărcări în timp real
5. Utilizați GAQL pentru raportare - Valorificați Google Ads Query Language pentru raportare flexibilă a campaniilor
6. Monitorizați ratele de potrivire - Urmăriți ratele de potrivire ale audiențelor Customer Match și îmbunătățiți calitatea datelor
7. Configurați Enhanced Conversions - Utilizați Enhanced Conversions pentru măsurarea mai precisă a conversiilor

Securitate

• OAuth 2.0 - Autentificare securizată bazată pe token cu refresh token-uri
• Hash SHA-256 - Datele Customer Match sunt hash-uite înainte de încărcare
• Minimizare date - Numai câmpurile necesare sunt transmise la Google
• Conformitate Google Cloud - Conformitate SOC 2, ISO 27001 și GDPR
• Acces cu scope - Permisiuni API cu scope pentru conturi de client specifice
• Jurnalizare audit - Toate cererile API înregistrate în istoricul modificărilor Google Ads

Resurse conexe

• Conector Meta Ads
• Conector Klaviyo
• Conector Brevo
• Skill Sincronizare clienți