Mailchimp-kobling

Koble Mailchimp-kontoen din til Brevo via Tajo for sømløs målgruppemigrering, kampanjedatasynkronisering og enhetlig markedsføringsautomatisering på tvers av begge plattformene.

Oversikt

Funksjoner

• Målgruppesynkronisering - Migrer og synkroniser Mailchimp-målgrupper med Brevo-kontaktlister
• Kampanjedata - Synkroniser kampanjeytelsesdata for enhetlig rapportering
• Automatiseringsmigrering - Mapp Mailchimp-automatiseringer til Brevo-arbeidsflyter
• Engasjementsmålinger - Synkroniser åpninger, klikk og returdata til Brevo-attributter
• Segmentmapping - Replikér Mailchimp-segmenter som Brevo-lister eller -segmenter
• E-handelsdata - Synkroniser butikk-, produkt- og ordredata fra Mailchimp e-handel
• Tag-synkronisering - Mapp Mailchimp-tagger til Brevo-kontaktattributter eller -lister
• Malmigrering - Eksporter Mailchimp-maler for bruk i Brevo-kampanjer

Forutsetninger

Før du begynner, sørg for at du har:

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

Autentisering

API-nøkkelautentisering

Generer en API-nøkkel 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}-datasenterprefikset er den siste delen av API-nøkkelen din (f.eks. us21).

OAuth 2.0

For flerkonto-integrasjoner:

# Autorisasjons-URL
https://login.mailchimp.com/oauth2/authorize?
  response_type=code&
  client_id={client_id}&
  redirect_uri={redirect_uri}

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

Konfigurasjon

Grunnleggende oppsett

connectors:
  mailchimp:
    enabled: true
    api_key: "${MAILCHIMP_API_KEY}"
    data_center: "us21"

    # Synkroniseringsalternativer
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Mapping av målgruppe til Brevo-liste
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42

Feltmapping

Mapp Mailchimp merge-felt til Brevo-kontaktattributter:

Mapping av egendefinerte merge-felt

field_mapping:
  # Standardfelt
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Engasjementsmålinger
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # E-handelsfelt
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # Egendefinerte merge-felt
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE

API-endepunkter

Målgrupper (Lists)

Kampanjer

Automatiseringer

E-handel

Hendelser

Kampanjehendelser

Abonnenthendelser

E-handelshendelser

Kodeeksempler

Initialiser kobling

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Koble til Mailchimp
await tajo.connectors.connect('mailchimp', {
  apiKey: process.env.MAILCHIMP_API_KEY
});

Migrer målgrupper til Brevo

// Full målgruppemigrering fra Mailchimp til Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

// Sjekk migrasjonsstatus
const status = await tajo.connectors.status('mailchimp');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 52000,
//   campaignsSynced: 245,
//   segmentsMapped: 18
// }

Synkroniser kampanjeengasjementsdata

// Synkroniser kampanjeytelse til Brevo-attributter
await tajo.connectors.sync('mailchimp', {
  type: 'incremental',
  resources: ['campaigns'],
  options: {
    syncEngagement: true,
    updateContactMetrics: true,
    since: '2024-01-01'
  }
});

Ratebegrensninger

Mailchimp Marketing API-ratebegrensninger:

Feilsøking

Vanlige problemer

Feilsøkingsmodus

Aktiver utvidet logging:

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

Test tilkobling

tajo connectors test mailchimp
# ✓ API-tilkobling vellykket
# ✓ Målgrupper lesbare
# ✓ Kampanjer lesbare
# ✓ E-handelsdata tilgjengelige
# ✓ Webhook konfigurert

Beste praksis

1. Bruk batchoperasjoner - Bruk batchabonnering/avmelding for bulkoppdateringer
2. Bevar abonnentstatus - Respekter abonnementssamtykke under migrering
3. Mapp merge-felt først - Opprett tilsvarende Brevo-attributter før synkronisering
4. Synkroniser engasjementsdata - Importer åpnings-/klikkrater for historisk segmentering
5. Håndter etterlevelsestilstander - Respekter GDPR- og permanente slettingstilstander
6. Bruk inkrementell synkronisering - Synkroniser kun endringer siden siste synkronisering for å redusere API-bruk

Sikkerhet

• API-nøkkelautentisering - Hemmelig nøkkel sendes som HTTP Basic Auth-passord
• OAuth 2.0 - Token-basert autorisasjon for flerkonto-tilgang
• TLS-kryptering - All API-kommunikasjon kryptert via HTTPS
• Webhook-verifisering - Valider webhook-kilde med delt hemmelighet
• Datasenterisolering - Data lagret i regionsspesifikke datasentre

Relaterte ressurser

• Mailchimp Marketing API-referanse
• Mailchimp API-veiledninger
• Brevo-kobling
• ActiveCampaign-kobling
• Customer Sync-ferdighet