Konektor Iterable

Propojte svou growth marketingovou platformu Iterable s Brevo pro sjednocené zákaznické zapojení, koordinaci kampaní napříč kanály a konsolidovanou analytiku napříč marketingovými nástroji.

Přehled

Funkce

• Synchronizace uživatelských profilů – Obousměrná synchronizace uživatelských dat s kontakty Brevo
• Analytika kampaní – Synchronizujte metriky odesílání, otevření a kliknutí kampaní pro sjednocené reportování
• Data experimentů – Sledujte výsledky A/B testů a vítězné varianty
• Synchronizace katalogu – Synchronizujte produktové a obsahové katalogy napříč platformami
• Události pracovních toků – Přeposílejte události spouštění a dokončení pracovních toků do Brevo
• Synchronizace preferencí kanálu – Replikujte komunikační preference uživatelů v Brevo

Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Iterable s přístupem k API
2. API klíč Iterable s příslušnými oprávněními
3. ID vašeho projektu Iterable
4. Účet Brevo s přístupem k API
5. Účet Tajo s aktivním předplatným

Ověření

Iterable používá ověřování API klíčem předávaným v hlavičce požadavku.

Vytvoření API klíče

1. Přihlaste se do svého řídicího panelu Iterable
2. Přejděte do Integrations > API Keys
3. Klikněte na New API Key
4. Pojmenujte ho “Tajo Integration”
5. Vyberte typ klíče Server-side
6. Udělte následující oprávnění:

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

Připojení k Tajo

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

Konfigurace

Základní nastavení

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

Mapování polí

Mapujte pole uživatelů Iterable na atributy kontaktů Brevo:

field_mapping:
  # Standardní pole
  userId: ITERABLE_ID
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phoneNumber: SMS

  # Data zapojení
  signupDate: SIGNUP_DATE
  totalPurchases: TOTAL_PURCHASES
  lastPurchaseDate: LAST_PURCHASE

  # Vlastní pole
  plan_name: PLAN_NAME
  company_size: COMPANY_SIZE
  preferred_channel: PREFERRED_CHANNEL
  lifecycle_stage: LIFECYCLE_STAGE

Konfigurace událostí

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

Koncové body API

Tajo se integruje s následujícími koncovými body Iterable API:

Příklady kódu

Inicializace konektoru

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

Synchronizace uživatelů

// Přírůstková synchronizace uživatelů z Iterable do 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
// }

Sledování událostí

// Přeposílání událostí Iterable do Brevo
await tajo.connectors.handleEvent('iterable', {
  type: 'custom_event',
  payload: {
    email: '[email protected]',
    eventName: 'subscription_upgraded',
    dataFields: {
      previousPlan: 'starter',
      newPlan: 'pro',
      mrr: 99.00
    }
  }
});

Obsluha webhooků

// Zpracování systémových webhooků Iterable
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');
});

Omezení rychlosti

Iterable vynucuje limity rychlosti na základě vašeho plánu:

Limity konkrétních koncových bodů:

Řešení problémů

Časté problémy

Režim ladění

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

Test připojení

tajo connectors test iterable
# ✓ Připojení API úspěšné
# ✓ Uživatelská data přístupná
# ✓ Seznam kampaní čitelný
# ✓ Sledování událostí funkční
# ✓ Správa seznamů dostupná

Osvědčené postupy

1. Používejte dávkové koncové body – Vždy upřednostňujte bulkUpdate a trackBulk pro velké objemy dat
2. Deduplikujte podle e-mailu – Používejte e-mail jako konzistentní identifikátor napříč Iterable a Brevo
3. Synchronizujte přírůstkově – Používejte časové rozsahy pro zamezení opětovného zpracování historických dat
4. Mapujte preference kanálu – Synchronizujte stav opt-in/opt-out pro zachování souladu
5. Monitorujte exportní úlohy – Velké exporty mohou trvat; nastavte pollování stavu
6. Testujte s ne-produkčním projektem – Ověřte mapování před synchronizací produkčních dat

Zabezpečení

• Ověřování API klíčem – Server-side klíče s granulárními oprávněními
• Pouze HTTPS – Veškerá API komunikace šifrovaná přes TLS 1.2+
• Rotace klíčů – Podpora pro více aktivních API klíčů během rotace
• Šifrované úložiště – API přihlašovací údaje šifrované v klidu v Tajo
• JWT webhooky – Payloady webhooků podepsány pomocí JWT pro ověření

Související zdroje

• Konektor Braze
• Konektor Customer.io
• Dovednost synchronizace zákazníků
• Brevo Contacts API