Mailchimp konnektor

Csatlakoztasd a Mailchimp fiókodat a Brevóhoz a Tajo segítségével zökkenőmentes közönség-migrációhoz, kampányadat-szinkronizáláshoz és egységesített marketingautomatizáláshoz mindkét platformon.

Áttekintés

Funkciók

• Közönség-szinkronizáció – Mailchimp közönségek migrálása és szinkronizálása Brevo kapcsolatlistákkal
• Kampányadatok – Kampány-teljesítményadatok szinkronizálása egységesített riportoláshoz
• Automatizálás migráció – Mailchimp automatizálások leképezése Brevo munkafolyamatokra
• Elköteleződési mutatók – Megnyitások, kattintások és visszapattanási adatok szinkronizálása Brevo attribútumokba
• Szegmens-leképezés – Mailchimp szegmensek replikálása Brevo listákként vagy szegmensekként
• E-kereskedelmi adatok – Áruházi, termék- és rendelési adatok szinkronizálása a Mailchimp e-kereskedelemből
• Címke-szinkronizáció – Mailchimp címkék leképezése Brevo kapcsolat-attribútumokra vagy listákra
• Sablon migráció – Mailchimp sablonok exportálása Brevo kampányokhoz való felhasználásra

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Mailchimp fiókkal (Ingyenes, Essentials, Standard vagy Premium csomag)
2. Egy Mailchimp API kulccsal vagy OAuth alkalmazással
3. Egy Brevo fiókkal API-hozzáféréssel
4. Egy Tajo fiókkal

Hitelesítés

API kulcs hitelesítés

Generálj API kulcsot a Mailchimp Fiók > Extrák > API kulcsok menüből.

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

A {dc} adatközpont előtag az API kulcsod utolsó része (pl. us21).

OAuth 2.0

Több fiókos integrációkhoz:

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

Konfiguráció

Alapbeállítás

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

Mezőleképezés

Képezd le a Mailchimp összevonási mezőket Brevo kapcsolat-attribútumokhoz:

Egyéni összevonási mező leképezés

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 végpontok

Közönségek (Listák)

Kampányok

Automatizálások

E-kereskedelem

Események

Kampányesemények

Feliratkozói események

E-kereskedelmi események

Kódpéldák

A konnektor inicializálása

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

Közönségek migrálása a Brevóba

// 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
// }

Kampány-elköteleződési adatok szinkronizálása

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

Ráta-korlátok

A Mailchimp Marketing API ráta-korlátjai:

Hibaelhárítás

Gyakori problémák

Hibakeresési mód

Engedélyezd a részletes naplózást:

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

Kapcsolat tesztelése

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

Legjobb gyakorlatok

1. Használj batch műveleteket – Tömeges feliratkozáshoz/leiratkozáshoz használj batch subscribe/unsubscribe végpontokat
2. Őrizd meg a feliratkozói státuszt – Tartsd tiszteletben a feliratkozási hozzájárulást migráció során
3. Előbb képezd le az összevonási mezőket – Hozd létre a megfelelő Brevo attribútumokat a szinkronizálás előtt
4. Szinkronizálj elköteleződési adatokat – Importálj megnyitási/kattintási arányokat a korábbi szegmentáláshoz
5. Kezeld a megfelelőségi állapotokat – Tartsd tiszteletben a GDPR és a végleges törlési állapotokat
6. Használj növekményes szinkronizálást – Csak az utolsó szinkronizálás óta bekövetkezett változásokat szinkronizáld az API-használat csökkentéséhez

Biztonság

• API kulcs hitelesítés – Titkos kulcs HTTP Basic Auth jelszóként átadva
• OAuth 2.0 – Token alapú engedélyezés több fiókos hozzáféréshez
• TLS titkosítás – Minden API kommunikáció HTTPS-en keresztül titkosítva
• Webhook ellenőrzés – Webhook forrás validálása megosztott titkos kulccsal
• Adatközpont izoláció – Adatok régióspecifikus adatközpontokban tárolva

Kapcsolódó források

• Mailchimp Marketing API referencia
• Mailchimp API útmutatók
• Brevo konnektor
• ActiveCampaign konnektor
• Ügyfél-szinkronizáció Skill