موصل Mailchimp

اربط حساب Mailchimp الخاص بك مع Brevo عبر Tajo لترحيل الجماهير بسلاسة، ومزامنة بيانات الحملات، وأتمتة تسويقية موحدة عبر المنصتين.

نظرة عامة

الميزات

• مزامنة الجمهور - ترحيل ومزامنة جماهير Mailchimp مع قوائم جهات اتصال Brevo
• بيانات الحملات - مزامنة بيانات أداء الحملات للتقارير الموحدة
• ترحيل الأتمتة - تعيين أتمتة Mailchimp لسير عمل Brevo
• مقاييس التفاعل - مزامنة الفتح والنقرات وبيانات الارتداد مع سمات Brevo
• تعيين الشرائح - نسخ شرائح Mailchimp كقوائم أو شرائح Brevo
• بيانات التجارة الإلكترونية - مزامنة بيانات المتاجر والمنتجات والطلبات من Mailchimp e-commerce
• مزامنة الوسوم - تعيين وسوم Mailchimp لسمات جهات اتصال Brevo أو القوائم
• ترحيل القوالب - تصدير قوالب Mailchimp لاستخدامها في حملات Brevo

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

1. حساب Mailchimp (Free أو Essentials أو Standard أو Premium)
2. مفتاح Mailchimp API أو تطبيق OAuth
3. حساب Brevo مع وصول إلى API
4. حساب Tajo

المصادقة

مصادقة مفتاح API

أنشئ مفتاح API من Mailchimp Account > 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

نقاط نهاية واجهة البرمجة

الجماهير (القوائم)

الحملات

الأتمتة

التجارة الإلكترونية

الأحداث

أحداث الحملات

أحداث المشتركين

أحداث التجارة الإلكترونية

أمثلة على الكود

تهيئة الموصل

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

// ترحيل كامل للجمهور من Mailchimp إلى Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

// التحقق من حالة الترحيل
const status = await tajo.connectors.status('mailchimp');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 52000,
//   campaignsSynced: 245,
//   segmentsMapped: 18
// }

مزامنة بيانات تفاعل الحملة

// مزامنة أداء الحملة مع سمات Brevo
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 - تفويض قائم على الرموز للوصول متعدد الحسابات
• تشفير TLS - جميع اتصالات API مشفرة عبر HTTPS
• التحقق من Webhook - تحقق من مصدر webhook بسر مشترك
• عزل مركز البيانات - تُخزَّن البيانات في مراكز بيانات خاصة بالمنطقة

موارد ذات صلة

• مرجع Mailchimp Marketing API
• أدلة Mailchimp API
• موصل Brevo
• موصل ActiveCampaign
• مهارة مزامنة العملاء