Iterable Bağlayıcısı

Birleşik müşteri etkileşimi, çok kanallı kampanya koordinasyonu ve pazarlama araçları arasında birleştirilmiş analitik için Iterable büyüme pazarlama platformunuzu Brevo’ya bağlayın.

Genel Bakış

Özellikler

• Kullanıcı profili senkronizasyonu - Brevo kişileriyle çift yönlü kullanıcı verisi senkronizasyonu
• Kampanya analitiği - Birleşik raporlama için kampanya gönderim, açılma ve tıklama metriklerini senkronize edin
• Deney verileri - A/B testi sonuçlarını ve kazanan varyantları takip edin
• Katalog senkronizasyonu - Platformlar arasında ürün ve içerik kataloglarını senkronize edin
• İş akışı olayları - İş akışı tetikleyici ve tamamlama olaylarını Brevo’ya iletin
• Kanal tercihi senkronizasyonu - Kullanıcı iletişim tercihlerini Brevo’da kopyalayın

Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. API erişimi olan bir Iterable hesabı
2. Uygun izinlere sahip bir Iterable API anahtarı
3. Iterable proje kimliğiniz
4. API erişimi olan bir Brevo hesabı
5. Aktif aboneliği olan bir Tajo hesabı

Kimlik Doğrulama

Iterable, istek başlığında iletilen API anahtar kimlik doğrulamasını kullanır.

API Anahtarı Oluşturma

1. Iterable panonuza giriş yapın
2. Integrations > API Keys bölümüne gidin
3. New API Key tıklayın
4. Adını “Tajo Integration” koyun
5. Server-side anahtar türünü seçin
6. Şu izinleri verin:

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’ya Bağlanma

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

Yapılandırma

Temel Kurulum

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

Alan Eşleme

Iterable kullanıcı alanlarını Brevo kişi özniteliklerine eşleyin:

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

Olay Yapılandırması

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

API Uç Noktaları

Tajo aşağıdaki Iterable API uç noktalarıyla entegre olur:

Kod Örnekleri

Bağlayıcıyı Başlat

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

Kullanıcıları Senkronize Et

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

Olayları Takip Et

// 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 İşleyici

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

Hız Limitleri

Iterable, planınıza göre hız limitleri uygular:

Belirli uç nokta limitleri:

Sorun Giderme

Sık Karşılaşılan Sorunlar

Hata Ayıklama Modu

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

Bağlantıyı Test Et

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

En İyi Uygulamalar

1. Toplu uç noktaları kullanın - Büyük veri hacimleri için her zaman bulkUpdate ve trackBulk tercih edin
2. E-postaya göre tekilleştirin - Iterable ve Brevo arasında e-postayı tutarlı tanımlayıcı olarak kullanın
3. Artımlı senkronize edin - Geçmiş verileri yeniden işlemekten kaçınmak için tarih aralıkları kullanın
4. Kanal tercihlerini eşleyin - Uyumluluğu korumak için onay/red durumunu senkronize edin
5. Dışa aktarma işlerini izleyin - Büyük dışa aktarmalar zaman alabilir; durum sorgulaması kurun
6. Üretim dışı projeyle test edin - Üretim verilerini senkronize etmeden önce eşlemeleri doğrulayın

Güvenlik

• API Anahtar Kimlik Doğrulaması - Ayrıntılı izinlerle Server-side anahtarlar
• Yalnızca HTTPS - Tüm API iletişimi TLS 1.2+ aracılığıyla şifrelenir
• Anahtar Rotasyonu - Rotasyon sırasında birden fazla aktif API anahtarı desteği
• Şifreli Depolama - Tajo’da API kimlik bilgileri durağan halde şifrelenir
• JWT Webhook’ları - Webhook yükleri doğrulama için JWT ile imzalanır

İlgili Kaynaklar

• Braze Bağlayıcısı
• Customer.io Bağlayıcısı
• Müşteri Senkronizasyon Yeteneği
• Brevo Kişiler API’si