Iterable konektor

Prepoj svoju rastovú marketingovú platformu Iterable s Brevo pre zjednotené zákaznícke zapojenie, koordináciu kampaní naprieč kanálmi a konsolidovanú analytiku naprieč marketingovými nástrojmi.

Prehľad

Funkcie

• Synchronizácia profilov používateľov - Obojsmerná synchronizácia dát používateľov s kontaktmi Brevo
• Analytika kampaní - Synchronizuj metriky odosielania, otvárania a klikania kampaní pre jednotné reportovanie
• Dáta experimentov - Sleduj výsledky A/B testov a víťazné varianty
• Synchronizácia katalógu - Synchronizuj katalógy produktov a obsahu naprieč platformami
• Udalosti workflowov - Preposielaj udalosti triggeru a dokončenia workflowov do Brevo
• Synchronizácia preferencií kanálov - Replikuj preferencie komunikácie používateľov v Brevo

Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Iterable účet s API prístupom
2. Iterable API kľúč s príslušnými oprávneniami
3. ID tvojho Iterable projektu
4. Brevo účet s API prístupom
5. Tajo účet s aktívnym predplatným

Autentifikácia

Iterable používa autentifikáciu API kľúčmi prenášanými v hlavičke požiadavky.

Vytvorenie API kľúča

1. Prihlás sa do svojho Iterable dashboardu
2. Prejdi do Integrations > API Keys
3. Klikni na New API Key
4. Pomenuj ho “Tajo Integration”
5. Vyber typ kľúča Server-side
6. Udeľ nasledujúce oprávnenia:

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

Pripojenie k Tajo

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

Konfigurácia

Základné nastavenie

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

Mapovanie polí

Namapuj polia používateľov Iterable na atribúty kontaktov Brevo:

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

Konfigurácia udalostí

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

API endpointy

Tajo sa integruje s nasledujúcimi API endpointmi Iterable:

Ukážky kódu

Inicializácia 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
});

Synchronizácia používateľov

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

Sledovanie udalostí

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

Spracovanie webhookov

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

Obmedzenia rýchlosti

Iterable presadzuje limity rýchlosti na základe tvojho plánu:

Limity konkrétnych endpointov:

Riešenie problémov

Bežné problémy

Debug režim

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

Test pripojenia

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

Odporúčané postupy

1. Použi dávkové endpointy - Vždy uprednostňuj bulkUpdate a trackBulk pre veľké objemy dát
2. Deduplikuj podľa e-mailu - Použi e-mail ako konzistentný identifikátor naprieč Iterable a Brevo
3. Synchronizuj inkrementálne - Použi rozsahy dátumov na vyhnutie sa opätovnému spracovaniu historických dát
4. Mapuj preferencie kanálov - Synchronizuj stav opt-in/opt-out na zachovanie súladu
5. Monitoruj exportové úlohy - Veľké exporty môžu trvať dlho; nastav polling stavu
6. Testuj s neprodukčným projektom - Validuj mapovania pred synchronizáciou produkčných dát

Bezpečnosť

• Autentifikácia API kľúčom - Server-side kľúče s granulárnnymi oprávneniami
• Iba HTTPS - Všetka API komunikácia šifrovaná cez TLS 1.2+
• Rotácia kľúčov - Podpora viacerých aktívnych API kľúčov počas rotácie
• Šifrované úložisko - API prihlasovací údaje šifrované v pokoji v Tajo
• JWT webhooky - Payloady webhookov podpísané JWT pre overenie

Súvisiace zdroje

• Braze konektor
• Customer.io konektor
• Customer Sync skill
• Brevo Contacts API