Google Ads-kobling

Koble Google Ads til Brevo gjennom Tajo for å synkronisere annonsemålgrupper, importere konverteringsdata og opprette enhetlige kundeprofiler som bygger bro mellom betalt kundeanskaffelse og livssyklusmarkedsføring.

Oversikt

Funksjoner

• Customer Match-synkronisering - Last opp Brevo-kontaktlister til Google Ads som Customer Match-målgrupper
• Konverteringssporing - Importer offline konverteringer fra Brevo-hendelser til Google Ads
• Målgruppesynkronisering - Toveis synkronisering mellom Brevo-lister og Google Ads-målgrupper
• Kampanjerapportering - Hent kampanjeytelsesdata inn i Tajo-dashbord
• GCLID-sporing - Fang Google Click-ID-er for offline konverteringsattribusjon
• Data for smart bidding - Send konverteringsverdidata tilbake til Google for budoptimalisering
• Synkronisering av lead-skjemaer - Importer Google Ads lead-skjemainnsendinger til Brevo-kontakter

Forutsetninger

Før du begynner, sørg for at du har:

1. En Google Ads-konto med API-tilgang aktivert
2. Et Google Cloud-prosjekt med Google Ads API aktivert
3. OAuth 2.0-påloggingsdetaljer (Client ID og Client Secret)
4. Et Google Ads Developer Token (søk på Google Ads API Center)
5. En Brevo-konto med API-tilgang
6. En Tajo-konto med API-påloggingsdetaljer

Autentisering

OAuth 2.0

Google Ads API bruker OAuth 2.0 for autentisering. Du må skaffe et refresh-token gjennom OAuth-samtykkeflyten.

# Nødvendige OAuth-scopes
https://www.googleapis.com/auth/adwords

Developer Token

Et Developer Token kreves for alle Google Ads API-forespørsler og må godkjennes av Google.

# Sett opp autentiseringsheadere
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"

Konfigurasjon

Grunnleggende oppsett

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-konto (valgfritt)

    # Synkroniseringsalternativer
    sync:
      customer_match: true
      conversions: true
      campaigns: true
      lead_forms: true

    # Konverteringssporing
    conversions:
      action_id: "123456789"
      default_currency: "USD"

Customer Match-konfigurasjon

Last opp Brevo-kontakter som Google Ads-målgrupper:

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"

  # Datafelt som skal matches
  match_fields:
    - email
    - phone
    - first_name
    - last_name
    - country_code
    - zip_code

  # Synkroniseringsplan
  schedule: "daily"
  sync_mode: "mirror"  # mirror, append eller remove

Import av offline konverteringer

conversion_import:
  enabled: true
  conversion_action: "purchase"
  gclid_attribute: "GCLID"  # Brevo-attributt som lagrer 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-endepunkter

Kodeeksempler

Initialiser Google Ads-kobling

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

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

// Koble til Google Ads-konto
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'
});

Last opp Customer Match-målgruppe

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

Importer offline konverteringer

// Last opp offline konverteringer fra Brevo-ordrehendelser
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'
    }
  ]
});

Spør om kampanjeytelse (GAQL)

// Spør om kampanjemålinger med 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 });

Ratebegrensninger

Feilsøking

Beste praksis

1. Bruk en Manager-konto - Administrer flere Ads-kontoer gjennom én enkelt Manager (MCC)-konto
2. Hash Customer Match-data - SHA-256-hash alltid PII før opplasting til Customer Match
3. Spor GCLID-er - Lagre Google Click-ID-er i Brevo-attributter for offline konverteringssporing
4. Batch konverteringsopplastinger - Grupper konverteringer i daglige batcher i stedet for sanntidsopplastinger
5. Bruk GAQL for rapportering - Utnytt Google Ads Query Language for fleksibel kampanjerapportering
6. Overvåk matchrater - Spor Customer Match-målgruppematchrater og forbedre datakvaliteten
7. Sett opp Enhanced Conversions - Bruk Enhanced Conversions for mer nøyaktig konverteringsmåling

Sikkerhet

• OAuth 2.0 - Sikker token-basert autentisering med refresh-tokens
• SHA-256-hashing - Customer Match-data hashes før opplasting
• Dataminimering - Kun nødvendige felt overføres til Google
• Google Cloud-samsvar - SOC 2-, ISO 27001- og GDPR-kompatibel
• Avgrenset tilgang - API-rettigheter avgrenset til spesifikke kundekontoer
• Revisjonslogg - Alle API-forespørsler logget i Google Ads-endringshistorikken

Relaterte ressurser

• Meta Ads-kobling
• Klaviyo-kobling
• Brevo-kobling
• Customer Sync-ferdighet