Mailchimp Bağlayıcısı

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ış

Ö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.

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:

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

Yapılandırma

Temel Kurulum

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:

Özel Birleştirme Alan Eşleme

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)

Kampanyalar

Otomasyonlar

E-ticaret

Olaylar

Kampanya Olayları

Abone Olayları

E-ticaret Olayları

Kod Örnekleri

Bağlayıcıyı Başlat

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şı

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

// 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:

Sorun Giderme

Sık Karşılaşılan Sorunlar

Hata Ayıklama Modu

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

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

Bağlantıyı Test Et

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ı
• Mailchimp API Rehberleri
• Brevo Bağlayıcısı
• ActiveCampaign Bağlayıcısı
• Müşteri Senkronizasyon Yeteneği