Google Ads-connector

Verbind Google Ads met Brevo via Tajo om advertentie-audiences te synchroniseren, conversiedata te importeren en uniforme klantprofielen op te bouwen die betaalde acquisitie koppelen aan lifecycle-marketing.

Overzicht

Eigenschap	Waarde
Platform	Google Ads
Categorie	Marketing
Setupcomplexiteit	Geavanceerd
Officiële integratie	Nee
Gesynchroniseerde data	Campagnes, Audiences, Conversies, Klanten
Beschikbare skills	7

Functies

Customer Match-sync - Upload Brevo-contactlijsten naar Google Ads als Customer Match-audiences
Conversietracking - Importeer offline conversies uit Brevo-events in Google Ads
Audience-sync - Bidirectionele sync tussen Brevo-lijsten en Google Ads-audiences
Campagnerapportage - Haal campagneprestatiedata op in Tajo-dashboards
GCLID-tracking - Leg Google Click ID’s vast voor offline conversieattributie
Smart bidding-data - Stuur conversiewaarde-data terug naar Google voor bod-optimalisatie
Lead form-sync - Importeer Google Ads-leadforminzendingen in Brevo-contacten

Vereisten

Voordat je begint, zorg dat je beschikt over:

Een Google Ads-account met ingeschakelde API-toegang
Een Google Cloud-project met de Google Ads API ingeschakeld
OAuth 2.0-inloggegevens (Client ID en Client Secret)
Een Google Ads Developer Token (aanvragen via Google Ads API Center)
Een Brevo-account met API-toegang
Een Tajo-account met API-inloggegevens

Authenticatie

OAuth 2.0

De Google Ads API gebruikt OAuth 2.0 voor authenticatie. Je moet een refresh token verkrijgen via de OAuth-consent-flow.

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

Developer Token

Een Developer Token is vereist voor alle Google Ads API-requests en moet door Google worden goedgekeurd.

# 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"

Configuratie

Basisopzet

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"

Customer Match-configuratie

Upload Brevo-contacten als Google Ads-audiences:

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

Offline conversie-import

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-endpoints

Methode	Endpoint	Beschrijving
`POST`	`/v18/customers/{id}/googleAds:search`	Campagnes en resources doorzoeken (GAQL)
`POST`	`/v18/customers/{id}/googleAds:searchStream`	Zoekresultaten streamen
`POST`	`/v18/customers/{id}/offlineUserDataJobs:create`	Customer Match-upload-job aanmaken
`POST`	`/v18/customers/{id}/conversionUploads:uploadClickConversions`	Offline conversies uploaden
`POST`	`/v18/customers/{id}/conversionUploads:uploadCallConversions`	Call-conversies uploaden
`GET`	`/v18/customers/{id}/campaignBudgets`	Campagnebudgetten ophalen
`POST`	`/v18/customers/{id}/customerLists:mutate`	Customer lists beheren

Codevoorbeelden