Mailchimp Connector

เชื่อมต่อบัญชี Mailchimp ของคุณกับ Brevo ผ่าน Tajo เพื่อการย้าย audience ที่ราบรื่น การซิงค์ข้อมูลแคมเปญ และ marketing automation ที่รวมกันบนทั้งสองแพลตฟอร์ม

ภาพรวม

ฟีเจอร์

• การซิงค์ Audience - ย้ายและซิงค์ Mailchimp audiences กับ Brevo contact lists
• ข้อมูลแคมเปญ - ซิงค์ข้อมูลประสิทธิภาพแคมเปญสำหรับรายงานที่รวมกัน
• การย้าย Automation - แมป Mailchimp automations กับ Brevo workflows
• Engagement metrics - ซิงค์ข้อมูลการเปิด คลิก และ bounce ไปยัง Brevo attributes
• การแมป Segment - จำลอง Mailchimp segments เป็นรายการหรือ segments ของ Brevo
• ข้อมูล E-commerce - ซิงค์ข้อมูล store สินค้า และคำสั่งซื้อจาก Mailchimp e-commerce
• การซิงค์ Tag - แมป Mailchimp tags กับ Brevo contact attributes หรือรายการ
• การย้าย Template - ส่งออก Mailchimp templates สำหรับใช้ในแคมเปญ Brevo

ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:

1. บัญชี Mailchimp (Free, Essentials, Standard หรือ Premium)
2. Mailchimp API key หรือ OAuth app
3. บัญชี Brevo ที่มีสิทธิ์เข้าถึง API
4. บัญชี Tajo

การยืนยันตัวตน

การยืนยันตัวตนด้วย API Key

สร้าง API key จาก Mailchimp Account > Extras > API Keys

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

คำนำหน้า data center {dc} คือส่วนสุดท้ายของ API key ของคุณ (เช่น 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

การแมปฟิลด์

แมป merge fields ของ Mailchimp กับแอตทริบิวต์ผู้ติดต่อ Brevo:

การแมป Custom Merge Field

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 Endpoints

Audiences (Lists)

แคมเปญ

Automations

E-commerce

เหตุการณ์

เหตุการณ์แคมเปญ

เหตุการณ์ผู้สมัคร

เหตุการณ์ E-commerce

ตัวอย่างโค้ด

เริ่มต้น Connector

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

ย้าย Audiences ไปยัง 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
// }

ซิงค์ข้อมูล Campaign Engagement

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

ขีดจำกัดอัตรา

Rate limits ของ Mailchimp Marketing API:

การแก้ไขปัญหา

ปัญหาทั่วไป

โหมด Debug

เปิดใช้งาน verbose logging:

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. ใช้ batch operations - ใช้ batch subscribe/unsubscribe สำหรับการอัปเดตจำนวนมาก
2. รักษาสถานะผู้สมัคร - เคารพการยินยอม subscription ระหว่างการย้าย
3. แมป merge fields ก่อน - สร้าง Brevo attributes ที่สอดคล้องกันก่อนซิงค์
4. ซิงค์ข้อมูล engagement - นำเข้าอัตราการเปิด/คลิกสำหรับการแบ่ง segment ย้อนหลัง
5. จัดการ compliance states - เคารพสถานะการลบ GDPR และถาวร
6. ใช้ incremental sync - ซิงค์เฉพาะการเปลี่ยนแปลงตั้งแต่ sync ครั้งล่าสุดเพื่อลดการใช้ API

ความปลอดภัย

• การยืนยันตัวตนด้วย API Key - Secret key ส่งผ่าน HTTP Basic Auth password
• OAuth 2.0 - การอนุมัติด้วย token สำหรับการเข้าถึงหลายบัญชี
• การเข้ารหัส TLS - การสื่อสาร API ทั้งหมดเข้ารหัสผ่าน HTTPS
• การตรวจสอบ Webhook - ตรวจสอบแหล่ง webhook ด้วย shared secret
• การแยก Data center - ข้อมูลเก็บใน data centers เฉพาะภูมิภาค

แหล่งข้อมูลที่เกี่ยวข้อง

• Mailchimp Marketing API Reference
• Mailchimp API Guides
• Brevo Connector
• ActiveCampaign Connector
• Customer Sync Skill