Mailchimp کنیکٹر

دونوں پلیٹ فارمز پر بے رکاوٹ آڈیئنس منتقلی، مہم ڈیٹا سنکرونائزیشن، اور متحدہ مارکیٹنگ آٹومیشن کے لیے Tajo کے ذریعے اپنے Mailchimp اکاؤنٹ کو Brevo سے منسلک کریں۔

جائزہ

خصوصیات

• آڈیئنس سنک - Mailchimp آڈیئنسز کو Brevo رابطہ فہرستوں کے ساتھ منتقل اور سنک کریں
• مہم ڈیٹا - متحدہ رپورٹنگ کے لیے مہم کارکردگی ڈیٹا سنک کریں
• آٹومیشن منتقلی - Mailchimp آٹومیشنز کو Brevo ورک فلوز پر میپ کریں
• Engagement میٹرکس - opens, clicks, اور bounce ڈیٹا کو Brevo خصوصیات پر سنک کریں
• سیگمنٹ میپنگ - Mailchimp سیگمنٹس کو Brevo فہرستوں یا سیگمنٹس کے طور پر نقل کریں
• ای کامرس ڈیٹا - Mailchimp ای کامرس سے اسٹور، پروڈکٹ، اور آرڈر ڈیٹا سنک کریں
• ٹیگ سنک - Mailchimp ٹیگز کو Brevo رابطہ خصوصیات یا فہرستوں پر میپ کریں
• ٹیمپلیٹ منتقلی - Brevo مہمات میں استعمال کے لیے Mailchimp templates ایکسپورٹ کریں

شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. Mailchimp اکاؤنٹ (Free, Essentials, Standard, یا Premium)
2. Mailchimp API key یا OAuth ایپ
3. API رسائی کے ساتھ Brevo اکاؤنٹ
4. Tajo اکاؤنٹ

تصدیق

API Key تصدیق

Mailchimp Account > Extras > API Keys سے API key تیار کریں۔

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

{dc} ڈیٹا سینٹر prefix آپ کی 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

فیلڈ میپنگ

Mailchimp merge fields کو Brevo رابطہ خصوصیات پر میپ کریں:

کسٹم 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 اینڈ پوائنٹس

آڈیئنسز (فہرستیں)

مہمات

آٹومیشنز

ای کامرس

ایونٹس

مہم ایونٹس

سبسکرائبر ایونٹس

ای کامرس ایونٹس

کوڈ کی مثالیں

کنیکٹر کو انیشیلائز کریں

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
// }

مہم 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'
  }
});

شرح کی حدود

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. بیچ آپریشنز استعمال کریں - بلک اپ ڈیٹس کے لیے بیچ subscribe/unsubscribe استعمال کریں
2. سبسکرائبر اسٹیٹس کو محفوظ رکھیں - منتقلی کے دوران سبسکرپشن رضامندی کا احترام کریں
3. پہلے merge fields میپ کریں - سنک کرنے سے پہلے متعلقہ Brevo خصوصیات بنائیں
4. Engagement ڈیٹا سنک کریں - تاریخی segmentation کے لیے open/click ریٹس امپورٹ کریں
5. Compliance حالات کو سنبھالیں - GDPR اور مستقل حذف حالات کا احترام کریں
6. Incremental sync استعمال کریں - API استعمال کم کرنے کے لیے صرف آخری sync کے بعد کی تبدیلیاں سنک کریں

سیکیورٹی

• API Key تصدیق - HTTP Basic Auth password کے طور پر منتقل کردہ secret key
• OAuth 2.0 - ملٹی اکاؤنٹ رسائی کے لیے token پر مبنی اجازت
• TLS انکرپشن - تمام API مواصلات HTTPS کے ذریعے انکرپٹڈ
• Webhook توثیق - shared secret کے ساتھ webhook ماخذ کی توثیق کریں
• ڈیٹا سینٹر isolation - ڈیٹا region مخصوص ڈیٹا سینٹرز میں ذخیرہ کیا جاتا ہے

متعلقہ وسائل

• Mailchimp Marketing API Reference
• Mailchimp API Guides
• Brevo کنیکٹر
• ActiveCampaign کنیکٹر
• گاہک سنک اسکل