Mailchimp Connector

Forbind din Mailchimp-konto til Brevo via Tajo for problemfri målgruppemigrering, kampagnedatasynkronisering og forenet marketingautomatisering på tværs af begge platforme.

Oversigt

Funktioner

• Målgruppesynkronisering - Migrér og synkronisér Mailchimp-målgrupper med Brevo-kontaktlister
• Kampagnedata - Synkronisér kampagneperformance-data til forenet rapportering
• Automatiseringsmigrering - Knyt Mailchimp-automatiseringer til Brevo-workflows
• Engagementmetrikker - Synkronisér åbninger, klik og bounce-data til Brevo-attributter
• Segmentmapping - Replicér Mailchimp-segmenter som Brevo-lister eller -segmenter
• E-handelsdata - Synkronisér butiks-, produkt- og ordredata fra Mailchimp e-commerce
• Tag-synkronisering - Knyt Mailchimp-tags til Brevo-kontaktattributter eller -lister
• Skabelonmigrering - Eksportér Mailchimp-skabeloner til brug i Brevo-kampagner

Forudsætninger

Før du begynder, skal du sikre dig, at du har:

1. En Mailchimp-konto (Free, Essentials, Standard eller Premium)
2. En Mailchimp API-nøgle eller OAuth-app
3. En Brevo-konto med API-adgang
4. En Tajo-konto

Autentifikation

API-nøgle-autentifikation

Generér en API-nøgle fra Mailchimp Account > Extras > API Keys.

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

{dc}-datacenterpræfikset er den sidste del af din API-nøgle (f.eks. us21).

OAuth 2.0

Til integrationer på tværs af flere konti:

# 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æggende opsætning

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

Feltmapping

Knyt Mailchimp merge-felter til Brevo-kontaktattributter:

Brugerdefineret merge-feltmapping

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-endpoints

Målgrupper (lister)

Kampagner

Automatiseringer

E-handel

Hændelser

Kampagnehændelser

Abonnenthændelser

E-handelshændelser

Kodeeksempler

Initialisér konnektor

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

Migrér målgrupper til 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
// }

Synkronisér kampagneengagementdata

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

Ratebegrænsninger

Mailchimp Marketing API-ratebegrænsninger:

Fejlfinding

Almindelige problemer

Fejlfindingstilstand

Aktivér udførlig logning:

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

Test forbindelse

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

Best practices

1. Brug batch-operationer - Brug batch subscribe/unsubscribe til massemassemasseopdateringer
2. Bevar abonnentstatus - Respektér abonnementssamtykke under migrering
3. Map merge-felter først - Opret tilsvarende Brevo-attributter før synkronisering
4. Synkronisér engagementdata - Importér åbnings-/klikrater til historisk segmentering
5. Håndtér compliance-tilstande - Respektér GDPR- og permanent slettede tilstande
6. Brug inkrementel synkronisering - Synkronisér kun ændringer siden sidste synkronisering for at reducere API-forbrug

Sikkerhed

• API-nøgle-autentifikation - Hemmelig nøgle sendt som HTTP Basic Auth-adgangskode
• OAuth 2.0 - Tokenbaseret autorisation til adgang på tværs af flere konti
• TLS-kryptering - Al API-kommunikation krypteret via HTTPS
• Webhook-verifikation - Validér webhook-kilde med delt secret
• Datacenterisolering - Data lagres i regionsspecifikke datacentre

Relaterede ressourcer

• Mailchimp Marketing API-reference
• Mailchimp API-guider
• Brevo Connector
• ActiveCampaign Connector
• Customer Sync Skill