Braze-kobling

Koble Braze-engasjementsplattformen din til Brevo for enhetlige kundeprofiler, tverrkanalskampanjeorkestrering og konsolidert markedsføringsanalyse.

Oversikt

Funksjoner

• Synkronisering av brukerprofiler - Toveis synkronisering av kundeattributter mellom Braze og Brevo
• Sporing av kampanjehendelser - Spor e-poståpninger, klikk, konverteringer og avmeldinger
• Canvas-flytdata - Synkroniser data fra flerstegs-kampanjereiser for enhetlig rapportering
• Segmentspeiling - Replikér Braze-segmenter som Brevo-lister for tverrplattform-målretting
• Push-varselhendelser - Videresend push-engasjementsdata til Brevo-kontakttidslinjer
• Katalogsynkronisering - Synkroniser produktkataloger for personaliserte anbefalinger

Forutsetninger

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

1. En Braze-konto med API-tilgang aktivert
2. En Braze REST API-nøkkel med passende rettigheter
3. Din Braze-instans-URL (f.eks. rest.iad-01.braze.com)
4. En Brevo-konto med API-tilgang
5. En Tajo-konto med aktivt abonnement

Autentisering

Braze bruker API-nøkkelautentisering. Hver API-nøkkel kan avgrenses til spesifikke endepunkter.

Opprette en API-nøkkel

1. Logg inn på Braze-dashbordet ditt
2. Gå til Settings > API Keys
3. Klikk Create New API Key
4. Gi den navnet “Tajo Integration”
5. Aktiver følgende rettigheter:

users.track
users.export.ids
users.export.segment
campaigns.list
campaigns.data_series
canvas.list
canvas.data_series
segments.list
segments.data_series
email.status
subscription.status.set
catalogs.list_items

Koble til Tajo

tajo connectors install braze \
  --api-key $BRAZE_API_KEY \
  --instance-url rest.iad-01.braze.com

Konfigurasjon

Grunnleggende oppsett

connectors:
  braze:
    enabled: true
    instance_url: "rest.iad-01.braze.com"
    api_version: "v1"

    sync:
      users: true
      campaigns: true
      canvases: true
      segments: true
      events: true

    lists:
      engaged_users: 10
      dormant_users: 11

Feltmapping

Mapp Braze-brukerattributter til Brevo-kontaktattributter:

field_mapping:
  # Standardfelt
  external_id: BRAZE_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Engasjementsmålinger
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Egendefinerte attributter
  loyalty_points: LOYALTY_POINTS
  last_app_version: APP_VERSION
  preferred_language: LANGUAGE

API-endepunkter

Tajo integrerer med følgende Braze REST 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('braze', {
  apiKey: process.env.BRAZE_API_KEY,
  instanceUrl: 'rest.iad-01.braze.com'
});

Synkroniser brukerprofiler

// Synkroniser Braze-brukere til Brevo-kontakter
await tajo.connectors.sync('braze', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

// Sjekk synkroniseringsstatus
const status = await tajo.connectors.status('braze');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T10:30:00Z',
//   usersCount: 45200,
//   campaignsTracked: 28,
//   eventsProcessed: 125000
// }

Spor egendefinerte hendelser

// Videresend Braze-hendelser til Brevo
await tajo.connectors.handleEvent('braze', {
  type: 'user.event',
  payload: {
    external_id: 'user_12345',
    name: 'product_viewed',
    properties: {
      product_id: 'SKU-789',
      category: 'electronics',
      price: 299.99
    }
  }
});

Eksporter segmentdata

// Eksporter et Braze-segment og opprett en Brevo-liste
const result = await tajo.connectors.exportSegment('braze', {
  segmentId: 'segment_abc123',
  targetList: 15,
  includeAttributes: ['email', 'first_name', 'last_name', 'total_revenue']
});

console.log(`Exported ${result.count} users to Brevo list 15`);

Ratebegrensninger

Braze håndhever ratebegrensninger basert på planen og instansen din:

Endepunktet /users/track har en standardgrense på 50 000 forespørsler per minutt. Tajo håndterer automatisk ratebegrensning med eksponentiell backoff.

Feilsøking

Vanlige problemer

Feilsøkingsmodus

connectors:
  braze:
    debug: true
    log_level: verbose
    log_api_calls: true

Test tilkobling

tajo connectors test braze
# ✓ API-tilkobling vellykket
# ✓ Brukereksport tilgjengelig
# ✓ Kampanjedata lesbare
# ✓ Segmentliste tilgjengelig
# ✓ Hendelsessporing operativ

Beste praksis

1. Bruk inkrementelle synkroniseringer - Unngå fulleksport; synkroniser kun endrede poster siden siste synkronisering
2. Batch brukeroppdateringer - Grupper attributtendringer for å minimere API-kall
3. Avgrens API-nøkler smalt - Aktiver kun rettighetene integrasjonen din trenger
4. Overvåk ratebegrensninger - Sett opp varsler før Braze-ratebegrensninger nås
5. Mapp eksterne ID-er konsistent - Bruk samme identifikator på tvers av Braze og Brevo
6. Test i sandbox først - Bruk et Braze-testarbeidsområde før produksjonsutrulling

Sikkerhet

• API-nøkkelautentisering - Avgrensede API-nøkler med granulære rettigheter
• Kun HTTPS - All API-kommunikasjon kryptert via TLS 1.2+
• IP-hviteliste - Valgfri IP-restriksjon for API-tilgang i Braze
• Kryptert lagring - API-påloggingsdetaljer kryptert i hvilemodus i Tajo
• Revisjonslogg - Alle API-kall logget for etterlevelsesgjennomgang

Relaterte ressurser

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