Connettore Mailchimp

Collega il tuo account Mailchimp a Brevo tramite Tajo per una migrazione fluida delle audience, sincronizzazione dei dati delle campagne e marketing automation unificata tra entrambe le piattaforme.

Panoramica

Funzionalità

• Sync delle audience - Migra e sincronizza le audience Mailchimp con le liste contatti Brevo
• Dati di campagna - Sincronizza i dati di performance delle campagne per una reportistica unificata
• Migrazione automazioni - Mappa le automazioni Mailchimp ai workflow Brevo
• Metriche di engagement - Sincronizza dati di aperture, click e bounce agli attributi Brevo
• Mappatura dei segmenti - Replica i segmenti Mailchimp come liste o segmenti Brevo
• Dati e-commerce - Sincronizza dati di store, prodotti e ordini dall’e-commerce Mailchimp
• Sync dei tag - Mappa i tag Mailchimp agli attributi o liste contatti Brevo
• Migrazione template - Esporta i template Mailchimp per l’uso nelle campagne Brevo

Prerequisiti

Prima di iniziare, assicurati di avere:

1. Un account Mailchimp (Free, Essentials, Standard o Premium)
2. Una chiave API Mailchimp o un’app OAuth
3. Un account Brevo con accesso API
4. Un account Tajo

Autenticazione

Autenticazione con chiave API

Genera una chiave API da Mailchimp Account > Extras > API Keys.

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

Il prefisso del data center {dc} è l’ultima parte della tua chiave API (es. us21).

OAuth 2.0

Per integrazioni multi-account:

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

Configurazione

Setup di base

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

Mappatura dei campi

Mappa i merge field Mailchimp agli attributi di contatto Brevo:

Mappatura dei merge field personalizzati

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

Audience (Liste)

Campagne

Automazioni

E-commerce

Eventi

Eventi di campagna

Eventi iscritto

Eventi e-commerce

Esempi di codice

Inizializza il connettore

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

Migra le audience su 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
// }

Sincronizza i dati di engagement delle campagne

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

Limiti di velocità

Limiti di velocità della Mailchimp Marketing API:

Risoluzione dei problemi

Problemi comuni

Modalità debug

Abilita il logging dettagliato:

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

Testa la connessione

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

Best practice

1. Usa le operazioni batch - Usa subscribe/unsubscribe in batch per aggiornamenti in blocco
2. Preserva lo stato dell’iscritto - Rispetta il consenso all’iscrizione durante la migrazione
3. Mappa prima i merge field - Crea gli attributi Brevo corrispondenti prima della sync
4. Sincronizza i dati di engagement - Importa i tassi di apertura/click per la segmentazione storica
5. Gestisci gli stati di compliance - Rispetta gli stati GDPR e di eliminazione permanente
6. Usa la sync incrementale - Sincronizza solo le modifiche dall’ultima sync per ridurre l’uso dell’API

Sicurezza

• Autenticazione con chiave API - Chiave segreta passata come password HTTP Basic Auth
• OAuth 2.0 - Autorizzazione basata su token per accesso multi-account
• Cifratura TLS - Tutte le comunicazioni API cifrate via HTTPS
• Verifica webhook - Convalida l’origine del webhook con un secret condiviso
• Isolamento data center - Dati conservati in data center specifici per regione

Risorse correlate

• Riferimento Mailchimp Marketing API
• Guide API Mailchimp
• Connettore Brevo
• Connettore ActiveCampaign
• Skill Customer Sync