---
title: "Mailchimp Bağlayıcısı"
description: "Tajo aracılığıyla kitleleri, kampanyaları, otomasyonları ve etkileşim verilerini Brevo ile senkronize etmek için eksiksiz Mailchimp entegrasyon rehberi."
url: https://tajo.io/tr/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/tr/docs/connectors/marketing/mailchimp.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.

# Mailchimp Bağlayıcısı

Bağlayıcı durumu: Geliştiriliyor Yapım aşamasında. Henüz doğrulanmadı.

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

Sorunsuz kitle taşıma, kampanya verisi senkronizasyonu ve her iki platformda birleşik pazarlama otomasyonu için Mailchimp hesabınızı Tajo aracılığıyla Brevo’ya bağlayın.

## Genel Bakış

| Özellik | Değer |
| --- | --- |
| **Platform** | Mailchimp |
| **Kategori** | Pazarlama |
| **Kurulum Karmaşıklığı** | Kolay |
| **Resmi Entegrasyon** | Hayır |
| **Senkronize Edilen Veri** | Kişiler, Kampanyalar, Otomasyonlar, Olaylar |
| **API Temel URL’si** | `https://{dc}.api.mailchimp.com/3.0` |

## Özellikler

- **Kitle senkronizasyonu** - Mailchimp kitlelerini Brevo kişi listeleriyle taşıyın ve senkronize edin
- **Kampanya verileri** - Birleşik raporlama için kampanya performans verilerini senkronize edin
- **Otomasyon taşıma** - Mailchimp otomasyonlarını Brevo iş akışlarına eşleyin
- **Etkileşim metrikleri** - Açılma, tıklama ve geri dönme verilerini Brevo özniteliklerine senkronize edin
- **Segment eşleme** - Mailchimp segmentlerini Brevo listeleri veya segmentleri olarak kopyalayın
- **E-ticaret verileri** - Mailchimp e-ticaretten mağaza, ürün ve sipariş verilerini senkronize edin
- **Etiket senkronizasyonu** - Mailchimp etiketlerini Brevo kişi öznitelikleri veya listelerine eşleyin
- **Şablon taşıma** - Mailchimp şablonlarını Brevo kampanyalarında kullanmak üzere dışa aktarın

## Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. Bir Mailchimp hesabı (Free, Essentials, Standard veya Premium)
2. Bir Mailchimp API anahtarı veya OAuth uygulaması
3. API erişimi olan bir Brevo hesabı
4. Bir Tajo hesabı

## Kimlik Doğrulama

### API Anahtar Kimlik Doğrulaması

Mailchimp Account > Extras > API Keys’ten bir API anahtarı oluşturun.

```bash
curl https://{dc}.api.mailchimp.com/3.0/ping \
  --user "anystring:{api_key}" \
  -H "Content-Type: application/json"
```

`{dc}` veri merkezi öneki, API anahtarınızın son kısmıdır (örn. `us21`).

### OAuth 2.0

Çoklu hesap entegrasyonları için:

```bash
# Authorization URL
https://login.mailchimp.com/oauth2/authorize?
  response_type=code&
  client_id={client_id}&
  redirect_uri={redirect_uri}

# Token exchange
curl -X POST https://login.mailchimp.com/oauth2/token \
  -d "grant_type=authorization_code" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "redirect_uri={redirect_uri}" \
  -d "code={auth_code}"
```

Veri Merkezi

Veri merkezini her zaman API anahtarınızdan veya OAuth meta veri uç noktasından çıkarın. Yanlış veri merkezi kullanmak kimlik doğrulama hatalarına neden olur.

## Yapılandırma

### Temel Kurulum

```yaml
connectors:
  mailchimp:
    enabled: true
    api_key: "${MAILCHIMP_API_KEY}"
    data_center: "us21"

    # Data sync options
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Audience to Brevo list mapping
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42
```

### Alan Eşleme

Mailchimp birleştirme alanlarını Brevo kişi özniteliklerine eşleyin:

#### Varsayılan Eşlemeler

| Parameter | Type | Description |
| --- | --- | --- |
| `email_address` required | string | Abone e-postası (benzersiz tanımlayıcı) |
| `FNAME` optional | string | Ad birleştirme alanı, FIRSTNAME'e eşlenir |
| `LNAME` optional | string | Soyad birleştirme alanı, LASTNAME'e eşlenir |
| `PHONE` optional | string | Telefon birleştirme alanı, SMS'e eşlenir |
| `status` optional | string | Abonelik durumu (subscribed, unsubscribed, cleaned, pending) |
| `tags` optional | array | Segmentasyon için abone etiketleri |
| `stats.avg_open_rate` optional | number | Ortalama e-posta açılma oranı |
| `stats.avg_click_rate` optional | number | Ortalama e-posta tıklama oranı |

#### Özel Birleştirme Alan Eşleme

```yaml
field_mapping:
  # Standard fields
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Engagement metrics
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # E-commerce fields
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # Custom merge fields
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE
```

## API Uç Noktaları

### Kitleler (Listeler)

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `GET` | `/3.0/lists` | Tüm kitleleri listele |
| `GET` | `/3.0/lists/{list_id}` | Kitle detaylarını al |
| `GET` | `/3.0/lists/{list_id}/members` | Kitle üyelerini listele |
| `POST` | `/3.0/lists/{list_id}/members` | Bir üye ekle |
| `PUT` | `/3.0/lists/{list_id}/members/{hash}` | Bir üyeyi güncelle |
| `POST` | `/3.0/lists/{list_id}` | Toplu abone ol/abonelikten çık |

### Kampanyalar

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `GET` | `/3.0/campaigns` | Kampanyaları listele |
| `GET` | `/3.0/campaigns/{id}` | Kampanya detaylarını al |
| `GET` | `/3.0/reports/{id}` | Kampanya raporunu al |
| `GET` | `/3.0/reports/{id}/email-activity` | E-posta aktivitesini al |

### Otomasyonlar

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `GET` | `/3.0/automations` | Otomasyonları listele |
| `GET` | `/3.0/automations/{id}` | Otomasyon detaylarını al |
| `GET` | `/3.0/automations/{id}/emails` | Otomasyon e-postalarını listele |

### E-ticaret

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `GET` | `/3.0/ecommerce/stores` | Bağlı mağazaları listele |
| `GET` | `/3.0/ecommerce/stores/{id}/customers` | Mağaza müşterilerini listele |
| `GET` | `/3.0/ecommerce/stores/{id}/orders` | Mağaza siparişlerini listele |
| `GET` | `/3.0/ecommerce/stores/{id}/products` | Mağaza ürünlerini listele |

## Olaylar

### Kampanya Olayları

| Olay | Tetikleyici | Kullanım Alanı |
| --- | --- | --- |
| `campaign.sent` | Kampanya teslim edildi | Performans takibi |
| `campaign.opened` | E-posta açıldı | Etkileşim puanlaması |
| `campaign.clicked` | Bağlantıya tıklandı | İlgi takibi |
| `campaign.bounced` | E-posta geri döndü | Liste hijyeni |

### Abone Olayları

| Olay | Tetikleyici | Kullanım Alanı |
| --- | --- | --- |
| `subscribe` | Yeni abone eklendi | Karşılama akışı |
| `unsubscribe` | Abonelikten çıkıldı | Tercih yönetimi |
| `profile` | Profil güncellendi | Öznitelik senkronizasyonu |
| `cleaned` | E-posta temizlendi (geri döndü) | Liste bakımı |

### E-ticaret Olayları

| Olay | Tetikleyici | Kullanım Alanı |
| --- | --- | --- |
| `ecommerce.order` | Sipariş verildi | Satın alma sonrası akış |
| `ecommerce.cart` | Sepet güncellendi | Terk edilmiş sepet kurtarma |

## Kod Örnekleri

### Bağlayıcıyı 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 Mailchimp
await tajo.connectors.connect('mailchimp', {
  apiKey: process.env.MAILCHIMP_API_KEY
});
```

### Kitleleri Brevo’ya Taşı

```javascript
// Full audience migration from Mailchimp to Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

// Check migration status
const status = await tajo.connectors.status('mailchimp');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 52000,
//   campaignsSynced: 245,
//   segmentsMapped: 18
// }
```

### Kampanya Etkileşim Verilerini Senkronize Et

```javascript
// Sync campaign performance to Brevo attributes
await tajo.connectors.sync('mailchimp', {
  type: 'incremental',
  resources: ['campaigns'],
  options: {
    syncEngagement: true,
    updateContactMetrics: true,
    since: '2024-01-01'
  }
});
```

## Hız Limitleri

Mailchimp Marketing API hız limitleri:

| Tür | Limit | Detaylar |
| --- | --- | --- |
| Standart | 10 eşzamanlı istek | API anahtarı başına |
| Toplu işlemler | Toplu başına 500 işlem | İstek başına |
| Dışa aktarma limiti | 1 eşzamanlı dışa aktarma | Hesap başına |
| İşlemsel | 25 istek/saniye | API anahtarı başına |

Hız Limit Stratejisi

Mailchimp, saniye başına istekleri değil eşzamanlı bağlantıları sınırlar. Toplu uç noktaları kullanın ve `429` yanıtlarında üstel geri çekilme ile yeniden deneme mantığı uygulayın.

## Sorun Giderme

### Sık Karşılaşılan Sorunlar

| Sorun | Neden | Çözüm |
| --- | --- | --- |
| 401 Unauthorized | Geçersiz API anahtarı veya yanlış veri merkezi | API anahtarını doğrulayın ve doğru `dc` önekini çıkarın |
| Üye mevcut | E-posta zaten kitlede | Mevcut üyeleri güncellemek için POST yerine PUT kullanın |
| Uyumluluk durumu | GDPR silme yeniden eklemeyi engeller | Kişi bir kayıt formu üzerinden yeniden abone olmalıdır |
| Toplu zaman aşımı | Büyük toplu işlem | 500 işlemlik daha küçük toplulara bölün |
| Birleştirme alanları eksik | Özel alanlar oluşturulmadı | Eşlemeden önce Mailchimp’te birleştirme alanları oluşturun |

### Hata Ayıklama Modu

Ayrıntılı günlüklemeyi etkinleştirin:

```yaml
connectors:
  mailchimp:
    debug: true
    log_level: verbose
    log_api_calls: true
```

### Bağlantıyı Test Et

```bash
tajo connectors test mailchimp
# ✓ API connection successful
# ✓ Audiences readable
# ✓ Campaigns readable
# ✓ E-commerce data accessible
# ✓ Webhook configured
```

## En İyi Uygulamalar

1. **Toplu işlemler kullanın** - Toplu güncellemeler için toplu abone ol/abonelikten çık kullanın
2. **Abone durumunu koruyun** - Taşıma sırasında abonelik onayına saygı gösterin
3. **Önce birleştirme alanlarını eşleyin** - Senkronizasyondan önce karşılık gelen Brevo özniteliklerini oluşturun
4. **Etkileşim verilerini senkronize edin** - Geçmiş segmentasyon için açılma/tıklama oranlarını içe aktarın
5. **Uyumluluk durumlarını yönetin** - GDPR ve kalıcı silme durumlarına saygı gösterin
6. **Artımlı senkronizasyon kullanın** - API kullanımını azaltmak için yalnızca son senkronizasyondan beri olan değişiklikleri senkronize edin

## Güvenlik

- **API Anahtar Kimlik Doğrulaması** - HTTP Basic Auth şifresi olarak iletilen gizli anahtar
- **OAuth 2.0** - Çoklu hesap erişimi için belirteç tabanlı yetkilendirme
- **TLS şifrelemesi** - Tüm API iletişimi HTTPS aracılığıyla şifrelenir
- **Webhook doğrulama** - Webhook kaynağını paylaşılan gizli anahtarla doğrulayın
- **Veri merkezi izolasyonu** - Veriler bölgeye özel veri merkezlerinde saklanır

## İlgili Kaynaklar

- [Mailchimp Marketing API Referansı](https://mailchimp.com/developer/marketing/api/)
- [Mailchimp API Rehberleri](https://mailchimp.com/developer/marketing/guides/quick-start/)
- [Brevo Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/brevo)
- [ActiveCampaign Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/activecampaign)
- [Müşteri Senkronizasyon Yeteneği](https://tajo.io/tr/docs/skills/data-sync/customer-sync)