Google Ads konektor

Poveži Google Ads sa Brevo putem Tajo da sinhronizuješ reklamne publike, uvozuješ podatke o konverzijama i kreiraj unifikovane profile kupaca koji premošćuju plaćenu akviziciju sa marketing automatizacijom životnog ciklusa.

Pregled

Karakteristike

• Sinhronizacija Customer Match - Upload Brevo lista kontakata u Google Ads kao Customer Match publike
• Praćenje konverzija - Uvoz offline konverzija iz Brevo događaja u Google Ads
• Sinhronizacija publike - Dvosmerna sinhronizacija između Brevo lista i Google Ads publike
• Izveštavanje o kampanjama - Povlačenje podataka o performansama kampanja u Tajo dashboard-e
• Praćenje GCLID-a - Hvatanje Google Click ID-ova za atribuciju offline konverzija
• Podaci za pametno licitiranje - Vraćanje podataka o vrednosti konverzija u Google za optimizaciju licitiranja
• Sinhronizacija formulara za potencijalne kupce - Uvoz Google Ads formulara za potencijalne kupce u Brevo kontakte

Preduslovi

Pre nego što započneš, proveri da imaš:

1. Google Ads nalog sa omogućenim API pristupom
2. Google Cloud projekat sa omogućenim Google Ads API-jem
3. OAuth 2.0 akreditive (Client ID i Client Secret)
4. Google Ads Developer Token (aplicirati na Google Ads API Center)
5. Brevo nalog sa API pristupom
6. Tajo nalog sa API akreditivima

Autentifikacija

OAuth 2.0

Google Ads API koristi OAuth 2.0 za autentifikaciju. Moraš da dobiješ refresh token kroz OAuth consent tok.

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

Developer Token

Developer Token je potreban za sve Google Ads API zahteve i mora biti odobren od strane 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"

Konfiguracija

Osnovno podešavanje

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"

Konfiguracija Customer Match

Upload Brevo kontakata kao Google Ads publike:

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

Uvoz offline konverzija

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"

API endpointi

Primeri koda

Inicijalizacija Google Ads konektora

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

Upload Customer Match publike

// 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'
});

Uvoz offline konverzija

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

Upit o performansama kampanje (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 });

Ograničenja brzine

Rešavanje problema

Najbolje prakse

1. Koristi Manager nalog - Upravljaj više Ads naloga putem jednog Manager (MCC) naloga
2. Hašuj Customer Match podatke - Uvek SHA-256 hašuj PII pre uploada na Customer Match
3. Prati GCLID-ove - Čuvaj Google Click ID-ove u Brevo atributima za praćenje offline konverzija
4. Grupiši upload konverzija - Grupiši konverzije u dnevne batch-eve umesto upload-ova u realnom vremenu
5. Koristi GAQL za izveštavanje - Iskoristi Google Ads Query Language za fleksibilno izveštavanje o kampanjama
6. Prati stope podudaranja - Prati stope podudaranja Customer Match publike i poboljšaj kvalitet podataka
7. Postavi Enhanced Conversions - Koristi Enhanced Conversions za tačnije merenje konverzija

Bezbednost

• OAuth 2.0 - Bezbedna autentifikacija zasnovana na tokenima sa refresh tokenima
• SHA-256 hašovanje - Podaci Customer Match se hašuju pre uploada
• Minimizacija podataka - Samo potrebna polja se prenose u Google
• Google Cloud usklađenost - SOC 2, ISO 27001 i GDPR usklađeni
• Skopovani pristup - API dozvole skopovane na specifične korisničke naloge
• Logovanje revizije - Svi API zahtevi logovani u istoriji promena Google Ads

Povezani resursi

• Meta Ads konektor
• Klaviyo konektor
• Brevo konektor
• Customer Sync veština