Braze

Die Braze-Integration von Rekomi arbeitet mit einer Abfolge aus zwei Aufrufen:

1. POST /users/track legt das Nutzerprofil mit einem über die E-Mail-Adresse identifizierten Attributobjekt an oder aktualisiert es (email, first_name, last_name, rekomi_tags). Rekomi sendet bewusst keine external_id: Eine external_id, die Braze nicht kennt, erzeugt ein komplett neues Profil. Erst die Identifizierung über die E-Mail-Adresse sorgt dafür, dass deine bestehenden Profile aktualisiert werden, statt Duplikate zu erzeugen.
2. POST /v2/subscription/status/set trägt den Nutzer mit subscription_state: "subscribed" in die gewählte Subscription Group ein.

Verbinden

1. Braze > Settings > API Keys. Erstelle einen REST-API-Schlüssel mit den Berechtigungen users.track und subscription.status.set (für die Synchronisierung) sowie email.hard_bounces (nur für den Verbindungstest von Rekomi).
2. Suche in Braze die URL des REST-Endpunkts deines Clusters (z. B. https://rest.iad-01.braze.com).
3. Öffne in Rekomi Integrationen > Braze, füge beides ein und klicke auf Verbinden.
4. Braze kann keine Listen auflisten, deshalb zeigt die Integrationsseite statt einer Listenauswahl ein Feld Zielgruppen-/Gruppen-ID zur manuellen Eingabe; füge dort die ID deiner Subscription Group ein.

Tags

Braze hat keine eigenen Tags. Rekomi sendet Tags als Array-Attribut rekomi_tags; segmentiere in Braze mit rekomi_tags includes "X".

Vermittelte Kunden und Leads (optional)

Schalte auf der Integrationsseite Vermittelte Kunden und Leads synchronisieren ein, dann schreibt Rekomi jeden Verkauf und jeden Lead, den es einem Affiliate zuordnet, auch nach Braze. Der Abgleich läuft über die E-Mail-Adresse, bestehende Kontakte werden also aktualisiert statt doppelt angelegt. Jeder Eintrag enthält:

• die eigenen Attribute rekomi_referral_link, rekomi_campaign, rekomi_referring_affiliate, rekomi_referring_affiliate_code, rekomi_last_event und rekomi_last_sale_amount im Nutzerprofil
• im Array rekomi_tags zusätzlich Rekomi customer oder Rekomi lead (ergänzt, nie ersetzt)
• Affiliates, die über den Abschnitt oben synchronisiert werden, bekommen in denselben Feldern zusätzlich Rekomi referral link, Rekomi campaign und Rekomi affiliate status, damit du den Link eines Partners in deine E-Mails einbauen kannst.

Erstattete, abgelehnte und wegen Betrugsverdacht in Quarantäne gestellte Conversions werden nie übertragen, importierte historische Conversions werden übersprungen. Die Option ist standardmäßig ausgeschaltet.

Hinweise zum Anbieter

• Bearer-Authentifizierung mit dem REST-API-Schlüssel.
• Endpunkt pro Cluster mit strenger SSRF-Allowlist: rest.{iad|us|au|id|jp|kr}-NN.braze.com und rest.fra-NN.braze.eu (inklusive der Cluster in Indonesien, Japan und Korea).
• Der Verbindungstest fragt GET /email/hard_bounces?limit=1 ab (daher die zusätzliche Berechtigung für den Schlüssel; Braze hat keinen Lese-Endpunkt, der zu den Schreibberechtigungen der Synchronisierung passt).
• /users/track läuft serverseitig asynchron, wird aber zuverlässig gespeichert; Rekomi wertet 2xx als Erfolg und protokolliert alle nicht kritischen errors-Einträge, die der 2xx-Body enthält.
• Bei 429 wird Retry-After beachtet.
• Trennen löscht den Integrationseintrag.

---

Anwendungsfälle, passende Zielgruppen und besondere Automatisierungsmuster findest du im Überblick zur Braze-Integration auf der Website.