Conector Mailchimp

Conectați contul Mailchimp la Brevo prin Tajo pentru migrarea fără probleme a audiențelor, sincronizarea datelor de campanie și automatizarea unificată a marketingului pe ambele platforme.

Prezentare generală

Funcționalități

• Sincronizare audiențe - Migrați și sincronizați audiențele Mailchimp cu listele de contacte Brevo
• Date campanii - Sincronizați datele de performanță ale campaniei pentru raportare unificată
• Migrare automatizări - Mapați automatizările Mailchimp la fluxurile de lucru Brevo
• Metrici de implicare - Sincronizați datele de deschideri, clicuri și respingeri la atributele Brevo
• Mapare segmente - Replicați segmentele Mailchimp ca liste sau segmente Brevo
• Date e-commerce - Sincronizați datele de magazin, produs și comandă din e-commerce Mailchimp
• Sincronizare etichete - Mapați etichetele Mailchimp la atributele de contact sau listele Brevo
• Migrare șabloane - Exportați șabloanele Mailchimp pentru utilizare în campaniile Brevo

Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

1. Un cont Mailchimp (Free, Essentials, Standard sau Premium)
2. O cheie API Mailchimp sau o aplicație OAuth
3. Un cont Brevo cu acces API
4. Un cont Tajo

Autentificare

Autentificare cu cheie API

Generați o cheie API din Mailchimp Account > Extras > API Keys.

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

Prefixul {dc} al centrului de date este ultima parte a cheii API (ex: us21).

OAuth 2.0

Pentru integrări cu mai multe conturi:

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

Configurare

Configurare de bază

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

Mapare câmpuri

Mapați câmpurile de fuzionare Mailchimp la atributele de contact Brevo:

Mapare câmpuri de fuzionare personalizate

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

Puncte finale API

Audiențe (Liste)

Campanii

Automatizări

E-commerce

Evenimente

Evenimente campanii

Evenimente abonați

Evenimente e-commerce

Exemple de cod

Inițializare conector

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

Migrare audiențe la 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
// }

Sincronizare date implicare campanii

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

Limite de rată

Limite de rată API Marketing Mailchimp:

Depanare

Probleme frecvente

Modul de depanare

Activați jurnalizarea verbosă:

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

Testare conexiune

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

Bune practici

1. Utilizați operații în lot - Utilizați abonare/dezabonare în lot pentru actualizări în bloc
2. Păstrați statusul abonaților - Respectați consimțământul de abonare în timpul migrării
3. Mapați câmpurile de fuzionare mai întâi - Creați atributele Brevo corespunzătoare înainte de sincronizare
4. Sincronizați datele de implicare - Importați ratele de deschidere/clic pentru segmentarea istorică
5. Gestionați stările de conformitate - Respectați stările de ștergere GDPR și permanente
6. Utilizați sincronizarea incrementală - Sincronizați doar modificările de la ultima sincronizare pentru a reduce utilizarea API

Securitate

• Autentificare cu cheie API - Cheie secretă transmisă ca parolă HTTP Basic Auth
• OAuth 2.0 - Autorizare bazată pe token pentru acces multi-cont
• Criptare TLS - Toate comunicațiile API criptate prin HTTPS
• Verificare webhook - Validați sursa webhook cu secretul partajat
• Izolare centru de date - Date stocate în centre de date specifice regiunii

Resurse conexe

• Referință API Marketing Mailchimp
• Ghiduri API Mailchimp
• Conector Brevo
• Conector ActiveCampaign
• Skill Sincronizare clienți