Mailchimp конектор

Свържи своя акаунт в Mailchimp с Brevo чрез Tajo за безпроблемна миграция на audiences, синхронизация на данни за кампании и унифицирана маркетингова автоматизация в двете платформи.

Преглед

Функции

• Синхронизация на audience – Мигрирай и синхронизирай Mailchimp audiences със списъци с контакти в Brevo
• Данни за кампании – Синхронизирай данни за performance на кампании за унифицирано отчитане
• Миграция на автоматизации – Мапвай Mailchimp автоматизации към Brevo работни потоци
• Метрики за ангажираност – Синхронизирай отваряния, кликове и bounce данни към атрибути в Brevo
• Мапване на сегменти – Репликирай Mailchimp сегменти като списъци или сегменти в Brevo
• E-commerce данни – Синхронизирай данни за магазини, продукти и поръчки от Mailchimp e-commerce
• Синхронизация на тагове – Мапвай Mailchimp тагове към атрибути на контактите или списъци в Brevo
• Миграция на шаблони – Експортирай Mailchimp шаблони за използване в Brevo кампании

Предварителни условия

Преди да започнеш, увери се, че имаш:

1. Акаунт в Mailchimp (Free, Essentials, Standard или Premium)
2. Mailchimp API ключ или OAuth приложение
3. Акаунт в Brevo с API достъп
4. Акаунт в Tajo

Автентикация

Автентикация с API ключ

Генерирай API ключ от Mailchimp Account > Extras > API Keys.

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

Префиксът на дейта център {dc} е последната част от твоя API ключ (напр. us21).

OAuth 2.0

За мулти-акаунт интеграции:

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

Конфигурация

Основна настройка

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

Мапване на полета

Мапвай merge полета на Mailchimp към атрибути на контактите в Brevo:

Мапване на персонализирани merge полета

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 крайни точки

Audiences (Lists)

Кампании

Автоматизации

E-commerce

Събития

Събития от кампании

Събития от абонати

E-commerce събития

Примери с код

Инициализация на конектора

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

Миграция на audiences към 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
// }

Синхронизация на данни за ангажираност

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

Ограничения на заявките

Rate limits на Mailchimp Marketing API:

Отстраняване на проблеми

Чести проблеми

Режим за дебъг

Активирай подробно логване:

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

Тест на връзката

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

Добри практики

1. Използвай пакетни операции – Използвай batch subscribe/unsubscribe за bulk обновления
2. Запазвай статуса на абонатите – Уважавай съгласието за абонамент по време на миграция
3. Първо мапвай merge полетата – Създай съответните атрибути в Brevo, преди синхронизация
4. Синхронизирай данни за ангажираност – Импортирай open/click rates за исторически сегментации
5. Обработвай compliance състояния – Уважавай GDPR и permanent deletion състояния
6. Използвай инкрементална синхронизация – Синхронизирай само промените от последната синхронизация, за да намалиш използването на API

Сигурност

• Автентикация с API ключ – Таен ключ, подаден като HTTP Basic Auth парола
• OAuth 2.0 – Token-базирана авторизация за мулти-акаунт достъп
• TLS криптиране – Цялата API комуникация е криптирана чрез HTTPS
• Верификация на уебхуци – Валидирай източника на уебхук със споделена тайна
• Изолация на дейта центрове – Данните се съхраняват в регионално-специфични дейта центрове

Свързани ресурси

• Mailchimp Marketing API Reference
• Mailchimp API Guides
• Brevo конектор
• ActiveCampaign конектор
• Customer Sync скил