موصل Iterable

اربط منصة تسويق النمو Iterable الخاصة بك مع Brevo لتفاعل موحد مع العملاء، وتنسيق حملات عبر القنوات، وتحليلات مدمجة عبر أدوات التسويق.

نظرة عامة

الميزات

• مزامنة ملفات المستخدمين - مزامنة ثنائية الاتجاه لبيانات المستخدمين مع جهات اتصال Brevo
• تحليلات الحملات - مزامنة مقاييس إرسال الحملات والفتح والنقرات للتقارير الموحدة
• بيانات التجارب - تتبع نتائج اختبار A/B والمتغيرات الفائزة
• مزامنة الكتالوج - مزامنة كتالوجات المنتجات والمحتوى عبر المنصات
• أحداث سير العمل - إعادة توجيه أحداث تشغيل وإتمام سير العمل إلى Brevo
• مزامنة تفضيلات القنوات - نسخ تفضيلات الاتصال الخاصة بالمستخدم في Brevo

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

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

1. حساب Iterable مع وصول إلى API
2. مفتاح Iterable API بصلاحيات مناسبة
3. معرّف مشروع Iterable الخاص بك
4. حساب Brevo مع وصول إلى API
5. حساب Tajo مع اشتراك نشط

المصادقة

يستخدم Iterable مصادقة مفتاح API يُمرَّر في ترويسة الطلب.

إنشاء مفتاح API

1. سجّل الدخول إلى لوحة Iterable
2. انتقل إلى Integrations > API Keys
3. انقر على New API Key
4. سمّه “Tajo Integration”
5. اختر نوع مفتاح Server-side
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

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

يتكامل 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
});

مزامنة المستخدمين

// مزامنة تزايدية للمستخدمين من Iterable إلى 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
// }

تتبع الأحداث

// إعادة توجيه أحداث Iterable إلى 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

// التعامل مع webhooks نظام Iterable
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. المزامنة التزايدية - استخدم نطاقات التواريخ لتجنب إعادة معالجة البيانات التاريخية
4. عيّن تفضيلات القنوات - زامن حالة الاشتراك/إلغاء الاشتراك للحفاظ على الامتثال
5. راقب مهام التصدير - قد تستغرق التصديرات الكبيرة وقتًا؛ إعداد استطلاع الحالة
6. اختبر مع مشروع غير إنتاجي - تحقق من التعيينات قبل مزامنة بيانات الإنتاج

الأمان

• مصادقة مفتاح API - مفاتيح Server-side بصلاحيات دقيقة
• HTTPS فقط - جميع اتصالات API مشفرة عبر TLS 1.2+
• تدوير المفاتيح - دعم مفاتيح API نشطة متعددة أثناء التدوير
• تخزين مشفر - بيانات اعتماد API مشفرة في حالة السكون في Tajo
• JWT Webhooks - حمولات webhook موقّعة بـ JWT للتحقق

موارد ذات صلة

• موصل Braze
• موصل Customer.io
• مهارة مزامنة العملاء
• واجهة جهات اتصال Brevo