Mailchimp-koppling

Anslut ditt Mailchimp-konto till Brevo via Tajo för smidig migrering av publiker, synkronisering av kampanjdata och enhetlig marknadsautomation över båda plattformarna.

Översikt

Funktioner

• Publiksynk - Migrera och synka Mailchimp-publiker med Brevos kontaktlistor
• Kampanjdata - Synka kampanjprestanda för enhetlig rapportering
• Migrering av automationer - Mappa Mailchimp-automationer till Brevo-flöden
• Engagemangsmått - Synka öppningar, klick och studsar till Brevo-attribut
• Segmentmappning - Replikera Mailchimp-segment som Brevo-listor eller segment
• E-handelsdata - Synka butiks-, produkt- och orderdata från Mailchimp e-commerce
• Taggsynk - Mappa Mailchimp-taggar till Brevo-kontaktattribut eller -listor
• Mallmigrering - Exportera Mailchimp-mallar för användning i Brevo-kampanjer

Förutsättningar

Innan du börjar, se till att du har:

1. Ett Mailchimp-konto (Free, Essentials, Standard eller Premium)
2. En Mailchimp API-nyckel eller OAuth-app
3. Ett Brevo-konto med API-åtkomst
4. Ett Tajo-konto

Autentisering

API-nyckelautentisering

Generera en API-nyckel via Mailchimp Account > Extras > API Keys.

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

Prefixet {dc} (data center) är den sista delen av din API-nyckel (t.ex. us21).

OAuth 2.0

För integrationer med flera konton:

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

Konfiguration

Grundläggande konfiguration

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

Fältmappning

Mappa Mailchimp merge fields till Brevos kontaktattribut:

Anpassad mappning av merge fields

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-ändpunkter

Publiker (listor)

Kampanjer

Automationer

E-handel

Händelser

Kampanjhändelser

Prenumeranthändelser

E-handelshändelser

Kodexempel

Initiera kopplingen

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

Migrera publiker till 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
// }

Synka engagemangsdata för kampanjer

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

API-gränser

Rate limits för Mailchimp Marketing API:

Felsökning

Vanliga problem

Debug-läge

Aktivera utförlig loggning:

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

Testa anslutningen

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

Bästa praxis

1. Använd batchoperationer - Använd batch subscribe/unsubscribe för massuppdateringar
2. Bevara prenumerantstatus - Respektera prenumerationssamtycke under migreringen
3. Mappa merge fields först - Skapa motsvarande Brevo-attribut innan du synkar
4. Synka engagemangsdata - Importera öppnings-/klickfrekvenser för historisk segmentering
5. Hantera efterlevnadsstatus - Respektera GDPR och permanenta raderingstillstånd
6. Använd inkrementell synk - Synka bara ändringar sedan senaste synkron för att minska API-användningen

Säkerhet

• API-nyckelautentisering - Hemlig nyckel skickas som HTTP Basic Auth-lösenord
• OAuth 2.0 - Tokenbaserad auktorisering för åtkomst till flera konton
• TLS-kryptering - All API-kommunikation krypteras via HTTPS
• Webhook-verifiering - Validera webhook-källan med en delad hemlighet
• Isolerade data centers - Data lagras i regionsspecifika data centers

Relaterade resurser

• Mailchimp Marketing API-referens
• Mailchimp API-guider
• Brevo-koppling
• ActiveCampaign-koppling
• Skill för kundsynk