Iterable konektor

Poveži svoju Iterable growth marketing platformu sa Brevo za unifikovano angažovanje kupaca, koordinaciju kampanja na više kanala i konsolidovanu analitiku između marketing alata.

Pregled

Karakteristike

• Sinhronizacija profila korisnika - Dvosmerna sinhronizacija podataka korisnika sa Brevo kontaktima
• Analitika kampanja - Sinhronizacija metrika slanja, otvaranja i klikova kampanje za unifikovano izveštavanje
• Podaci eksperimenata - Praćenje rezultata A/B testova i pobedničkih varijanti
• Sinhronizacija kataloga - Sinhronizacija kataloga proizvoda i sadržaja između platforma
• Događaji tokova rada - Prosleđivanje okidača toka rada i događaja završetka u Brevo
• Sinhronizacija preferencija kanala - Replikacija korisničkih preferencija komunikacije u Brevo

Preduslovi

Pre nego što započneš, proveri da imaš:

1. Iterable nalog sa API pristupom
2. Iterable API ključ sa odgovarajućim dozvolama
3. ID Iterable projekta
4. Brevo nalog sa API pristupom
5. Tajo nalog sa aktivnom pretplatom

Autentifikacija

Iterable koristi autentifikaciju API ključem prosleđenu u headeru zahteva.

Kreiranje API ključa

1. Prijavi se na Iterable dashboard
2. Idi na Integrations > API Keys
3. Klikni New API Key
4. Nazovi ga “Tajo Integration”
5. Izaberi tip ključa Server-side
6. Dodeli sledeć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 sa Tajo

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

Konfiguracija

Osnovno podešavanje

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

Mapiranje Iterable polja korisnika na Brevo atribute kontakta:

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

Konfiguracija događaja

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

API endpointi

Tajo se integriše sa sledećim Iterable API endpointima:

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

Sinhronizacija korisnika

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

Praćenje događaja

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

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

Ograničenja brzine

Iterable primenjuje ograničenja brzine u zavisnosti od tvog plana:

Specifična ograničenja endpointa:

Rešavanje problema

Česti problemi

Debug režim

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

Testiraj vezu

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

Najbolje prakse

1. Koristi bulk endpointe - Uvek preferiraj bulkUpdate i trackBulk za velike obime podataka
2. Dedupliciraj po emailu - Koristi email kao konzistentni identifikator između Iterable i Brevo
3. Sinhronizuj inkrementalno - Koristi opsege datuma da izbjegneš ponovnu obradu istorijskih podataka
4. Mapiraj preferencije kanala - Sinhronizuj status opt-in/opt-out da održiš usklađenost
5. Prati poslove izvoza - Veliki izvozi mogu potrajati; postavi ispitivanje statusa
6. Testiraj sa neprodukcijskim projektom - Validiraj mapiranja pre sinhronizacije produkcijskih podataka

Bezbednost

• Autentifikacija API ključem - Server-side ključevi sa granularnim dozvolama
• Samo HTTPS - Sva API komunikacija enkriptovana putem TLS 1.2+
• Rotacija ključeva - Podrška za više aktivnih API ključeva tokom rotacije
• Enkriptovana pohrana - API akreditivi enkriptovani u mirovanju u Tajo
• JWT webhook-ovi - Webhook payloadi potpisani sa JWT za verifikaciju

Povezani resursi

• Braze konektor
• Customer.io konektor
• Customer Sync veština
• Brevo Contacts API