Σύνδεσμος Mailchimp

Συνδέστε τον λογαριασμό Mailchimp με το Brevo μέσω Tajo για απρόσκοπτη μετεγκατάσταση κοινού, συγχρονισμό δεδομένων καμπάνιας και ενοποιημένο αυτοματισμό marketing και στις δύο πλατφόρμες.

Επισκόπηση

Χαρακτηριστικά

• Συγχρονισμός κοινού - Μετεγκατάσταση και συγχρονισμός κοινών Mailchimp με λίστες επαφών Brevo
• Δεδομένα καμπάνιας - Συγχρονισμός δεδομένων απόδοσης καμπάνιας για ενοποιημένες αναφορές
• Μετεγκατάσταση αυτοματισμού - Αντιστοίχηση αυτοματισμών Mailchimp σε ροές εργασίας Brevo
• Μετρικά αφοσίωσης - Συγχρονισμός ανοιγμάτων, κλικ και δεδομένων αναπήδησης σε χαρακτηριστικά Brevo
• Αντιστοίχηση τμήματος - Αναπαραγωγή τμημάτων Mailchimp ως λίστες ή τμήματα Brevo
• Δεδομένα e-commerce - Συγχρονισμός δεδομένων καταστήματος, προϊόντος και παραγγελίας από e-commerce Mailchimp
• Συγχρονισμός ετικετών - Αντιστοίχηση ετικετών Mailchimp σε χαρακτηριστικά επαφών ή λίστες Brevo
• Μετεγκατάσταση προτύπων - Εξαγωγή προτύπων Mailchimp για χρήση σε καμπάνιες Brevo

Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό Mailchimp (Free, Essentials, Standard ή Premium)
2. Κλειδί API Mailchimp ή εφαρμογή OAuth
3. Λογαριασμό Brevo με πρόσβαση API
4. Λογαριασμό Tajo

Πιστοποίηση

Πιστοποίηση με Κλειδί API

Δημιουργήστε κλειδί API από Λογαριασμός Mailchimp > Extras > API Keys.

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

Το πρόθεμα κέντρου δεδομένων {dc} είναι το τελευταίο μέρος του κλειδιού API σας (π.χ. us21).

OAuth 2.0

Για ενσωματώσεις πολλαπλών λογαριασμών:

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

Διαμόρφωση

Βασική Ρύθμιση

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

Αντιστοίχιση Πεδίων

Αντιστοίχηση πεδίων συγχώνευσης Mailchimp σε χαρακτηριστικά επαφών Brevo:

Αντιστοίχηση Προσαρμοσμένων Πεδίων Συγχώνευσης

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

Endpoints API

Κοινά (Λίστες)

Καμπάνιες

Αυτοματισμοί

E-commerce

Εκδηλώσεις

Εκδηλώσεις Καμπάνιας

Εκδηλώσεις Συνδρομητή

Εκδηλώσεις E-commerce

Παραδείγματα Κώδικα

Αρχικοποίηση Συνδέσμου

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

Μετεγκατάσταση Κοινών στο 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
// }

Συγχρονισμός Δεδομένων Αφοσίωσης Καμπάνιας

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

Όρια Ρυθμού

Όρια ρυθμού Mailchimp Marketing API:

Αντιμετώπιση Προβλημάτων

Συνήθη Προβλήματα

Λειτουργία Εντοπισμού Σφαλμάτων

Ενεργοποίηση λεπτομερούς καταγραφής:

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

Δοκιμή Σύνδεσης

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

Βέλτιστες Πρακτικές

1. Χρησιμοποιήστε μαζικές λειτουργίες - Χρησιμοποιήστε μαζική εγγραφή/διαγραφή για μαζικές ενημερώσεις
2. Διατηρήστε κατάσταση συνδρομητή - Σεβαστείτε τη συγκατάθεση εγγραφής κατά τη μετεγκατάσταση
3. Αντιστοιχίστε πρώτα πεδία συγχώνευσης - Δημιουργήστε αντίστοιχα χαρακτηριστικά Brevo πριν τον συγχρονισμό
4. Συγχρονίστε δεδομένα αφοσίωσης - Εισαγάγετε ποσοστά ανοίγματος/κλικ για ιστορική τμηματοποίηση
5. Χειριστείτε καταστάσεις συμμόρφωσης - Σεβαστείτε καταστάσεις GDPR και μόνιμης διαγραφής
6. Χρησιμοποιήστε σταδιακό συγχρονισμό - Συγχρονίστε μόνο αλλαγές από τον τελευταίο συγχρονισμό για μείωση χρήσης API

Ασφάλεια

• Πιστοποίηση με Κλειδί API - Μυστικό κλειδί που περνά ως κωδικός HTTP Basic Auth
• OAuth 2.0 - Εξουσιοδότηση βάσει token για πρόσβαση πολλαπλών λογαριασμών
• Κρυπτογράφηση TLS - Όλη η επικοινωνία API κρυπτογραφείται μέσω HTTPS
• Επαλήθευση webhook - Επικύρωση πηγής webhook με κοινό μυστικό
• Απομόνωση κέντρου δεδομένων - Δεδομένα αποθηκευμένα σε ανά-περιοχή κέντρα δεδομένων

Σχετικοί Πόροι

• Mailchimp Marketing API Reference
• Mailchimp API Guides
• Σύνδεσμος Brevo
• Σύνδεσμος ActiveCampaign
• Δεξιότητα Συγχρονισμού Πελατών