Braze-connector

Verbind je Braze-engagementplatform met Brevo voor uniforme klantprofielen, cross-channel-campagneorkestratie en geconsolideerde marketinganalytics.

Overzicht

Functies

• Gebruikersprofielsync - Bidirectionele synchronisatie van klantattributen tussen Braze en Brevo
• Campagne-event-tracking - Track e-mailopens, clicks, conversies en uitschrijvingen
• Canvas-flowdata - Synchroniseer multi-step-campagne-journeydata voor uniforme rapportage
• Segmentmirror - Repliceer Braze-segmenten als Brevo-lijsten voor cross-platform-targeting
• Pushnotificatie-events - Stuur push-engagementdata door naar Brevo-contact-timelines
• Catalogussync - Synchroniseer productcatalogi voor gepersonaliseerde aanbevelingen

Vereisten

Voordat je begint, zorg dat je beschikt over:

1. Een Braze-account met ingeschakelde API-toegang
2. Een Braze REST API-sleutel met de juiste rechten
3. Je Braze-instantie-URL (bijv. rest.iad-01.braze.com)
4. Een Brevo-account met API-toegang
5. Een Tajo-account met een actief abonnement

Authenticatie

Braze gebruikt API-sleutelauthenticatie. Elke API-sleutel kan worden gescope op specifieke endpoints.

Een API-sleutel aanmaken

1. Log in op je Braze-dashboard
2. Ga naar Settings > API Keys
3. Klik op Create New API Key
4. Noem hem “Tajo Integration”
5. Activeer de volgende rechten:

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

Verbinden met Tajo

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

Configuratie

Basisopzet

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

Veldmapping

Koppel Braze-gebruikersattributen aan Brevo-contactattributen:

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

  # Engagement metrics
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Custom attributes
  loyalty_points: LOYALTY_POINTS
  last_app_version: APP_VERSION
  preferred_language: LANGUAGE

API-endpoints

Tajo integreert met de volgende Braze REST API-endpoints:

Codevoorbeelden

Connector initialiseren

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

Gebruikersprofielen synchroniseren

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

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

Custom events tracken

// Forward Braze events to 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
    }
  }
});

Segmentdata exporteren

// Export a Braze segment and create a Brevo list
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`);

Ratelimits

Braze hanteert ratelimits op basis van je plan en instantie:

Het /users/track-endpoint heeft een standaardlimiet van 50.000 requests per minuut. Tajo regelt rate-limiting automatisch met exponentiële backoff.

Probleemoplossing

Veelvoorkomende problemen

Debugmodus

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

Verbinding testen

tajo connectors test braze
# ✓ API connection successful
# ✓ User export accessible
# ✓ Campaign data readable
# ✓ Segment list accessible
# ✓ Event tracking operational

Best practices

1. Gebruik incremental syncs - Vermijd volledige exports; synchroniseer alleen records die sinds de laatste sync zijn gewijzigd
2. Batch gebruikersupdates - Groepeer attribuutwijzigingen om API-calls te minimaliseren
3. Scope API-sleutels strak - Activeer alleen de rechten die je integratie nodig heeft
4. Monitor ratelimits - Stel alerts in vóór je Braze-ratelimits raakt
5. Koppel externe ID’s consistent - Gebruik dezelfde identifier in Braze en Brevo
6. Test eerst in sandbox - Gebruik een Braze-testworkspace vóór productiedeployment

Beveiliging

• API-sleutel-authenticatie - Gescopede API-sleutels met granulaire rechten
• Alleen HTTPS - Alle API-communicatie versleuteld via TLS 1.2+
• IP-allowlisting - Optionele IP-beperking voor API-toegang in Braze
• Versleutelde opslag - API-inloggegevens versleuteld opgeslagen in Tajo
• Audit-logging - Alle API-calls gelogd voor compliancereview

Gerelateerde resources

• Customer.io-connector
• Iterable-connector
• Customer Sync-skill
• Brevo Contacts API