---
title: "Google Ads Bağlayıcısı"
description: "Tajo aracılığıyla kampanya verilerini, kitle listelerini ve dönüşüm takibini Brevo ile senkronize etmek için eksiksiz Google Ads entegrasyon rehberi."
url: https://tajo.io/tr/docs/connectors/marketing/google-ads/
markdown: https://tajo.io/tr/docs/connectors/marketing/google-ads.md
lang: tr-TR
robots: noindex
---

Erken erişim talep edin

Adınızı ve iş e-posta adresinizi girin. Tajo erişim talebinizi onaylamanız için size bir bağlantı göndereceğiz.

# Google Ads Bağlayıcısı

Bağlayıcı durumu: Planlandı Henüz oluşturulmadı. Tajo bu bağlayıcıyı bugün çalıştırmıyor.

| Kaynak alanı | Hedef alanı | Örnek değer |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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:

1. API erişimi etkin bir Google Ads hesabı
2. Google Ads API’si etkinleştirilmiş bir Google Cloud projesi
3. OAuth 2.0 kimlik bilgileri (Client ID ve Client Secret)
4. Bir Google Ads Geliştirici Belirteci ([Google Ads API Center](https://ads.google.com/aw/apicenter)’da başvurun)
5. API erişimi olan bir Brevo hesabı
6. 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.

```bash
# 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.

```bash
# 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

```yaml
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:

```yaml
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ı

```yaml
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

### Google Ads Bağlayıcısını Başlat

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

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

// Connect Google Ads account
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'
});
```

### Customer Match Kitlesini Yükle

```javascript
// Sync a Brevo list to Google Ads Customer Match
await tajo.connectors.syncAudience('google-ads', {
  brevoListId: 5,
  audienceName: 'High Value Customers',
  matchType: 'CONTACT_INFO',
  syncMode: 'mirror'
});
```

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

```javascript
// Upload offline conversions from Brevo order events
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'
    }
  ]
});
```

### Kampanya Performansını Sorgula (GAQL)

```javascript
// Query campaign metrics using 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 });
```

## Hız Limitleri

| Kaynak | Limit | Detaylar |
| --- | --- | --- |
| **API istekleri** | 15.000/gün | Geliştirici belirteci başına |
| **Mutate işlemleri** | 10.000/gün | Müşteri hesabı başına |
| **GAQL sorguları** | 1.500/gün | Müşteri hesabı başına |
| **Customer Match yüklemeleri** | 10 iş/gün | Müşteri listesi başına |
| **Dönüşüm yüklemeleri** | 2.000/istek | Yükleme toplu başına |
| **Sayfa boyutu** | 10.000 satır | Arama yanıtı başına maks. |

Geliştirici Belirteç Onayı

Google Ads API onaylanmış bir Geliştirici Belirteci gerektirir. Manager hesabınızdaki Google Ads API Center üzerinden başvurun. Test hesaplarının azaltılmış hız limitleri vardır.

## Sorun Giderme

| Sorun | Neden | Çözüm |
| --- | --- | --- |
| `DEVELOPER_TOKEN_NOT_APPROVED` | Belirteç inceleme bekliyor | Google onayını bekleyin veya test hesabı kullanın |
| `CUSTOMER_NOT_FOUND` | Yanlış müşteri kimliği | Müşteri kimliğinden tireleri kaldırın veya manager hesabını kontrol edin |
| Customer Match düşük eşleşme oranı | Yetersiz veri | Birden fazla tanımlayıcı ekleyin (e-posta, telefon, ad, posta kodu) |
| Dönüşümler görünmüyor | Atıf penceresi | Dönüşümlerin işlenmesi 24 saate kadar sürebilir |
| `OAUTH_TOKEN_EXPIRED` | Yenileme belirteci geçersiz | Yeniden kimlik doğrulayın ve yeni bir yenileme belirteci alın |
| `PERMISSION_DENIED` | Yetersiz erişim | API erişim seviyesini ve hesap bağlantısını kontrol edin |

## En İyi Uygulamalar

1. **Bir Manager hesabı kullanın** - Birden fazla Ads hesabını tek bir Manager (MCC) hesabı üzerinden yönetin
2. **Customer Match verilerini hashleyin** - Customer Match’e yüklemeden önce PII’yi her zaman SHA-256 ile hashleyin
3. **GCLID’leri takip edin** - Çevrimdışı dönüşüm takibi için Google Click ID’lerini Brevo özniteliklerinde saklayın
4. **Dönüşüm yüklemelerini gruplandırın** - Gerçek zamanlı yüklemeler yerine günlük toplu yapın
5. **Raporlama için GAQL kullanın** - Esnek kampanya raporlaması için Google Ads Query Language’den yararlanın
6. **Eşleşme oranlarını izleyin** - Customer Match kitle eşleşme oranlarını takip edin ve veri kalitesini artırın
7. **Enhanced Conversions kurun** - Daha doğru dönüşüm ölçümü için Enhanced Conversions kullanın

## Güvenlik

- **OAuth 2.0** - Yenileme belirteçleriyle güvenli belirteç tabanlı kimlik doğrulama
- **SHA-256 hashleme** - Customer Match verileri yüklemeden önce hashlenir
- **Veri minimizasyonu** - Yalnızca gerekli alanlar Google’a iletilir
- **Google Cloud uyumluluğu** - SOC 2, ISO 27001 ve GDPR uyumlu
- **Kapsamlandırılmış erişim** - API izinleri belirli müşteri hesaplarıyla kapsamlandırılır
- **Denetim günlüğü** - Tüm API istekleri Google Ads değişiklik geçmişinde günlüklenir

## İlgili Kaynaklar

- [Meta Ads Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/meta-ads)
- [Klaviyo Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/klaviyo)
- [Brevo Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/brevo)
- [Müşteri Senkronizasyon Yeteneği](https://tajo.io/tr/docs/skills/data-sync/customer-sync)