Konektor Mailchimp

Propojte svůj účet Mailchimp s Brevo přes Tajo pro bezproblémovou migraci publik, synchronizaci dat kampaní a sjednocenou marketingovou automatizaci napříč oběma platformami.

Přehled

Funkce

• Synchronizace publik – Migrujte a synchronizujte publika Mailchimp se seznamy kontaktů Brevo
• Data kampaní – Synchronizujte data výkonu kampaní pro sjednocené reportování
• Migrace automatizací – Mapujte automatizace Mailchimp na pracovní toky Brevo
• Metriky zapojení – Synchronizujte data o otevřeních, kliknutích a odrazech na atributy Brevo
• Mapování segmentů – Replikujte segmenty Mailchimp jako seznamy nebo segmenty Brevo
• Data e-commerce – Synchronizujte data obchodu, produktů a objednávek z e-commerce Mailchimp
• Synchronizace štítků – Mapujte štítky Mailchimp na atributy kontaktů Brevo nebo seznamy
• Migrace šablon – Exportujte šablony Mailchimp pro použití v kampaních Brevo

Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Mailchimp (Free, Essentials, Standard nebo Premium)
2. API klíč Mailchimp nebo OAuth aplikaci
3. Účet Brevo s přístupem k API
4. Účet Tajo

Ověření

Ověření API klíčem

Vygenerujte API klíč z Mailchimp Účet > Doplňky > API Keys.

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

Prefix datového centra {dc} je poslední část vašeho API klíče (např. us21).

OAuth 2.0

Pro integrace s více účty:

# Autorizační URL
https://login.mailchimp.com/oauth2/authorize?
  response_type=code&
  client_id={client_id}&
  redirect_uri={redirect_uri}

# Výměna tokenů
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}"

Konfigurace

Základní nastavení

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

    # Možnosti synchronizace dat
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Mapování publika na seznam Brevo
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42

Mapování polí

Mapujte sloučená pole Mailchimp na atributy kontaktů Brevo:

Mapování vlastních sloučených polí

field_mapping:
  # Standardní pole
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Metriky zapojení
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # Pole e-commerce
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # Vlastní sloučená pole
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE

Koncové body API

Publika (Seznamy)

Kampaně

Automatizace

E-commerce

Události

Události kampaní

Události odběratelů

Události e-commerce

Příklady kódu

Inicializace konektoru

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

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

// Připojení Mailchimp
await tajo.connectors.connect('mailchimp', {
  apiKey: process.env.MAILCHIMP_API_KEY
});

Migrace publik do Brevo

// Úplná migrace publik z Mailchimp do Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

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

Synchronizace dat o zapojení kampaní

// Synchronizace výkonu kampaní na atributy Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'incremental',
  resources: ['campaigns'],
  options: {
    syncEngagement: true,
    updateContactMetrics: true,
    since: '2024-01-01'
  }
});

Omezení rychlosti

Limity rychlosti Marketing API Mailchimp:

Řešení problémů

Časté problémy

Režim ladění

Povolte podrobné protokolování:

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

Test připojení

tajo connectors test mailchimp
# ✓ Připojení API úspěšné
# ✓ Publika čitelná
# ✓ Kampaně čitelné
# ✓ Data e-commerce přístupná
# ✓ Webhook nakonfigurován

Osvědčené postupy

1. Používejte dávkové operace – Používejte dávkové přihlášení/odhlášení pro hromadné aktualizace
2. Zachovejte stav odběru – Respektujte souhlas s odběrem během migrace
3. Nejprve mapujte sloučená pole – Vytvořte odpovídající atributy Brevo před synchronizací
4. Synchronizujte data o zapojení – Importujte míry otevření/prokliku pro historickou segmentaci
5. Zpracujte stavy souladu – Respektujte stavy GDPR a trvalého smazání
6. Používejte přírůstkovou synchronizaci – Synchronizujte pouze změny od poslední synchronizace pro snížení využití API

Zabezpečení

• Ověřování API klíčem – Tajný klíč předávaný jako heslo HTTP Basic Auth
• OAuth 2.0 – Ověřování na základě tokenů pro přístup k více účtům
• Šifrování TLS – Veškerá API komunikace šifrovaná přes HTTPS
• Ověření webhooků – Ověřujte zdroj webhooku pomocí sdíleného tajného klíče
• Izolace datového centra – Data uložena v datových centrech specifických pro region

Související zdroje

• Reference Mailchimp Marketing API
• Průvodci Mailchimp API
• Konektor Brevo
• Konektor ActiveCampaign
• Dovednost synchronizace zákazníků