Iterable Connector

Poveži Iterable z Brevo prek Tajo za sinhronizacijo profilov uporabnikov, kampanjskih podatkov in vedenjskih dogodkov za celovito večkanalno marketinško avtomatizacijo.

Pregled

Funkcionalnosti

• Sinhronizacija profilov – sinhroniziraj profile uporabnikov z atributi med Iterable in Brevo
• Posredovanje dogodkov – posreduj vedenjske dogodke iz Iterable v avtomatizacije Brevo
• Sinhronizacija seznamov – preslikaj liste naročnikov Iterable v sezname stikov Brevo
• Migracija kampanj – prenos uspešnosti kampanj in angažirnih podatkov
• Sledenje konverzijam – sinhroniziraj konverzijske dogodke za enotno poročanje
• Podpora za webhooks – obravnavaj kampanjske in sporočilne dogodke v realnem času

Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun Iterable z dostopom do API
2. API ključ iz nastavitev projekta Iterable
3. Brevo račun z dostopom do API
4. Tajo račun z dovoljenji za konektorje

Avtentikacija

Avtentikacija z API ključem

# Set your API keys
export ITERABLE_API_KEY=your_iterable_api_key
export TAJO_API_KEY=your_tajo_api_key
export BREVO_API_KEY=your_brevo_api_key

// All requests require the Api-Key header
const headers = {
  'Api-Key': process.env.ITERABLE_API_KEY,
  'Content-Type': 'application/json'
};

Konfiguracija

Osnovna nastavitev

connectors:
  iterable:
    enabled: true
    api_key: "${ITERABLE_API_KEY}"

    sync:
      users: true
      events: true
      lists: true
      campaigns: true

    lists:
      all_users: 15
      active_users: 16
      churned: 17

Preslikava polj

field_mapping:
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phoneNumber: SMS
  signupDate: SIGNUP_DATE
  totalRevenue: TOTAL_REVENUE
  lastPurchaseDate: LAST_ORDER_DATE
  preferredChannel: CHANNEL_PREF

Preslikava dogodkov

event_mapping:
  "purchase": "order_completed"
  "addToCart": "cart_updated"
  "emailOpen": "email_opened"
  "emailClick": "email_clicked"
  "unsubscribe": "customer_unsubscribed"
  "webPush": "push_received"

Končne točke API

Primeri kode

Inicializacija konektorja

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

Sinhronizacija profilov uporabnikov

// Update user profile in Iterable and sync to Brevo
const response = await fetch('https://api.iterable.com/api/users/update', {
  method: 'POST',
  headers: {
    'Api-Key': process.env.ITERABLE_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: '[email protected]',
    dataFields: {
      firstName: 'Jane',
      lastName: 'Kim',
      totalRevenue: 450.00,
      plan: 'premium'
    }
  })
});

// Sync the user to Brevo via Tajo
await tajo.contacts.sync({
  email: '[email protected]',
  attributes: {
    FIRSTNAME: 'Jane',
    LASTNAME: 'Kim',
    TOTAL_REVENUE: 450.00,
    SUBSCRIPTION_PLAN: 'premium'
  }
});

Sledenje in posredovanje dogodkov

// Track an event in Iterable
await fetch('https://api.iterable.com/api/events/track', {
  method: 'POST',
  headers: {
    'Api-Key': process.env.ITERABLE_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: '[email protected]',
    eventName: 'purchase',
    dataFields: {
      orderId: 'ORD-123',
      revenue: 89.99,
      items: ['Widget Pro']
    }
  })
});

Omejitve hitrosti

Odpravljanje težav

Način odpravljanja napak

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

Najboljše prakse

1. Identificiraj s prijavno točko – pri registraciji vedno ustvari uporabniški profil
2. Paketni dogodki – za učinkovito sledenje visokemu obsegu uporabi Batch API
3. Sinhroniziraj demografijo – redno posodabljaj podatkovne atribute v Iterable
4. Enotna imenovanja dogodkov – vzdržuj dosledno konvencijo poimenovanja событий med platformama
5. Upravljaj odjave – sinhroniziraj odjave med Iterable in Brevo za skladnost
6. Sprljuj odzivnost kampanj – uvozi angažirne metrike kampanj v Brevo za analizo

Varnost

• Avtentikacija z API ključem – dostop prek glave Api-Key
• Varnost projektnega nivoja – API ključi obsegani na posamezne projekte
• TLS šifriranje – vsa komunikacija API šifrirana prek HTTPS
• Rotacija ključev – periodično menjaj API ključe prek nadzorne plošče Iterable

Povezani viri

• Brevo Connector
• Klaviyo Connector
• Customer Sync Skill
• Iterable API dokumentacija