Mailchimp कनेक्टर

सहज audience माइग्रेशन, कैंपेन डेटा सिंक्रनाइज़ेशन, और दोनों प्लेटफ़ॉर्म्स में एकीकृत मार्केटिंग ऑटोमेशन के लिए अपने Mailchimp खाते को Tajo के माध्यम से Brevo से कनेक्ट करें।

अवलोकन

विशेषताएं

• Audience सिंक - Brevo कॉन्टैक्ट lists के साथ Mailchimp audiences को माइग्रेट और सिंक करें
• कैंपेन डेटा - एकीकृत रिपोर्टिंग के लिए कैंपेन प्रदर्शन डेटा सिंक करें
• ऑटोमेशन माइग्रेशन - Mailchimp ऑटोमेशन्स को Brevo workflows में मैप करें
• एंगेजमेंट मेट्रिक्स - opens, clicks, और bounce डेटा को Brevo एट्रिब्यूट्स में सिंक करें
• Segment मैपिंग - Mailchimp segments को Brevo lists या segments के रूप में दोहराएं
• E-commerce डेटा - Mailchimp e-commerce से store, product, और order डेटा सिंक करें
• Tag सिंक - Mailchimp tags को Brevo कॉन्टैक्ट एट्रिब्यूट्स या lists में मैप करें
• Template माइग्रेशन - 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} data center 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 एंडपॉइंट्स

Audiences (Lists)

कैंपेन

ऑटोमेशन्स

E-commerce

इवेंट्स

कैंपेन इवेंट्स

Subscriber इवेंट्स

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 में Audiences माइग्रेट करें

// 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. batch operations का उपयोग करें - bulk अपडेट के लिए batch subscribe/unsubscribe का उपयोग करें
2. subscriber स्थिति संरक्षित करें - माइग्रेशन के दौरान subscription सहमति का सम्मान करें
3. पहले merge fields मैप करें - सिंक करने से पहले संबंधित Brevo एट्रिब्यूट्स बनाएं
4. एंगेजमेंट डेटा सिंक करें - ऐतिहासिक सेगमेंटेशन के लिए open/click rates आयात करें
5. compliance states हैंडल करें - GDPR और स्थायी deletion states का सम्मान करें
6. incremental sync का उपयोग करें - API उपयोग कम करने के लिए केवल पिछले sync के बाद के परिवर्तन सिंक करें

सुरक्षा

• API Key प्रमाणीकरण - Secret key को HTTP Basic Auth password के रूप में पारित किया जाता है
• OAuth 2.0 - मल्टी-अकाउंट एक्सेस के लिए token-आधारित authorization
• TLS एन्क्रिप्शन - सभी API संचार HTTPS के माध्यम से एन्क्रिप्टेड
• Webhook सत्यापन - shared secret के साथ webhook स्रोत सत्यापित करें
• Data center isolation - डेटा क्षेत्र-विशिष्ट data centers में संग्रहीत

संबंधित संसाधन

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