Iterable konnektor

Csatlakoztasd az Iterable növekedési marketing platformot a Brevóhoz egységesített ügyfél-elköteleződéshez, csatornák közötti kampánykoordinációhoz és konszolidált analitikához a marketing eszközök között.

Áttekintés

Funkciók

• Felhasználói profil szinkronizáció – Kétirányú felhasználói adatszinkronizálás Brevo kapcsolatokkal
• Kampányanalitika – Kampány-küldési, megnyitási és kattintási mutatók szinkronizálása egységesített riportoláshoz
• Kísérleti adatok – A/B teszt eredmények és nyerő variánsok követése
• Katalógus-szinkronizáció – Termék- és tartalomkatalógusok szinkronizálása platformok között
• Munkafolyamat-események – Munkafolyamat-kiváltó és befejezési események továbbítása a Brevóba
• Csatorna-preferencia szinkronizáció – Felhasználói kommunikációs preferenciák replikálása a Brevóba

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Iterable fiókkal API-hozzáféréssel
2. Egy Iterable API kulccsal megfelelő jogosultságokkal
3. Az Iterable projekt azonosítóval
4. Egy Brevo fiókkal API-hozzáféréssel
5. Egy Tajo fiókkal aktív előfizetéssel

Hitelesítés

Az Iterable API kulcs hitelesítést használ, amelyet a kérés fejlécébe kell beilleszteni.

API kulcs létrehozása

1. Jelentkezz be az Iterable dashboardba
2. Menj az Integrációk > API kulcsok menübe
3. Kattints az Új API kulcs gombra
4. Nevezd el „Tajo Integration”-nek
5. Válaszd a Szerveroldali kulcstípust
6. Adj meg a következő jogosultságokat:

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

Csatlakozás a Tajóhoz

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

Konfiguráció

Alapbeállítás

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

Mezőleképezés

Képezd le az Iterable felhasználói mezőket Brevo kapcsolat-attribútumokhoz:

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

Esemény-konfiguráció

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

API végpontok

A Tajo az alábbi Iterable API végpontokkal integrálódik:

Kódpéldák

A konnektor inicializálása

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

Felhasználók szinkronizálása

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

Események követése

// 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 kezelő

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

Ráta-korlátok

Az Iterable ráta-korlátokat alkalmaz a csomag alapján:

Végpont-specifikus korlátok:

Hibaelhárítás

Gyakori problémák

Hibakeresési mód

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

Kapcsolat tesztelése

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

Legjobb gyakorlatok

1. Használj bulk végpontokat – Mindig a bulkUpdate-et és trackBulk-ot részesítsd előnyben nagy adatmennyiségnél
2. E-mail alapú deduplikálás – Használj e-mailt következetes azonosítóként az Iterable és Brevo között
3. Szinkronizálj növekményesen – Dátumtartományokat használj a korábbi adatok újrafeldolgozásának elkerüléséhez
4. Képezd le a csatorna-preferenciákat – Szinkronizálj be/ki-iratkozási státuszt a megfelelőség fenntartásához
5. Figyeld az exportálási feladatokat – A nagy exportálások időt igényelhetnek; állíts be státusz-lekérdezést
6. Tesztelj nem-éles projektben – Validáld a leképezéseket az éles adatok szinkronizálása előtt

Biztonság

• API kulcs hitelesítés – Szerveroldali kulcsok részletes jogosultságokkal
• Csak HTTPS – Minden API kommunikáció TLS 1.2+-on keresztül titkosítva
• Kulcs rotáció – Több aktív API kulcs támogatása rotáció során
• Titkosított tárolás – API hitelesítő adatok titkosítva tárolódnak a Tajóban
• JWT webhookok – A webhook terhelések JWT-vel aláírva ellenőrzéshez

Kapcsolódó források

• Braze konnektor
• Customer.io konnektor
• Ügyfél-szinkronizáció Skill
• Brevo Contacts API