Mailchimp Konektor

Povežite vaš Mailchimp račun s Brevom putem Taja za besprijekornu migraciju publike, sinkronizaciju podataka o kampanjama i ujedinjenu marketinšku automatizaciju na obje platforme.

Pregled

Značajke

• Sinkronizacija publike - Migracija i sinkronizacija Mailchimp publika s Brevo popisima kontakata
• Podaci o kampanjama - Sinkronizacija podataka o performansama kampanje za ujedinjeno izvješćivanje
• Migracija automatizacija - Mapiranje Mailchimp automatizacija na Brevo tijekove rada
• Metrike angažmana - Sinkronizacija otvaranja, klikova i podataka o vraćenim porukama na Brevo atribute
• Mapiranje segmenata - Replikacija Mailchimp segmenata kao Brevo popisa ili segmenata
• E-commerce podaci - Sinkronizacija podataka o trgovini, proizvodu i narudžbi iz Mailchimp e-commerce
• Sinkronizacija oznaka - Mapiranje Mailchimp oznaka na Brevo atribute kontakata ili popise
• Migracija predložaka - Izvoz Mailchimp predložaka za korištenje u Brevo kampanjama

Preduvjeti

Prije nego što počnete, osigurajte da imate:

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

Autentifikacija

Autentifikacija API ključem

Generirajte API ključ u Mailchimp Računu > Extras > API ključevi.

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

Prefiks podatkovnog centra {dc} je zadnji dio vašeg API ključa (npr. us21).

OAuth 2.0

Za integracije s više računa:

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

# Razmjena tokena
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 konfiguracija

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

    # Opcije sinkronizacije podataka
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Mapiranje publike na Brevo popis
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42

Mapiranje polja

Mapirajte Mailchimp merge polja na Brevo atribute kontakata:

Mapiranje prilagođenih merge polja

field_mapping:
  # Standardna polja
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Metrike angažmana
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # E-commerce polja
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # Prilagođena merge polja
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE

API krajnje točke

Publike (Popisi)

Kampanje

Automatizacije

E-commerce

Događaji

Događaji kampanja

Događaji pretplatnika

E-commerce događaji

Primjeri koda

Inicijalizacija konektora

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

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

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

Migracija publika u Brevo

// Potpuna migracija publike iz Mailchimpa u Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

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

Sinkronizacija podataka o angažmanu kampanje

// Sinkronizacija performansi kampanje na Brevo atribute
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:

Rješavanje problema

Uobičajeni problemi

Način otklanjanja grešaka

Omogućite detaljno zapisivanje:

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

Testiranje veze

tajo connectors test mailchimp
# ✓ API veza uspješna
# ✓ Publike čitljive
# ✓ Kampanje čitljive
# ✓ E-commerce podaci dostupni
# ✓ Webhook konfiguriran

Preporučene prakse

1. Koristite skupne operacije - Koristite skupnu prijavu/odjavu za skupna ažuriranja
2. Čuvajte status pretplatnika - Poštujte suglasnost za pretplatu tokom migracije
3. Prvo mapirajte merge polja - Kreirajte odgovarajuće Brevo atribute prije sinkronizacije
4. Sinkronizirajte podatke o angažmanu - Uvezite stope otvaranja/klikanja za historijsku segmentaciju
5. Rukujte stanjima usklađenosti - Poštujte GDPR i stanja trajnog brisanja
6. Koristite inkrementalnu sinkronizaciju - Sinkronizirajte samo promjene od posljednje sinkronizacije za smanjenje korištenja API-ja

Sigurnost

• Autentifikacija API ključem - Tajni ključ proslijeđen kao lozinka HTTP Basic Auth
• OAuth 2.0 - Autorizacija temeljena na tokenima za pristup s više računa
• TLS šifriranje - Sva API komunikacija šifrirana putem HTTPS-a
• Verifikacija webhookova - Validacija izvora webhookova s dijeljenom tajnom
• Izolacija podatkovnih centara - Podaci pohranjeni u regionalnim podatkovnim centrima

Povezani resursi

• Mailchimp Marketing API referenca
• Mailchimp vodiči za API
• Brevo Konektor
• ActiveCampaign Konektor
• Vještina sinkronizacije korisnika