Braze Connector

Verbinde deine Braze-Engagement-Plattform mit Brevo für einheitliche Kundenprofile, kanalübergreifende Kampagnen-Orchestrierung und konsolidierte Marketing-Analytics.

Überblick

Funktionen

• User-Profile-Sync - Bidirektionale Synchronisation der Kundenattribute zwischen Braze und Brevo
• Kampagnen-Event-Tracking - Tracke E-Mail-Öffnungen, Klicks, Conversions und Abmeldungen
• Canvas-Flow-Daten - Synchronisiere mehrstufige Kampagnen-Journey-Daten für ein einheitliches Reporting
• Segment-Spiegelung - Repliziere Braze-Segmente als Brevo-Listen für plattformübergreifendes Targeting
• Push-Notification-Events - Leite Push-Engagement-Daten in die Brevo-Kontakt-Timelines weiter
• Catalog-Sync - Synchronisiere Produktkataloge für personalisierte Empfehlungen

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

1. Ein Braze-Konto mit aktiviertem API-Zugriff
2. Einen Braze-REST-API-Schlüssel mit den passenden Berechtigungen
3. Deine Braze-Instanz-URL (z. B. rest.iad-01.braze.com)
4. Ein Brevo-Konto mit API-Zugriff
5. Ein Tajo-Konto mit einem aktiven Abonnement

Authentifizierung

Braze nutzt eine API-Schlüssel-Authentifizierung. Jeder API-Schlüssel kann auf bestimmte Endpoints beschränkt werden.

API-Schlüssel erstellen

1. Melde dich in deinem Braze-Dashboard an
2. Navigiere zu Settings > API Keys
3. Klicke auf Create New API Key
4. Benenne ihn “Tajo Integration”
5. Aktiviere die folgenden Berechtigungen:

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

Mit Tajo verbinden

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

Konfiguration

Grundeinrichtung

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

Feldzuordnung

Ordne Braze-User-Attribute den Brevo-Kontaktattributen zu:

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 integriert sich mit den folgenden Braze-REST-API-Endpoints:

Code-Beispiele

Connector initialisieren

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

User-Profile synchronisieren

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

Segmentdaten exportieren

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

Rate Limits

Braze wendet Rate Limits abhängig von deinem Plan und deiner Instanz an:

Der Endpoint /users/track hat ein Standard-Limit von 50.000 Anfragen pro Minute. Tajo verarbeitet Rate Limits automatisch mit exponentiellem Backoff.

Fehlerbehebung

Häufige Probleme

Debug-Modus

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

Verbindung testen

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

Best Practices

1. Inkrementelle Syncs nutzen - Vermeide Full-Exports; synchronisiere nur die seit dem letzten Sync geänderten Datensätze
2. User-Updates bündeln - Fasse Attributänderungen zusammen, um API-Aufrufe zu minimieren
3. API-Schlüssel eng scopen - Aktiviere nur die Berechtigungen, die deine Integration tatsächlich benötigt
4. Rate Limits überwachen - Richte Alerts ein, bevor du die Braze-Rate-Limits erreichst
5. Externe IDs konsistent mappen - Nutze dieselbe Kennung plattformübergreifend in Braze und Brevo
6. Erst in der Sandbox testen - Nutze ein Braze-Test-Workspace, bevor du produktiv gehst

Sicherheit

• API-Schlüssel-Authentifizierung - Gescopte API-Schlüssel mit granularen Berechtigungen
• Nur HTTPS - Die gesamte API-Kommunikation wird per TLS 1.2+ verschlüsselt
• IP-Allowlisting - Optionale IP-Beschränkung für den API-Zugriff in Braze
• Verschlüsselte Speicherung - API-Anmeldedaten werden in Tajo verschlüsselt im Ruhezustand gespeichert
• Audit-Logging - Alle API-Aufrufe werden für die Compliance-Prüfung protokolliert

Verwandte Ressourcen

• Customer.io Connector
• Iterable Connector
• Customer-Sync-Skill
• Brevo Contacts API