Google Ads Connector

Verbinde Google Ads über Tajo mit Brevo, um Werbe-Audiences zu synchronisieren, Conversion-Daten zu importieren und einheitliche Kundenprofile zu erstellen, die bezahlte Akquise und Lifecycle-Marketing miteinander verbinden.

Überblick

Eigenschaft	Wert
Plattform	Google Ads
Kategorie	Marketing
Einrichtungsaufwand	Fortgeschritten
Offizielle Integration	Nein
Synchronisierte Daten	Kampagnen, Audiences, Conversions, Kund:innen
Verfügbare Skills	7

Funktionen

Customer-Match-Sync - Lade Brevo-Kontaktlisten als Customer-Match-Audiences zu Google Ads hoch
Conversion-Tracking - Importiere Offline-Conversions aus Brevo-Events in Google Ads
Audience-Sync - Bidirektionale Synchronisation zwischen Brevo-Listen und Google-Ads-Audiences
Kampagnen-Reporting - Hole dir Kampagnen-Performance-Daten in deine Tajo-Dashboards
GCLID-Tracking - Erfasse Google Click IDs für die Attribution von Offline-Conversions
Smart-Bidding-Daten - Sende Conversion-Werte zurück an Google für die Gebotsoptimierung
Lead-Form-Sync - Importiere Einsendungen aus Google-Ads-Lead-Formularen als Brevo-Kontakte

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

Ein Google-Ads-Konto mit aktiviertem API-Zugriff
Ein Google-Cloud-Projekt mit aktivierter Google Ads API
OAuth-2.0-Anmeldedaten (Client ID und Client Secret)
Einen Google-Ads-Developer-Token (Antrag im Google Ads API Center)
Ein Brevo-Konto mit API-Zugriff
Ein Tajo-Konto mit API-Anmeldedaten

Authentifizierung

OAuth 2.0

Die Google Ads API verwendet OAuth 2.0 zur Authentifizierung. Du benötigst ein Refresh-Token, das du über den OAuth-Consent-Flow erhältst.

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

Developer Token

Für alle Anfragen an die Google Ads API ist ein Developer Token erforderlich, der von Google freigegeben werden muss.

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

Konfiguration

Grundeinrichtung

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

Lade Brevo-Kontakte als Google-Ads-Audiences hoch:

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 von Offline-Conversions

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	Beschreibung
`POST`	`/v18/customers/{id}/googleAds:search`	Kampagnen und Ressourcen durchsuchen (GAQL)
`POST`	`/v18/customers/{id}/googleAds:searchStream`	Suchergebnisse streamen
`POST`	`/v18/customers/{id}/offlineUserDataJobs:create`	Customer-Match-Upload-Job anlegen
`POST`	`/v18/customers/{id}/conversionUploads:uploadClickConversions`	Offline-Conversions hochladen
`POST`	`/v18/customers/{id}/conversionUploads:uploadCallConversions`	Call-Conversions hochladen
`GET`	`/v18/customers/{id}/campaignBudgets`	Kampagnen-Budgets abrufen
`POST`	`/v18/customers/{id}/customerLists:mutate`	Customer-Listen verwalten

Code-Beispiele