Trình Kết Nối Mailchimp

Kết nối tài khoản Mailchimp của bạn với Brevo qua Tajo để migration audience liền mạch, đồng bộ dữ liệu campaign và marketing automation hợp nhất trên cả hai nền tảng.

Tổng Quan

Tính Năng

• Đồng bộ audience - Migrate và đồng bộ Mailchimp audiences với danh sách contacts Brevo
• Dữ liệu campaign - Đồng bộ dữ liệu hiệu suất campaign cho báo cáo hợp nhất
• Migration automation - Ánh xạ Mailchimp automations sang Brevo workflows
• Số liệu tương tác - Đồng bộ opens, clicks và bounce data sang thuộc tính Brevo
• Ánh xạ segment - Sao chép Mailchimp segments như Brevo lists hoặc segments
• Dữ liệu E-commerce - Đồng bộ store, product và order data từ Mailchimp e-commerce
• Đồng bộ tag - Ánh xạ Mailchimp tags sang thuộc tính liên hệ Brevo hoặc lists
• Migration template - Xuất Mailchimp templates để dùng trong Brevo campaigns

Yêu Cầu

Trước khi bắt đầu, hãy đảm bảo bạn có:

1. Tài khoản Mailchimp (Free, Essentials, Standard, hoặc Premium)
2. Mailchimp API key hoặc OAuth app
3. Tài khoản Brevo với quyền truy cập API
4. Tài khoản Tajo

Xác Thực

Xác Thực API Key

Tạo API key trong Mailchimp Account > Extras > API Keys.

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

Tiền tố data center {dc} là phần cuối của API key (ví dụ: us21).

OAuth 2.0

Cho tích hợp đa tài khoản:

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

# Đổi 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}"

Cấu Hình

Thiết Lập Cơ Bản

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

    # Tùy chọn đồng bộ dữ liệu
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Ánh xạ audience sang danh sách Brevo
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42

Ánh Xạ Trường

Ánh xạ Mailchimp merge fields sang thuộc tính liên hệ Brevo:

Ánh Xạ Custom Merge Field

field_mapping:
  # Trường tiêu chuẩn
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Số liệu tương tác
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # Trường E-commerce
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # Custom merge fields
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE

API Endpoints

Audiences (Lists)

Campaigns

Automations

E-commerce

Sự Kiện

Sự Kiện Campaign

Sự Kiện Subscriber

Sự Kiện E-commerce

Ví Dụ Code

Khởi Tạo Trình Kết Nối

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

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

// Kết nối Mailchimp
await tajo.connectors.connect('mailchimp', {
  apiKey: process.env.MAILCHIMP_API_KEY
});

Migrate Audiences Sang Brevo

// Migration audience đầy đủ từ Mailchimp sang Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

// Kiểm tra trạng thái migration
const status = await tajo.connectors.status('mailchimp');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 52000,
//   campaignsSynced: 245,
//   segmentsMapped: 18
// }

Đồng Bộ Dữ Liệu Campaign Engagement

// Đồng bộ hiệu suất campaign sang thuộc tính Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'incremental',
  resources: ['campaigns'],
  options: {
    syncEngagement: true,
    updateContactMetrics: true,
    since: '2024-01-01'
  }
});

Giới Hạn Tốc Độ

Giới hạn tốc độ Mailchimp Marketing API:

Khắc Phục Sự Cố

Sự Cố Phổ Biến

Chế Độ Debug

Bật verbose logging:

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

Kiểm Tra Kết Nối

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

Thực Hành Tốt Nhất

1. Sử dụng batch operations - Sử dụng batch subscribe/unsubscribe cho cập nhật hàng loạt
2. Bảo toàn subscriber status - Tôn trọng subscriber consent trong quá trình migration
3. Ánh xạ merge fields trước - Tạo thuộc tính Brevo tương ứng trước khi đồng bộ
4. Đồng bộ engagement data - Nhập open/click rates cho phân đoạn lịch sử
5. Xử lý compliance states - Tôn trọng trạng thái GDPR và permanent deletion
6. Sử dụng incremental sync - Chỉ đồng bộ thay đổi kể từ lần đồng bộ cuối để giảm tải API

Bảo Mật

• Xác thực API Key - Secret key được truyền qua HTTP Basic Auth password
• OAuth 2.0 - Ủy quyền dựa trên token cho truy cập đa tài khoản
• Mã hóa TLS - Tất cả giao tiếp API được mã hóa qua HTTPS
• Xác minh Webhook - Xác thực nguồn gốc webhook với shared secret
• Cô lập data center - Dữ liệu được lưu trữ trong data centers theo khu vực

Tài Nguyên Liên Quan

• Tham Khảo Mailchimp Marketing API
• Hướng Dẫn Mailchimp API
• Trình Kết Nối Brevo
• Trình Kết Nối ActiveCampaign
• Customer Sync Skill