Iterable Konektor

Povežite svoju Iterable platformu za rast marketinga s Brevom za ujedinjeni angažman korisnika, koordinaciju kampanja na više kanala i konsolidiranu analitiku između marketinških alata.

Pregled

Značajke

• Sinkronizacija korisničkih profila - Dvosmjerna sinkronizacija korisničkih podataka s Brevo kontaktima
• Analitika kampanja - Sinkronizacija metrika slanja, otvaranja i klikova kampanje za ujedinjeno izvješćivanje
• Podaci eksperimenata - Praćenje rezultata A/B testova i pobjedničkih varijanti
• Sinkronizacija kataloga - Sinkronizacija kataloga proizvoda i sadržaja između platformi
• Događaji tijeka rada - Prosljeđivanje ereignaja okidača i dovršetka tijeka rada u Brevo
• Sinkronizacija preferencija kanala - Replikacija korisničkih komunikacijskih preferencija u Brevo

Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Iterable račun s API pristupom
2. Iterable API ključ s odgovarajućim dozvolama
3. Vaš Iterable ID projekta
4. Brevo račun s API pristupom
5. Tajo račun s aktivnom pretplatom

Autentifikacija

Iterable koristi autentifikaciju API ključem proslijeđenim u zaglavlju zahtjeva.

Kreiranje API ključa

1. Prijavite se na vaš Iterable dashboard
2. Navigirajte do Integracije > API ključevi
3. Kliknite Novi API ključ
4. Nazovite ga “Tajo integracija”
5. Odaberite vrstu ključa Server-side
6. Dodijelite sljedeće dozvole:

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

Povezivanje s Tajom

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

Konfiguracija

Osnovna konfiguracija

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

Mapiranje polja

Mapirajte Iterable korisničke atribute na Brevo atribute kontakata:

field_mapping:
  # Standardna polja
  userId: ITERABLE_ID
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phoneNumber: SMS

  # Podaci o angažmanu
  signupDate: SIGNUP_DATE
  totalPurchases: TOTAL_PURCHASES
  lastPurchaseDate: LAST_PURCHASE

  # Prilagođena polja
  plan_name: PLAN_NAME
  company_size: COMPANY_SIZE
  preferred_channel: PREFERRED_CHANNEL
  lifecycle_stage: LIFECYCLE_STAGE

Konfiguracija događaja

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

API krajnje točke

Tajo se integrira s sljedećim Iterable API krajnjim točkama:

Primjeri koda

Inicijalizacija konektora

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

Sinkronizacija korisnika

// Inkrementalna sinkronizacija korisnika iz Iterablea u 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
// }

Praćenje događaja

// Prosljeđivanje Iterable događaja u 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 za webhookove

// Rukovanje Iterable sistemskim webhookovima
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');
});

Ograničenja brzine

Iterable primjenjuje ograničenja brzine na temelju vašeg plana:

Ograničenja specifičnih krajnjih točaka:

Rješavanje problema

Uobičajeni problemi

Način otklanjanja grešaka

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

Testiranje veze

tajo connectors test iterable
# ✓ API veza uspješna
# ✓ Korisnički podaci dostupni
# ✓ Popis kampanja čitljiv
# ✓ Praćenje događaja operativno
# ✓ Upravljanje popisima dostupno

Preporučene prakse

1. Koristite skupne krajnje točke - Uvijek preferirajte bulkUpdate i trackBulk za velike volumene podataka
2. Deduplicirajte po e-mailu - Koristite e-mail kao dosljedni identifikator u Iterableu i Brevo
3. Sinkronizirajte inkrementalno - Koristite raspone datuma kako biste izbjegli ponovnu obradu historijskih podataka
4. Mapirajte preferencije kanala - Sinkronizacija statusa prijave/odjave za održavanje usklađenosti
5. Pratite zadatke izvoza - Veliki izvozi mogu potrajati; postavite anketiranje statusa
6. Testirajte s neprodukcijskim projektom - Validir mapiranja prije sinkronizacije produkcijskih podataka

Sigurnost

• Autentifikacija API ključem - Server-side ključevi s granularnim dozvolama
• Samo HTTPS - Sva API komunikacija šifrirana putem TLS 1.2+
• Rotacija ključeva - Podrška za više aktivnih API ključeva tokom rotacije
• Šifrirano pohranjivanje - API vjerodajnice šifrirane u mirovanju u Taju
• JWT webhookovi - Webhook opterećenja potpisana JWT-om za verifikaciju

Povezani resursi

• Braze Konektor
• Customer.io Konektor
• Vještina sinkronizacije korisnika
• Brevo API kontakata