Google Ads Konektor

Povežite Google Ads s Brevom putem Taja kako biste sinkronizirali reklamne publike, uvezli podatke o konverzijama i kreirali ujedinjene korisničke profile koji premošćuju plaćeno stjecanje s marketingom životnog ciklusa.

Pregled

Značajke

• Sinkronizacija Customer Match - Učitajte Brevo popise kontakata u Google Ads kao Customer Match publike
• Praćenje konverzija - Uvezite offline konverzije iz Brevo događaja u Google Ads
• Sinkronizacija publike - Dvosmjerna sinkronizacija između Brevo popisa i Google Ads publika
• Izvješćivanje o kampanjama - Povucite podatke o performansama kampanje u Tajo dashboardove
• Praćenje GCLID-a - Hvatanje Google Click ID-ova za atribuciju offline konverzija
• Podaci pametnog licitiranja - Proslijedite vrijednost konverzija natrag Googleu za optimizaciju ponuda
• Sinkronizacija obrazaca za potencijalne klijente - Uvezite Google Ads prijave obrazaca za potencijalne klijente u Brevo kontakte

Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Google Ads račun s omogućenim API pristupom
2. Google Cloud projekt s omogućenim Google Ads API-jem
3. OAuth 2.0 vjerodajnice (Client ID i Client Secret)
4. Google Ads Developer Token (prijavite se na Google Ads API Center)
5. Brevo račun s API pristupom
6. Tajo račun s API vjerodajnicama

Autentifikacija

OAuth 2.0

Google Ads API koristi OAuth 2.0 za autentifikaciju. Morate dobiti token za osvježavanje putem OAuth tijeka suglasnosti.

# Potrebni OAuth opsezi
https://www.googleapis.com/auth/adwords

Developer Token

Developer Token je potreban za sve Google Ads API zahtjeve i mora biti odobren od strane Googlea.

# Postavljanje zaglavlja autentifikacije
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

Osnovna konfiguracija

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"  # Upravljački račun (opcionalno)

    # Opcije sinkronizacije podataka
    sync:
      customer_match: true
      conversions: true
      campaigns: true
      lead_forms: true

    # Praćenje konverzija
    conversions:
      action_id: "123456789"
      default_currency: "USD"

Konfiguracija Customer Match

Učitajte Brevo kontakte 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"

  # Polja za podudaranje podataka
  match_fields:
    - email
    - phone
    - first_name
    - last_name
    - country_code
    - zip_code

  # Raspored sinkronizacije
  schedule: "daily"
  sync_mode: "mirror"  # mirror, append ili remove

Uvoz offline konverzija

conversion_import:
  enabled: true
  conversion_action: "purchase"
  gclid_attribute: "GCLID"  # Brevo atribut koji pohranjuje 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 krajnje točke

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

// Povežite Google Ads račun
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'
});

Učitavanje Customer Match publike

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

Uvoz offline konverzija

// Učitaj offline konverzije iz Brevo događaja narudžbi
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)

// Upitajte metrike kampanje koristeći 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

Rješavanje problema

Preporučene prakse

1. Koristite upravljački račun - Upravljajte višestrukim Ads računima putem jednog upravljačkog (MCC) računa
2. Hashirajte Customer Match podatke - Uvijek SHA-256 hashirajte PII prije učitavanja u Customer Match
3. Pratite GCLID-ove - Pohranite Google Click ID-ove u Brevo atribute za praćenje offline konverzija
4. Skupna učitavanja konverzija - Grupiranje konverzija u dnevne serije umjesto učitavanja u stvarnom vremenu
5. Koristite GAQL za izvješćivanje - Iskoristite Google Ads Query Language za fleksibilno izvješćivanje o kampanjama
6. Pratite stope podudaranja - Pratite stope podudaranja Customer Match publike i poboljšajte kvalitetu podataka
7. Postavite poboljšane konverzije - Koristite Enhanced Conversions za preciznije mjerenje konverzija

Sigurnost

• OAuth 2.0 - Sigurna autentifikacija temeljena na tokenima s tokenima za osvježavanje
• SHA-256 hashiranje - Customer Match podaci se hashiraju prije učitavanja
• Minimizacija podataka - Samo potrebna polja se prenose Googleu
• Usklađenost Google Clouda - SOC 2, ISO 27001 i GDPR usklađeno
• Opseženi pristup - API dozvole opsežene na specifične korisničke račune
• Revizijsko zapisivanje - Svi API zahtjevi zapisani u Google Ads povijesti promjena

Povezani resursi

• Meta Ads Konektor
• Klaviyo Konektor
• Brevo Konektor
• Vještina sinkronizacije korisnika