Mailchimp Connector

Poveži račun Mailchimp z Brevo prek Tajo za nemoteno migracijo občinstev, sinhronizacijo podatkov kampanj in enotno marketinško avtomatizacijo na obeh platformah.

Pregled

Funkcionalnosti

• Sinhronizacija občinstev – prenesi in sinhroniziraj občinstva Mailchimp z seznami stikov Brevo
• Podatki kampanj – sinhroniziraj podatke o uspešnosti kampanj za enotno poročanje
• Migracija avtomatizacij – preslikaj avtomatizacije Mailchimp v delovne tokove Brevo
• Metrike angažiranosti – sinhroniziraj odprtja, klike in podatke o odbitinicah v atribute Brevo
• Preslikava segmentov – replicira segmente Mailchimp kot sezname ali segmente Brevo
• Podatki e-trgovine – sinhroniziraj podatke o trgovini, izdelkih in naročilih iz e-trgovine Mailchimp
• Sinhronizacija oznak – preslikaj oznake Mailchimp v atribute stikov Brevo ali sezname
• Migracija predlog – izvozi predloge Mailchimp za uporabo v kampanjah Brevo

Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun Mailchimp (Free, Essentials, Standard ali Premium)
2. Ključ API Mailchimp ali OAuth aplikacijo
3. Brevo račun z dostopom do API
4. Tajo račun

Avtentikacija

Avtentikacija z API ključem

Ustvari ključ API iz Mailchimp Account > Extras > API Keys.

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

Predpona podatkovnega centra {dc} je zadnji del tvojega API ključa (npr. us21).

OAuth 2.0

Za integracije z več računi:

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

Konfiguracija

Osnovna nastavitev

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

Preslikava polj

Preslikaj zlivna polja Mailchimp v atribute stikov Brevo:

Preslikava zlivnih polj po meri

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

Končne točke API

Občinstva (seznami)

Kampanje

Avtomatizacije

E-trgovina

Dogodki

Dogodki kampanj

Dogodki naročnikov

Dogodki e-trgovine

Primeri kode

Inicializacija konektorja

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

Migracija občinstev v 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
// }

Sinhronizacija angažirnih podatkov kampanj

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

Omejitve hitrosti

Omejitve hitrosti Mailchimp Marketing API:

Odpravljanje težav

Pogoste težave

Način odpravljanja napak

Omogoči podrobno beleženje:

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

Preizkus povezave

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

Najboljše prakse

1. Uporabi paketne operacije – za množične posodobitve uporabi množično naročnino/odjavo
2. Ohrani status naročnikov – med migracijo upoštevaj soglasje za naročnino
3. Najprej preslikaj zlivna polja – pred sinhronizacijo ustvari ustrezne atribute Brevo
4. Sinhroniziraj angažirne podatke – uvozi stopnje odpiranja/klikov za zgodovinsko segmentacijo
5. Obravnavaj stanja skladnosti – spoštuj stanja GDPR in trajnega brisanja
6. Uporabi postopno sinhronizacijo – za zmanjšanje porabe API sinhroniziraj samo spremembe od zadnje sinhronizacije

Varnost

• Avtentikacija z API ključem – tajni ključ posredovan kot geslo HTTP Basic Auth
• OAuth 2.0 – avtorizacija na osnovi žetonov za dostop z več računi
• TLS šifriranje – vsa komunikacija API šifrirana prek HTTPS
• Preverjanje webhooks – potrdi vir webhooks s skupno skrivnostjo
• Izolacija podatkovnih centrov – podatki shranjeni v regijsko specifičnih podatkovnih centrih

Povezani viri

• Mailchimp Marketing API referenca
• Vodniki za Mailchimp API
• Brevo Connector
• ActiveCampaign Connector
• Customer Sync Skill