Conector Iterable

Conectați platforma de marketing pentru creștere Iterable la Brevo pentru implicare unificată a clienților, coordonarea campaniilor cross-canal și analize consolidate pe instrumentele de marketing.

Prezentare generală

Funcționalități

• Sincronizare profil utilizator - Sincronizare bidirecțională a datelor utilizatorilor cu contactele Brevo
• Analize campanii - Sincronizați metricile de trimitere, deschidere și clic ale campaniilor pentru raportare unificată
• Date experimente - Urmăriți rezultatele testelor A/B și variantele câștigătoare
• Sincronizare catalog - Sincronizați cataloagele de produse și conținut între platforme
• Evenimente flux de lucru - Redirecționați evenimentele de declanșare și finalizare a fluxurilor de lucru la Brevo
• Sincronizare preferințe canal - Replicați preferințele de comunicare ale utilizatorilor în Brevo

Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

1. Un cont Iterable cu acces API
2. O cheie API Iterable cu permisiunile corespunzătoare
3. ID-ul proiectului Iterable
4. Un cont Brevo cu acces API
5. Un cont Tajo cu abonament activ

Autentificare

Iterable utilizează autentificarea cu cheie API transmisă în antetul cererii.

Creare cheie API

1. Autentificați-vă în tabloul de bord Iterable
2. Navigați la Integrations > API Keys
3. Faceți clic pe New API Key
4. Numiți-o “Tajo Integration”
5. Selectați tipul de cheie Server-side
6. Acordați următoarele permisiuni:

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

Conectare la Tajo

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

Configurare

Configurare de bază

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

Mapare câmpuri

Mapați câmpurile utilizatorilor Iterable la atributele de contact 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

Configurare evenimente

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

Puncte finale API

Tajo se integrează cu următoarele puncte finale API Iterable:

Exemple de cod

Inițializare conector

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

Sincronizare utilizatori

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

Urmărire evenimente

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

Gestionare webhook

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

Limite de rată

Iterable aplică limite de rată în funcție de planul dvs.:

Limite specifice per punct final:

Depanare

Probleme frecvente

Modul de depanare

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

Testare conexiune

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

Bune practici

1. Utilizați punctele finale bulk - Preferați întotdeauna bulkUpdate și trackBulk pentru volume mari de date
2. Deduplicați după e-mail - Utilizați e-mailul ca identificator consistent în Iterable și Brevo
3. Sincronizați incremental - Utilizați intervale de date pentru a evita re-procesarea datelor istorice
4. Mapați preferințele de canal - Sincronizați statusul opt-in/opt-out pentru menținerea conformității
5. Monitorizați joburile de export - Exporturile mari pot dura; configurați interogarea statusului
6. Testați cu proiect non-producție - Validați mapările înainte de sincronizarea datelor de producție

Securitate

• Autentificare cu cheie API - Chei server-side cu permisiuni granulare
• Numai HTTPS - Toate comunicațiile API criptate prin TLS 1.2+
• Rotație chei - Suport pentru mai multe chei API active în timpul rotației
• Stocare criptată - Credențiale API criptate în repaus în Tajo
• Webhook-uri JWT - Payload-urile webhook semnate cu JWT pentru verificare

Resurse conexe

• Conector Braze
• Conector Customer.io
• Skill Sincronizare clienți
• API Contacte Brevo