Konektor Iterable

Hubungkan platform growth marketing Iterable Anda ke Brevo untuk keterlibatan pelanggan yang terpadu, koordinasi kampanye lintas kanal, dan analitik yang terkonsolidasi di seluruh perangkat marketing.

Ikhtisar

Fitur

• Sinkronisasi profil pengguna - Sinkronisasi data pengguna dua arah dengan kontak Brevo
• Analitik kampanye - Sinkronkan metrik pengiriman, open, dan klik kampanye untuk pelaporan terpadu
• Data eksperimen - Lacak hasil A/B test dan varian pemenang
• Sinkronisasi katalog - Selaraskan katalog produk dan konten antarplatform
• Event workflow - Teruskan event pemicu dan penyelesaian workflow ke Brevo
• Sinkronisasi preferensi kanal - Replikasi preferensi komunikasi pengguna di Brevo

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Akun Iterable dengan akses API
2. API key Iterable dengan izin yang sesuai
3. Project ID Iterable Anda
4. Akun Brevo dengan akses API
5. Akun Tajo dengan langganan aktif

Autentikasi

Iterable menggunakan autentikasi API key yang dikirim pada header permintaan.

Membuat API key

1. Masuk ke dashboard Iterable Anda
2. Buka Integrations > API Keys
3. Klik New API Key
4. Beri nama “Tajo Integration”
5. Pilih tipe key Server-side
6. Berikan izin berikut:

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

Menghubungkan ke Tajo

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

Konfigurasi

Setup dasar

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

Pemetaan field

Petakan field pengguna Iterable ke atribut kontak 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

Konfigurasi event

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

Endpoint API

Tajo terintegrasi dengan endpoint API Iterable berikut:

Contoh kode

Inisialisasi konektor

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
});

Sinkronisasi pengguna

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

Melacak event

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

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

Batas rate

Iterable menerapkan batas rate berdasarkan paket Anda:

Batas untuk endpoint tertentu:

Pemecahan masalah

Masalah umum

Mode debug

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

Menguji koneksi

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

Praktik terbaik

1. Gunakan endpoint bulk - Selalu utamakan bulkUpdate dan trackBulk untuk volume data besar
2. Deduplikasi berdasarkan email - Gunakan email sebagai identifier yang konsisten di Iterable dan Brevo
3. Sinkronkan secara inkremental - Gunakan rentang tanggal agar data historis tidak diproses ulang
4. Petakan preferensi kanal - Sinkronkan status opt-in/opt-out untuk menjaga kepatuhan
5. Pantau job ekspor - Ekspor besar bisa memakan waktu, siapkan polling status
6. Uji dengan project non-produksi - Validasi pemetaan sebelum menyinkronkan data produksi

Keamanan

• Autentikasi API key - Key server-side dengan izin granular
• Hanya HTTPS - Seluruh komunikasi API dienkripsi melalui TLS 1.2+
• Rotasi key - Mendukung beberapa API key aktif selama rotasi
• Penyimpanan terenkripsi - Kredensial API dienkripsi saat disimpan di Tajo
• Webhook JWT - Payload webhook ditandatangani dengan JWT untuk verifikasi

Sumber daya terkait

• Konektor Braze
• Konektor Customer.io
• Skill Sinkronisasi Pelanggan
• API Kontak Brevo