Iterable کنیکٹر

متحدہ گاہک engagement، کراس چینل مہم تعاون، اور مارکیٹنگ ٹولز پر یکجا اینالیٹکس کے لیے اپنے Iterable growth مارکیٹنگ پلیٹ فارم کو Brevo سے منسلک کریں۔

جائزہ

خصوصیات

• صارف پروفائل سنک - Brevo رابطوں کے ساتھ دو طرفہ صارف ڈیٹا سنکرونائزیشن
• مہم اینالیٹکس - متحدہ رپورٹنگ کے لیے مہم send، open، اور click میٹرکس سنک کریں
• تجربہ ڈیٹا - A/B test نتائج اور جیتنے والے variants ٹریک کریں
• Catalog سنک - پلیٹ فارمز پر پروڈکٹ اور مواد catalogs کو ہم آہنگ کریں
• ورک فلو ایونٹس - ورک فلو ٹرگر اور تکمیل ایونٹس کو 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 dashboard میں لاگ ان کریں
2. Integrations > API Keys پر جائیں
3. New API Key پر کلک کریں
4. اسے “Tajo Integration” کا نام دیں
5. Server-side key قسم منتخب کریں
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. بلک اینڈ پوائنٹس استعمال کریں - بڑے ڈیٹا حجم کے لیے ہمیشہ bulkUpdate اور trackBulk کو ترجیح دیں
2. ای میل کے ذریعے ڈی ڈپلیکیٹ کریں - Iterable اور Brevo میں مستقل شناخت کنندہ کے طور پر ای میل استعمال کریں
3. Incrementally سنک کریں - تاریخی ڈیٹا کو دوبارہ پروسیس کرنے سے بچنے کے لیے تاریخ کی حدیں استعمال کریں
4. چینل ترجیحات میپ کریں - کمپلائنس برقرار رکھنے کے لیے opt-in/opt-out اسٹیٹس سنک کریں
5. Export jobs کی نگرانی کریں - بڑے exports وقت لے سکتے ہیں؛ status polling سیٹ اپ کریں
6. غیر پروڈکشن project کے ساتھ ٹیسٹ کریں - پروڈکشن ڈیٹا سنک کرنے سے پہلے میپنگز کی توثیق کریں

سیکیورٹی

• API Key تصدیق - گرانولر اجازتوں کے ساتھ Server-side keys
• HTTPS صرف - تمام API مواصلات TLS 1.2+ کے ذریعے انکرپٹڈ
• Key روٹیشن - روٹیشن کے دوران متعدد فعال API keys کے لیے سپورٹ
• انکرپٹڈ اسٹوریج - API کریڈینشلز Tajo میں آرام پر انکرپٹڈ
• JWT Webhooks - تصدیق کے لیے Webhook payloads JWT کے ساتھ دستخط شدہ

متعلقہ وسائل

• Braze کنیکٹر
• Customer.io کنیکٹر
• گاہک سنک اسکل
• Brevo Contacts API