Iterable कनेक्टर

एकीकृत ग्राहक एंगेजमेंट, क्रॉस-चैनल कैंपेन समन्वय, और मार्केटिंग टूल्स में समेकित एनालिटिक्स के लिए अपने Iterable growth मार्केटिंग प्लेटफ़ॉर्म को Brevo से कनेक्ट करें।

अवलोकन

विशेषताएं

• उपयोगकर्ता प्रोफ़ाइल सिंक - Brevo कॉन्टैक्ट्स के साथ द्विदिशीय उपयोगकर्ता डेटा सिंक्रनाइज़ेशन
• कैंपेन एनालिटिक्स - एकीकृत रिपोर्टिंग के लिए कैंपेन send, open, और click मेट्रिक्स सिंक करें
• प्रयोग डेटा - A/B टेस्ट परिणाम और winning variants ट्रैक करें
• कैटलॉग सिंक - प्लेटफ़ॉर्म्स में उत्पाद और सामग्री कैटलॉग सिंक्रनाइज़ करें
• वर्कफ़्लो इवेंट्स - workflow trigger और completion इवेंट्स को Brevo में फ़ॉरवर्ड करें
• चैनल वरीयता सिंक - Brevo में उपयोगकर्ता संचार वरीयताओं को दोहराएं

पूर्वावश्यकताएं

शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:

1. API एक्सेस के साथ एक Iterable खाता
2. उपयुक्त अनुमतियों के साथ एक Iterable API key
3. आपका Iterable project ID
4. API एक्सेस वाला एक Brevo खाता
5. एक सक्रिय सब्सक्रिप्शन वाला Tajo खाता

प्रमाणीकरण

Iterable अनुरोध हेडर में पारित API key प्रमाणीकरण का उपयोग करता है।

एक API Key बनाना

1. अपने Iterable डैशबोर्ड में लॉग इन करें
2. Integrations > API Keys पर जाएं
3. New API Key पर क्लिक करें
4. इसे “Tajo Integration” नाम दें
5. Server-side key type चुनें
6. निम्नलिखित अनुमतियां प्रदान करें:

Users: Read/Write
Events: Read/Write
Campaigns: Read
Lists: Read/Write
Catalogs: Read
Experiments: Read
Workflows: Read
Templates: Read
Channels: Read
Message Types: Read

Tajo से कनेक्ट करना

tajo connectors install iterable \
  --api-key $ITERABLE_API_KEY

कॉन्फ़िगरेशन

बुनियादी सेटअप

connectors:
  iterable:
    enabled: true

    sync:
      users: true
      events: true
      campaigns: true
      catalogs: true
      experiments: true

    lists:
      all_users: 16
      engaged_users: 17
      inactive_users: 18

फ़ील्ड मैपिंग

Iterable उपयोगकर्ता फ़ील्ड्स को Brevo कॉन्टैक्ट एट्रिब्यूट्स में मैप करें:

field_mapping:
  # Standard fields
  userId: ITERABLE_ID
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phoneNumber: SMS

  # Engagement data
  signupDate: SIGNUP_DATE
  totalPurchases: TOTAL_PURCHASES
  lastPurchaseDate: LAST_PURCHASE

  # Custom fields
  plan_name: PLAN_NAME
  company_size: COMPANY_SIZE
  preferred_channel: PREFERRED_CHANNEL
  lifecycle_stage: LIFECYCLE_STAGE

इवेंट कॉन्फ़िगरेशन

event_mapping:
  # Iterable event -> Brevo event
  purchase: ORDER_PLACED
  addToCart: CART_UPDATED
  pageView: PAGE_VIEWED
  appOpen: APP_OPENED
  pushOpen: PUSH_ENGAGED

API एंडपॉइंट्स

Tajo निम्नलिखित Iterable API एंडपॉइंट्स के साथ इंटीग्रेट होता है:

कोड उदाहरण

कनेक्टर प्रारंभ करें

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

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

await tajo.connectors.connect('iterable', {
  apiKey: process.env.ITERABLE_API_KEY
});

उपयोगकर्ता सिंक करें

// Incremental user sync from Iterable to Brevo
await tajo.connectors.sync('iterable', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

const status = await tajo.connectors.status('iterable');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T09:45:00Z',
//   usersCount: 58700,
//   campaignsTracked: 42,
//   eventsProcessed: 210000
// }

इवेंट्स ट्रैक करें

// Forward Iterable events to Brevo
await tajo.connectors.handleEvent('iterable', {
  type: 'custom_event',
  payload: {
    email: '[email protected]',
    eventName: 'subscription_upgraded',
    dataFields: {
      previousPlan: 'starter',
      newPlan: 'pro',
      mrr: 99.00
    }
  }
});

Webhook हैंडलर

// Handle Iterable system webhooks
app.post('/webhooks/iterable', async (req, res) => {
  const event = req.body;

  await tajo.connectors.handleWebhook('iterable', {
    type: event.eventName,
    payload: event
  });

  res.status(200).send('OK');
});

दर सीमाएं

Iterable आपके प्लान के आधार पर दर सीमाएं लागू करता है:

विशिष्ट एंडपॉइंट सीमाएं:

समस्या निवारण

सामान्य समस्याएं

डीबग मोड

connectors:
  iterable:
    debug: true
    log_level: verbose
    log_api_calls: true

कनेक्शन परीक्षण करें

tajo connectors test iterable
# ✓ API connection successful
# ✓ User data accessible
# ✓ Campaign list readable
# ✓ Event tracking operational
# ✓ List management available

सर्वोत्तम प्रथाएं

1. bulk एंडपॉइंट्स का उपयोग करें - बड़े डेटा वॉल्यूम के लिए हमेशा bulkUpdate और trackBulk को प्राथमिकता दें
2. ईमेल द्वारा डिडुप्लीकेट करें - Iterable और Brevo में सुसंगत पहचानकर्ता के रूप में ईमेल का उपयोग करें
3. incrementally सिंक करें - ऐतिहासिक डेटा को पुन: प्रोसेस करने से बचने के लिए date ranges का उपयोग करें
4. चैनल वरीयताओं को मैप करें - अनुपालन बनाए रखने के लिए opt-in/opt-out स्थिति सिंक करें
5. export jobs की निगरानी करें - बड़े exports में समय लग सकता है; status polling सेट करें
6. non-production project के साथ टेस्ट करें - प्रोडक्शन डेटा सिंक करने से पहले मैपिंग्स को मान्य करें

सुरक्षा

• API Key प्रमाणीकरण - granular अनुमतियों के साथ Server-side keys
• HTTPS Only - सभी API संचार TLS 1.2+ के माध्यम से एन्क्रिप्टेड
• Key रोटेशन - rotation के दौरान कई active API keys का समर्थन
• एन्क्रिप्टेड स्टोरेज - Tajo में रेस्ट पर API क्रेडेंशियल्स एन्क्रिप्टेड
• JWT Webhooks - सत्यापन के लिए JWT के साथ हस्ताक्षरित webhook payloads

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

• Braze Connector
• Customer.io Connector
• Customer Sync Skill
• Brevo Contacts API