DinMo
DinMo ist eine Composable Customer Data Platform (CDP), die Ihr Cloud Data Warehouse über Reverse Extract, Transform, Load (ETL) mit Braze verbindet. Marketing-Teams können Zielgruppen-Segmente aus Data-Warehouse-Daten erstellen, Nutzerattribute und Events in Braze synchronisieren und Abo-Status ohne CSV-Uploads oder technischen Support aktuell halten.
Diese Integration wird von DinMo verwaltet.
Die Integration von Braze und DinMo überträgt Segmente und Datenmodelle aus Ihrem Data Warehouse über die Braze REST API in Braze. Wenn Sie ein Braze-Ziel in DinMo verbinden, senden Aktivierungen Daten aus Ihren Modellen oder Segmenten an Braze.
Voraussetzungen
| Anforderung | Beschreibung |
|---|---|
| DinMo-Konto | Ein DinMo-Konto mit der Berechtigung, Ziele zu erstellen, ist erforderlich, um diese Partnerschaft zu nutzen. |
| Braze REST-API-Schlüssel | Ein Braze REST-API-Schlüssel mit den Berechtigungen, die für die Ziel-Dienste erforderlich sind, die Sie nutzen möchten. Dieser kann im Braze-Dashboard unter Einstellungen > API-Schlüssel erstellt werden. |
| Braze REST-Endpunkt | Ihre REST-Endpunkt-URL. Ihr Endpunkt hängt von der Braze-URL für Ihre Instanz ab. |
| Braze-Dashboard-URL | Ihre Braze-Dashboard-URL für Ihre Instanz (zum Beispiel https://dashboard.iad-01.braze.com). Weitere Informationen finden Sie unter Verfügbare SDK-Endpunkte. |
| Data Warehouse und Datenmodell | Bevor Sie mit der Integration beginnen, verbinden Sie Ihr Data Warehouse in DinMo und definieren Sie ein Modell oder Segment für die Daten, die Sie mit Braze synchronisieren möchten. Weitere Informationen finden Sie im DinMo Braze-Integrationsleitfaden. |
Anwendungsfälle
Mit dieser Integration können Sie:
- Nutzerattribute aus Ihrem Data Warehouse in Braze synchronisieren, um Campaigns und Canvases zu personalisieren.
- Angepasste Events und Kauf-Events aus Data-Warehouse-Daten an Braze senden, um verhaltensbasiertes Targeting zu ermöglichen.
- Die Mitgliedschaft in Braze-Abo-Gruppen mit in DinMo definierten Zielgruppen-Segmenten abgleichen.
- DinMo-Segmente als Braze-Nutzerattribute exportieren und daraus Braze-Segmente erstellen.
API-Schlüssel-Berechtigungen
Gewähren Sie die folgenden Berechtigungen für Ihren Braze REST-API-Schlüssel, basierend auf den Ziel-Diensten, die Sie nutzen:
| Berechtigung | Erforderlich für |
|---|---|
users.track |
Synchronisierung von Nutzerattributen, Senden von Track-Events und Validierung der Zielverbindung |
users.export.ids |
Export von Nutzer-IDs für Massenoperationen |
users.alias.update |
Aktualisierung von Nutzer-Aliasen |
subscription.status.set |
Synchronisierung von Abo-Status |
users.delete |
Nur Mirror-Sync-Modus (optional für andere Ziel-Dienste) |
Integration
1. Schritt: Braze-Ziel in DinMo konfigurieren
- Navigieren Sie in DinMo zu Destinations in der Seitennavigation.
- Wählen Sie Add a new destination > Connect a new platform > Braze.
- Geben Sie im Verbindungsformular die folgenden Details ein:
- Platform Name: Zum Beispiel
Braze – Ihr Unternehmen - REST API URL: Ihr Instanz-REST-Endpunkt (zum Beispiel
https://rest.eu-01.braze.com) - Dashboard URL: Ihre Instanz-Dashboard-URL (zum Beispiel
https://dashboard.eu-01.braze.com) - API Key: Der Schlüssel, den Sie aus Braze kopiert haben
- Platform Name: Zum Beispiel
- Wählen Sie Connect, um Ihre Zugangsdaten zu validieren.
Sie müssen sowohl die REST-API-URL als auch die Dashboard-URL angeben. Fügen Sie keinen abschließenden Schrägstrich an die REST-API-URL an.
2. Schritt: Verbindung überprüfen
Nachdem Sie das Ziel gespeichert haben, führt DinMo einen Testaufruf durch (zum Beispiel users.track), um zu bestätigen, dass Ihr API-Schlüssel und Endpunkt funktionieren.
Wenn die Validierung fehlschlägt, überprüfen Sie Folgendes:
- Die REST-API-URL ist korrekt und hat keinen abschließenden Schrägstrich.
- Der API-Schlüssel ist gültig und verfügt über die erforderlichen Berechtigungen.
- Wenn Ihr Braze-Workspace eine IP-Zulassungsliste verwendet, sind die IP-Adressen von DinMo enthalten.
Unterstützte Ziel-Dienste
Jeder Ziel-Dienst in DinMo folgt demselben allgemeinen Workflow: Erstellen Sie ein Braze-Ziel, erstellen Sie ein DinMo-Modell oder -Segment und erstellen Sie dann eine Aktivierung, um Daten an Braze zu senden. Eine schrittweise Anleitung zur Aktivierung finden Sie unter DinMo Braze-Ziel-Dienste.
Die folgenden Ziel-Dienste sind verfügbar:
| Ziel-Dienst | Beschreibung |
|---|---|
| Nutzerattribute synchronisieren | Aktualisieren Sie Nutzerprofilattribute in Braze und fügen Sie optional neue Nutzer:innen hinzu. |
| Track-Events senden | Senden Sie angepasste Events und Kauf-Events an Braze. |
| Abo-Status synchronisieren | Abonnieren oder melden Sie Nutzer:innen in einer Braze-Abo-Gruppe basierend auf der DinMo-Segmentzugehörigkeit an oder ab. |
| Nutzerlisten exportieren | Synchronisieren Sie die Segmentzugehörigkeit mit einem Braze-Nutzerattribut zur Verwendung in der Braze-Segmentierung. |
Nutzerattribute synchronisieren
Verwenden Sie diesen Ziel-Dienst, um Attribute bestehender Braze-Nutzerprofile zu aktualisieren und optional neue Nutzer:innen hinzuzufügen.
Wenn Sie eine Aktivierung ausführen:
- Wenn Sie den Einfügemodus aktivieren, werden neue Nutzer:innen im Modell in Braze erstellt (UPSERT-Verhalten).
- Geänderte Attributwerte seit der letzten Aktivierung werden in Braze aktualisiert.
Wenn Sie den Einfügemodus nicht aktivieren, aktualisiert DinMo nur Nutzer:innen, die bereits in Braze existieren und eine übereinstimmende externe ID haben.
Ordnen Sie während der Aktivierungseinrichtung das Feld in Ihrem DinMo-Modell zu, das der externen ID oder Braze-ID der Nutzer:innen entspricht. Ordnen Sie jedes DinMo-Feld dem exakten Attributnamen in Braze zu. Wenn ein Attribut in Braze nicht existiert, erstellt DinMo es.
Die folgenden Sync-Modi sind für Nutzerattribut-Aktivierungen verfügbar:
| Sync-Modus | Beschreibung |
|---|---|
| UPDATE | Aktualisiert geänderte Datensätze für Nutzer:innen, die bereits in Braze existieren. Fügt keine Datensätze ein und löscht keine. |
| UPSERT | Fügt neue Datensätze ein und aktualisiert geänderte Datensätze. Löscht keine Datensätze. |
| MIRROR | Fügt Datensätze ein, aktualisiert und löscht sie in Braze, um die Quelle zu spiegeln. Erfordert Konnektor-Unterstützung für Löschoperationen. |
Der Mirror-Sync-Modus löscht Datensätze dauerhaft aus Braze, wenn sie in der DinMo-Quelle nicht mehr vorhanden sind. Verwenden Sie den Mirror-Modus nur, wenn Ihr Data Warehouse die einzige Datenquelle ist und Löschungen beabsichtigt sind. Validieren Sie die Löschregeln, bevor Sie Mirror-Syncs in der Produktion ausführen.
Track-Events senden
Verwenden Sie diesen Ziel-Dienst, um angepasste Events oder Kauf-Events aus einem DinMo-Event-Modell oder -Segment an Braze zu senden. DinMo behandelt angepasste Events und Käufe als separate Ziel-Dienste, da Braze für jeden Typ unterschiedliche APIs verwendet.
Jeder Datensatz im Modell repräsentiert einen einzelnen Event-Typ (zum Beispiel Purchase). DinMo sendet bei jeder Aktivierung nur neue Events und aktualisiert keine zuvor gesendeten Events.
Während der Aktivierungseinrichtung:
- Geben Sie den Event-Namen genau so an, wie er in Braze erscheinen soll. Wenn das Event nicht existiert, erstellt DinMo es.
- Ordnen Sie die erforderlichen Felder zu:
- Event-Zeitpunkt: Zeitstempel, wann das Event aufgetreten ist
- Externe ID: Externe ID der Nutzer:innen, die mit dem Event verknüpft sind
- Ordnen Sie optionale Event-Eigenschaften den Braze-Attributnamen zu.
- Legen Sie den Zeitplan fest, wie oft neue Events an Braze gesendet werden.
Abo-Status synchronisieren
Verwenden Sie diesen Ziel-Dienst, um eine Braze-Abo-Gruppe mit einem DinMo-Segment oder -Modell abzugleichen.
Bevor Sie diesen Dienst aktivieren:
- Erstellen Sie die Ziel-Abo-Gruppe (SMS oder E-Mail) in Braze.
- Erstellen Sie ein DinMo-Modell oder -Segment mit den Nutzer:innen, die zu dieser Abo-Gruppe gehören sollen.
Geben Sie während der Aktivierungseinrichtung die exakte Abo-Gruppen-ID aus Braze ein. Um mehrere Abo-Gruppen zu synchronisieren, erstellen Sie eine Aktivierung pro Gruppe.
Wenn die Aktivierung ausgeführt wird:
- Wenn Nutzer:innen bereits in Braze existieren, werden Nutzer:innen, die dem DinMo-Segment beitreten, als abonniert für die Ziel-Abo-Gruppe markiert.
- Nutzer:innen, die das DinMo-Segment verlassen, werden als abgemeldet von der Abo-Gruppe markiert.
DinMo ändert keine Nutzer:innen, die nie Teil des Segments waren, und erstellt in diesem Ziel-Dienst keine neuen Braze-Nutzer:innen.
Nutzerlisten exportieren
Verwenden Sie diesen Ziel-Dienst, um ein DinMo-Segment als Braze-Nutzerattribut darzustellen. Aufgrund einer Braze-Einschränkung erstellt DinMo keine Braze-Liste direkt. Stattdessen setzt es ein Nutzerattribut auf true für Nutzer:innen im Segment und auf false für Nutzer:innen, die das Segment verlassen.
Geben Sie während der Aktivierungseinrichtung den Zielgruppennamen an. DinMo verwendet diesen Namen als Braze-Attribut (Leerzeichen werden durch Unterstriche ersetzt). Stellen Sie sicher, dass in Braze kein Attribut mit demselben Namen bereits existiert. Ordnen Sie das DinMo-Feld zu, das der externen ID der Nutzer:innen entspricht.
Erstellen Sie nach der Aktivierung ein Braze-Segment, das Nutzer:innen filtert, bei denen das synchronisierte Attribut gleich true ist.
Nur Nutzer:innen mit einer externen ID, die mit bestehenden Braze-Nutzer:innen übereinstimmt, werden aktualisiert. Dieser Ziel-Dienst erstellt keine neuen Nutzer:innen.