Iterable-kobling

Koble Iterable-vekstmarkedsføringsplattformen din til Brevo for enhetlig kundeengasjement, tverrkanalskampanjekoordinering og konsolidert analyse på tvers av markedsføringsverktøy.

Oversikt

Funksjoner

• Synkronisering av brukerprofiler - Toveis brukerdatasynkronisering med Brevo-kontakter
• Kampanjeanalyse - Synkroniser kampanjemetrikker for sending, åpning og klikk for enhetlig rapportering
• Eksperimentdata - Spor A/B-testresultater og vinnende varianter
• Katalogsynkronisering - Synkroniser produkt- og innholdskataloger på tvers av plattformer
• Arbeidsflythendelser - Videresend arbeidsflytutløser- og fullføringshendelser til Brevo
• Synkronisering av kanalpreferanser - Replikér brukerens kommunikasjonspreferanser i Brevo

Forutsetninger

Før du begynner, sørg for at du har:

1. En Iterable-konto med API-tilgang
2. En Iterable API-nøkkel med passende rettigheter
3. Din Iterable-prosjekt-ID
4. En Brevo-konto med API-tilgang
5. En Tajo-konto med aktivt abonnement

Autentisering

Iterable bruker API-nøkkelautentisering som sendes i forespørselsheaderen.

Opprette en API-nøkkel

1. Logg inn på Iterable-dashbordet ditt
2. Gå til Integrations > API Keys
3. Klikk New API Key
4. Gi den navnet “Tajo Integration”
5. Velg nøkkeltypen Server-side
6. Gi følgende rettigheter:

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

Koble til Tajo

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

Konfigurasjon

Grunnleggende oppsett

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

Mapp Iterable-brukerfelt til Brevo-kontaktattributter:

field_mapping:
  # Standardfelt
  userId: ITERABLE_ID
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phoneNumber: SMS

  # Engasjementsdata
  signupDate: SIGNUP_DATE
  totalPurchases: TOTAL_PURCHASES
  lastPurchaseDate: LAST_PURCHASE

  # Egendefinerte felt
  plan_name: PLAN_NAME
  company_size: COMPANY_SIZE
  preferred_channel: PREFERRED_CHANNEL
  lifecycle_stage: LIFECYCLE_STAGE

Hendelseskonfigurasjon

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

API-endepunkter

Tajo integrerer med følgende Iterable API-endepunkter:

Kodeeksempler

Initialiser kobling

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

Synkroniser brukere

// Inkrementell brukersynkronisering fra Iterable til 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 hendelser

// Videresend Iterable-hendelser til 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-håndterer

// Håndter Iterable-systemwebhooks
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');
});

Ratebegrensninger

Iterable håndhever ratebegrensninger basert på planen din:

Spesifikke endepunktgrenser:

Feilsøking

Vanlige problemer

Feilsøkingsmodus

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

Test tilkobling

tajo connectors test iterable
# ✓ API-tilkobling vellykket
# ✓ Brukerdata tilgjengelige
# ✓ Kampanjeliste lesbar
# ✓ Hendelsessporing operativ
# ✓ Listeadministrasjon tilgjengelig

Beste praksis

1. Bruk bulkendepunkter - Foretrekk alltid bulkUpdate og trackBulk for store datavolumer
2. Dedupliser etter e-post - Bruk e-post som konsistent identifikator på tvers av Iterable og Brevo
3. Synkroniser inkrementelt - Bruk datointervaller for å unngå reprosessering av historiske data
4. Mapp kanalpreferanser - Synkroniser opt-in/opt-out-status for å opprettholde etterlevelse
5. Overvåk eksportjobber - Store eksporter kan ta tid; sett opp statuspolling
6. Test med ikke-produksjonsprosjekt - Valider mappinger før synkronisering av produksjonsdata

Sikkerhet

• API-nøkkelautentisering - Server-side-nøkler med granulære rettigheter
• Kun HTTPS - All API-kommunikasjon kryptert via TLS 1.2+
• Nøkkelrotasjon - Støtte for flere aktive API-nøkler under rotasjon
• Kryptert lagring - API-påloggingsdetaljer kryptert i hvilemodus i Tajo
• JWT-webhooks - Webhook-payloads signert med JWT for verifisering

Relaterte ressurser

• Braze-kobling
• Customer.io-kobling
• Customer Sync-ferdighet
• Brevo Contacts API