---
title: "Braze Connector"
description: "Vollständiger Leitfaden zur Braze-Integration für die Synchronisation von Customer-Engagement-Daten, Kampagnen und Messaging-Events mit Brevo über Tajo."
url: https://tajo.io/de/docs/connectors/marketing/braze/
markdown: https://tajo.io/de/docs/connectors/marketing/braze.md
lang: de-DE
robots: noindex
---

Beantrage frühzeitigen Zugang

Gib deinen Vornamen und deine geschäftliche E-Mail-Adresse ein. Wir senden dir einen Link, mit dem du deine Anfrage für den Tajo-Zugang bestätigst.

# Braze Connector

Connector-Status: Geplant Noch nicht gebaut. Tajo betreibt diesen Connector heute nicht.

| Quellfeld | Zielfeld | Beispielwert |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

## Überblick

| Eigenschaft | Wert |
| --- | --- |
| **Plattform** | Braze |
| **Kategorie** | Marketing |
| **Einrichtungsaufwand** | Mittel |
| **Offizielle Integration** | Nein |
| **Synchronisierte Daten** | Kund:innen, Events, Kampagnen, Messages |
| **API-Typ** | REST API |
| **Authentifizierung** | API-Schlüssel |
| **Basis-URL** | `https://rest.iad-XX.braze.com` (Instanz-spezifisch) |

## 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
```

Sicherheit des API-Schlüssels

Bewahre deinen Braze-API-Schlüssel sicher auf. Gib ihn niemals in clientseitigem Code oder in öffentlichen Repositories preis. Tajo verschlüsselt alle API-Anmeldedaten im Ruhezustand mit AES-256.

### Mit Tajo verbinden

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

## Konfiguration

### Grundeinrichtung

```yaml
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:

```yaml
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:

| Endpoint | Methode | Zweck |
| --- | --- | --- |
| `/users/track` | POST | User-Attribute, Events und Käufe senden |
| `/users/export/ids` | POST | User-Profile anhand externer IDs exportieren |
| `/users/export/segment` | POST | User aus einem Segment exportieren |
| `/campaigns/list` | GET | Liste der Kampagnen abrufen |
| `/campaigns/data_series` | GET | Kampagnen-Analytics im Zeitverlauf |
| `/canvas/list` | GET | Liste der Canvas-Flows abrufen |
| `/canvas/data_series` | GET | Canvas-Analytics im Zeitverlauf |
| `/segments/list` | GET | Liste der Segmente abrufen |
| `/email/status` | POST | E-Mail-Abonnementstatus ändern |
| `/subscription/status/set` | POST | Status einer Subscription Group setzen |
| `/catalogs/{catalog_name}/items` | GET | Catalog-Einträge abrufen |

## Code-Beispiele

### Connector initialisieren

```javascript
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

```javascript
// 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

```javascript
// 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

```javascript
// 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:

| Plan | Rate Limit | Burst-Limit |
| --- | --- | --- |
| **Starter** | 250.000 Anfragen/Stunde | N/A |
| **Pro** | 250.000 Anfragen/Stunde | N/A |
| **Enterprise** | Individuell | Individuell |

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

Batch-Anfragen

Tajo bündelt bis zu 75 User-Attribute, 75 Events und 75 Käufe pro `/users/track`-Anfrage, um den Durchsatz innerhalb der Rate Limits zu maximieren.

## Fehlerbehebung

### Häufige Probleme

| Problem | Ursache | Lösung |
| --- | --- | --- |
| 401 Unauthorized | Ungültiger oder abgelaufener API-Schlüssel | API-Schlüssel im Braze-Dashboard neu generieren |
| Users werden nicht synchronisiert | Falsche Instanz-URL | Überprüfe deine Braze-Instanz-URL (z. B. iad-01, iad-02) |
| Fehlende Attribute | Scope des API-Schlüssels zu eng | Ergänze die benötigten Berechtigungen für den API-Schlüssel |
| Rate Limit überschritten | Zu viele parallele Anfragen | Reduziere Batch-Größe oder Sync-Frequenz |
| Events verzögert | Große Export-Warteschlange | Nutze inkrementellen Sync statt eines Full-Exports |

### Debug-Modus

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

### Verbindung testen

```bash
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](https://tajo.io/de/docs/connectors/marketing/customerio)
- [Iterable Connector](https://tajo.io/de/docs/connectors/marketing/iterable)
- [Customer-Sync-Skill](https://tajo.io/de/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/de/docs/contact-management)