Iterable Connector

Forbind din Iterable growth marketing-platform til Brevo for forenet kundeengagement, tværkanal-kampagnekoordinering og konsoliderede analyser på tværs af marketingværktøjer.

Oversigt

Funktioner

• Synkronisering af brugerprofiler - Tovejssynkronisering af brugerdata med Brevo-kontakter
• Kampagneanalyse - Synkronisér kampagneafsendelses-, åbnings- og klikmetrikker til forenet rapportering
• Eksperimentdata - Spor A/B-testresultater og vindende varianter
• Katalogsynkronisering - Synkronisér produkt- og indholdskataloger på tværs af platforme
• Workflow-hændelser - Videresend workflow-trigger- og gennemførselshændelser til Brevo
• Synkronisering af kanalpræferencer - Replicér brugernes kommunikationspræferencer i Brevo

Forudsætninger

Før du begynder, skal du sikre dig, at du har:

1. En Iterable-konto med API-adgang
2. En Iterable API-nøgle med passende rettigheder
3. Dit Iterable-projekt-id
4. En Brevo-konto med API-adgang
5. En Tajo-konto med et aktivt abonnement

Autentifikation

Iterable bruger API-nøgle-autentifikation sendt i request-headeren.

Oprettelse af en API-nøgle

1. Log ind på dit Iterable-dashboard
2. Navigér til Integrations > API Keys
3. Klik New API Key
4. Navngiv den “Tajo Integration”
5. Vælg Server-side-nøgletype
6. Giv følgende rettigheder:

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

Forbind til Tajo

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

Konfiguration

Grundlæggende opsætning

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

Feltmapping

Knyt Iterable-brugerfelter til Brevo-kontaktattributter:

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

Hændelseskonfiguration

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

API-endpoints

Tajo integrerer med følgende Iterable API-endpoints:

Kodeeksempler

Initialisér konnektor

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

Synkronisér brugere

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

Spor hændelser

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

Ratebegrænsninger

Iterable håndhæver ratebegrænsninger baseret på din plan:

Specifikke endpoint-grænser:

Fejlfinding

Almindelige problemer

Fejlfindingstilstand

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

Test forbindelse

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

Best practices

1. Brug bulk-endpoints - Foretræk altid bulkUpdate og trackBulk til store datamængder
2. Deduplicér efter e-mail - Brug e-mail som konsekvent identifikator på tværs af Iterable og Brevo
3. Synkronisér inkrementelt - Brug datointervaller for at undgå genbehandling af historiske data
4. Map kanalpræferencer - Synkronisér opt-in-/opt-out-status for at opretholde compliance
5. Overvåg eksport-jobs - Store eksporter kan tage tid; opsæt statuspolling
6. Test med et ikke-produktionsprojekt - Validér mappings før synkronisering af produktionsdata

Sikkerhed

• API-nøgle-autentifikation - Server-side-nøgler med granulære rettigheder
• Kun HTTPS - Al API-kommunikation krypteret via TLS 1.2+
• Nøglerotation - Understøttelse af flere aktive API-nøgler under rotation
• Krypteret lagring - API-legitimationsoplysninger krypteres i hvile i Tajo
• JWT-webhooks - Webhook-payloads signeres med JWT til verifikation

Relaterede ressourcer

• Braze Connector
• Customer.io Connector
• Customer Sync Skill
• Brevo Contacts API