Mailchimp konektor

Poveži svoj Mailchimp nalog sa Brevo putem Tajo za besprekornu migraciju publike, sinhronizaciju podataka kampanja i unifikovanu marketing automatizaciju na obe platforme.

Pregled

Karakteristike

• Sinhronizacija publike - Migracija i sinhronizacija Mailchimp publika sa Brevo listama kontakata
• Podaci kampanje - Sinhronizacija podataka o performansama kampanje za unifikovano izveštavanje
• Migracija automatizacija - Mapiranje Mailchimp automatizacija na Brevo tokove rada
• Metrike angažovanja - Sinhronizacija otvaranja, klikova i podataka o odbijanju na Brevo atribute
• Mapiranje segmenata - Replikacija Mailchimp segmenata kao Brevo lista ili segmenata
• E-commerce podaci - Sinhronizacija podataka prodavnice, proizvoda i porudžbina iz Mailchimp e-commerce
• Sinhronizacija tagova - Mapiranje Mailchimp tagova na Brevo atribute kontakta ili liste
• Migracija šablona - Izvoz Mailchimp šablona za upotrebu u Brevo kampanjama

Preduslovi

Pre nego što započneš, proveri da imaš:

1. Mailchimp nalog (Free, Essentials, Standard ili Premium)
2. Mailchimp API ključ ili OAuth aplikaciju
3. Brevo nalog sa API pristupom
4. Tajo nalog

Autentifikacija

Autentifikacija API ključem

Generiši API ključ iz Mailchimp Account > Extras > API Keys.

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

Prefiks {dc} centra podataka je poslednji deo API ključa (npr. us21).

OAuth 2.0

Za integracije sa više naloga:

# 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

Osnovno podešavanje

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

Mapiranje polja

Mapiranje Mailchimp merge polja na Brevo atribute kontakta:

Mapiranje prilagođenih merge polja

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 endpointi

Publike (Liste)

Kampanje

Automatizacije

E-commerce

Događaji

Događaji kampanje

Događaji pretplatnika

E-commerce događaji

Primeri koda

Inicijalizacija konektora

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 publika u 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 podataka o angažovanju kampanje

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

Ograničenja brzine

Ograničenja brzine Mailchimp Marketing API-ja:

Rešavanje problema

Česti problemi

Debug režim

Uključi detaljno logovanje:

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

Testiraj vezu

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

Najbolje prakse

1. Koristi batch operacije - Koristi batch pretplatu/odjavu za bulk ažuriranja
2. Sačuvaj status pretplatnika - Poštuj pristanak na pretplatu tokom migracije
3. Prvo mapiraj merge polja - Kreiraj odgovarajuće Brevo atribute pre sinhronizacije
4. Sinhronizuj podatke o angažovanju - Uvozi stope otvaranja/klikanja za istorijsku segmentaciju
5. Obradi stanja usklađenosti - Poštuj GDPR i stanja trajnog brisanja
6. Koristi inkrementalnu sinhronizaciju - Sinhronizuj samo promene od poslednje sinhronizacije da smanjiš upotrebu API-ja

Bezbednost

• Autentifikacija API ključem - Tajni ključ prosleđen kao HTTP Basic Auth lozinka
• OAuth 2.0 - Autorizacija zasnovana na tokenima za pristup sa više naloga
• TLS enkripcija - Sva API komunikacija enkriptovana putem HTTPS
• Verifikacija webhook-ova - Validiraj izvor webhook-a deljenom tajnom
• Izolacija centra podataka - Podaci sačuvani u regionalnim centrima podataka

Povezani resursi

• Mailchimp Marketing API referenca
• Mailchimp API vodiči
• Brevo konektor
• ActiveCampaign konektor
• Customer Sync veština