Konektor Mailchimp

Hubungkan akun Mailchimp Anda ke Brevo melalui Tajo untuk migrasi audiens yang mulus, sinkronisasi data kampanye, dan otomatisasi marketing terpadu di kedua platform.

Ikhtisar

Fitur

• Sinkronisasi audiens - Migrasikan dan sinkronkan audiens Mailchimp dengan daftar kontak Brevo
• Data kampanye - Sinkronkan data performa kampanye untuk pelaporan terpadu
• Migrasi otomatisasi - Petakan otomatisasi Mailchimp ke workflow Brevo
• Metrik keterlibatan - Sinkronkan data open, klik, dan bounce ke atribut Brevo
• Pemetaan segmen - Replikasi segmen Mailchimp sebagai daftar atau segmen Brevo
• Data e-commerce - Sinkronkan data toko, produk, dan pesanan dari e-commerce Mailchimp
• Sinkronisasi tag - Petakan tag Mailchimp ke atribut kontak atau daftar Brevo
• Migrasi template - Ekspor template Mailchimp untuk dipakai pada kampanye Brevo

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Akun Mailchimp (Free, Essentials, Standard, atau Premium)
2. API key Mailchimp atau aplikasi OAuth
3. Akun Brevo dengan akses API
4. Akun Tajo

Autentikasi

Autentikasi API key

Buat API key dari Mailchimp Account > Extras > API Keys.

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

Prefiks data center {dc} adalah bagian terakhir dari API key Anda (misalnya us21).

OAuth 2.0

Untuk integrasi multi-akun:

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

Konfigurasi

Setup dasar

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

Pemetaan field

Petakan merge field Mailchimp ke atribut kontak Brevo:

Pemetaan merge field kustom

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

Endpoint API

Audiens (daftar)

Kampanye

Otomatisasi

E-commerce

Event

Event kampanye

Event pelanggan email

Event e-commerce

Contoh kode

Inisialisasi konektor

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
});

Migrasi audiens ke Brevo

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

Sinkronisasi data keterlibatan kampanye

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

Batas rate

Batas rate Mailchimp Marketing API:

Pemecahan masalah

Masalah umum

Mode debug

Aktifkan logging verbose:

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

Menguji koneksi

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

Praktik terbaik

1. Gunakan operasi batch - Gunakan batch subscribe/unsubscribe untuk pembaruan massal
2. Pertahankan status pelanggan email - Hormati persetujuan langganan selama migrasi
3. Petakan merge field lebih dulu - Buat atribut Brevo yang setara sebelum menyinkronkan
4. Sinkronkan data keterlibatan - Impor open/click rate untuk segmentasi historis
5. Tangani compliance state - Hormati status GDPR dan penghapusan permanen
6. Gunakan sinkronisasi inkremental - Sinkronkan hanya perubahan sejak sinkronisasi terakhir untuk menekan penggunaan API

Keamanan

• Autentikasi API key - Secret key dikirim sebagai password HTTP Basic Auth
• OAuth 2.0 - Otorisasi berbasis token untuk akses multi-akun
• Enkripsi TLS - Seluruh komunikasi API dienkripsi melalui HTTPS
• Verifikasi webhook - Validasi sumber webhook dengan shared secret
• Isolasi data center - Data disimpan di data center spesifik per region

Sumber daya terkait

• Referensi Mailchimp Marketing API
• Panduan API Mailchimp
• Konektor Brevo
• Konektor ActiveCampaign
• Skill Sinkronisasi Pelanggan