Google Ads Bağlayıcısı

Reklam kitlelerini senkronize etmek, dönüşüm verilerini içe aktarmak ve ücretli edinimi yaşam döngüsü pazarlamasıyla birleştiren birleşik müşteri profilleri oluşturmak için Google Ads’i Tajo aracılığıyla Brevo’ya bağlayın.

Genel Bakış

Özellik	Değer
Platform	Google Ads
Kategori	Pazarlama
Kurulum Karmaşıklığı	Gelişmiş
Resmi Entegrasyon	Hayır
Senkronize Edilen Veri	Kampanyalar, Kitleler, Dönüşümler, Müşteriler
Mevcut Yetenekler	7

Özellikler

Customer Match senkronizasyonu - Brevo kişi listelerini Google Ads’e Customer Match kitleleri olarak yükleyin
Dönüşüm takibi - Brevo olaylarından çevrimdışı dönüşümleri Google Ads’e içe aktarın
Kitle senkronizasyonu - Brevo listeleri ile Google Ads kitleleri arasında çift yönlü senkronizasyon
Kampanya raporlaması - Tajo panolarına kampanya performans verilerini çekin
GCLID takibi - Çevrimdışı dönüşüm atfı için Google Click ID’leri yakalayın
Akıllı teklif verme verileri - Teklif optimizasyonu için dönüşüm değer verilerini Google’a geri besleyin
Aday formu senkronizasyonu - Google Ads aday formu gönderimlerini Brevo kişilerine içe aktarın

Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

API erişimi etkin bir Google Ads hesabı
Google Ads API’si etkinleştirilmiş bir Google Cloud projesi
OAuth 2.0 kimlik bilgileri (Client ID ve Client Secret)
Bir Google Ads Geliştirici Belirteci (Google Ads API Center’da başvurun)
API erişimi olan bir Brevo hesabı
API kimlik bilgilerine sahip bir Tajo hesabı

Kimlik Doğrulama

OAuth 2.0

Google Ads API kimlik doğrulama için OAuth 2.0 kullanır. OAuth onay akışı üzerinden bir yenileme belirteci almanız gerekir.

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

Geliştirici Belirteci

Tüm Google Ads API istekleri için bir Geliştirici Belirteci gereklidir ve Google tarafından onaylanmalıdır.

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

Yapılandırma

Temel Kurulum

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 Yapılandırması

Brevo kişilerini Google Ads kitleleri olarak yükleyin:

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

Çevrimdışı Dönüşüm İçe Aktarımı

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 Uç Noktaları

Yöntem	Uç Nokta	Açıklama
`POST`	`/v18/customers/{id}/googleAds:search`	Kampanyaları ve kaynakları ara (GAQL)
`POST`	`/v18/customers/{id}/googleAds:searchStream`	Arama sonuçlarını akıt
`POST`	`/v18/customers/{id}/offlineUserDataJobs:create`	Customer Match yükleme işi oluştur
`POST`	`/v18/customers/{id}/conversionUploads:uploadClickConversions`	Çevrimdışı dönüşümleri yükle
`POST`	`/v18/customers/{id}/conversionUploads:uploadCallConversions`	Arama dönüşümlerini yükle
`GET`	`/v18/customers/{id}/campaignBudgets`	Kampanya bütçelerini al
`POST`	`/v18/customers/{id}/customerLists:mutate`	Müşteri listelerini yönet

Kod Örnekleri