BrazeAI Decisioning Studio-Daten synchronisieren
Diese Seite beschreibt, wie Sie Daten aus Ihrem Data Warehouse mithilfe der Cloud-Datenaufnahme (CDI) direkt mit BrazeAI Decisioning Studio™ synchronisieren.
Mit dem Decisioning-Studio-Ziel von CDI kann CDI Warehouse-Daten auch direkt mit BrazeAI Decisioning Studio synchronisieren. Daten aus diesen Synchronisierungen werden Decisioning Studio zur Aktivierung bereitgestellt, Ihre Nutzerprofile und Braze-Workspaces bleiben dabei jedoch unverändert.
Dieses Feature befindet sich im Early Access. Wenden Sie sich an Ihren Customer-Success-Manager oder Ihre:n Account Manager:in, um Zugang zu erhalten.
Funktionsweise
Wenn Sie eine Synchronisierung erstellen, wählen Sie Decisioning Studio als Ziel aus und schreiben eine SQL-Abfrage, die die zu synchronisierenden Daten zurückgibt. CDI führt diese Abfrage nach dem von Ihnen festgelegten Zeitplan aus und stellt die Ergebnisse als Decisioning Studio-Asset bereit. Jede Synchronisierung ist genau einem Asset zugeordnet, daher können Sie nicht mehrere Synchronisierungen auf dasselbe Asset ausrichten.
Anders als Synchronisierungen mit der Braze-Datenplattform ordnen Decisioning Studio-Synchronisierungen Ihre Daten keinen Nutzerprofilen, Events oder Katalogen zu.
Weitere Möglichkeiten, Daten für Decisioning Studio verfügbar zu machen, finden Sie unter Daten verbinden.
Voraussetzungen
- Zugriff auf Braze und BrazeAI Decisioning Studio.
- Eine aktive Data-Warehouse-Quelle für Cloud Data Ingestion. Falls Sie noch keine eingerichtet haben, lesen Sie Quellen für Cloud Data Ingestion.
- Die Tabelle oder View, die Sie synchronisieren möchten.
- Eine Spalte (oder mehrere Spalten) in dieser Tabelle, die als Primärschlüssel dient, sowie eine Zeitstempelspalte, die CDI für die inkrementelle Synchronisierung verwenden kann.
Decisioning-Studio-Synchronisierung erstellen
Schritt 1: Synchronisierung erstellen und Ziel auswählen
- Gehen Sie zu Dateneinstellungen > Cloud-Datenaufnahme > Synchronisierungen.
- Wählen Sie Datensynchronisierung erstellen.
- Geben Sie einen Integrationsnamen ein und wählen Sie dann unter Datenquellen Ihre Quelle aus.
- Legen Sie unter Ziel das Datenziel auf BrazeAI Decisioning Studio™ fest.
- Wählen Sie unter Datenkategorie den Typ für Decisioning-Studio-Daten aus, der am besten zu Ihrer Tabelle passt. Zur Auswahl stehen Kundenprofil, Message-Engagement-Events, Konversions-Events und Sonstiges. Damit werden die Daten für Decisioning Studio getaggt. Die Verarbeitung Ihrer Zeilen durch CDI ändert sich dadurch nicht.
Schritt 2: SQL-Abfrage schreiben
Schreiben Sie im Schritt Datendefinition eine SQL-Abfrage, die die Daten aus der Tabelle oder View zurückgibt, die Sie synchronisieren möchten. Das Abfrageergebnis bildet das Schema für Ihre Synchronisierung.
Mit dem Source Explorer können Sie verfügbare Tabellen und Views durchsuchen. Der KI-SQL-Generator hilft Ihnen beim Schreiben Ihrer Abfrage.
Ihre Abfrage muss eine Spalte UPDATED_AT zurückgeben, da CDI UPDATED_AT für die inkrementelle Synchronisierung und das Tracking von Änderungen verwendet. Bei jedem Synchronisierungslauf synchronisiert CDI nur Zeilen, deren UPDATED_AT später ist als der zuletzt synchronisierte Wert. Wenn die von Ihnen ermittelte Zeitstempelspalte nicht bereits UPDATED_AT heißt, können Sie in Ihrer Abfrage einen Alias dafür festlegen:
SELECT *, LAST_MODIFIED AS UPDATED_AT FROM my_table
Weitere Informationen dazu, wie UPDATED_AT die inkrementelle Synchronisierung steuert und was passiert, wenn Sie den Wert zurücksetzen, finden Sie unter Die Spalte UPDATED_AT verstehen.
Es werden nur schreibgeschützte Abfragen mit einer einzelnen Anweisung unterstützt, einschließlich JOIN-Klauseln. CDI führt ausschließlich lesende Abfragen aus und verändert Ihre zugrunde liegenden Tabellen nicht.
Schritt 3: Vorschau anzeigen und Abfrage validieren
Wählen Sie Vorschau und Validierung, um Ihre Abfrage auszuführen. Der Bereich Abfragevorschau (erste 10 Zeilen) zeigt die ersten 10 Zeilen aus Ihrer Quelle zusammen mit dem erkannten Datentyp jeder Spalte an. So können Sie prüfen, ob die Daten korrekt aussehen, bevor Sie fortfahren.
Schritt 4: Primärschlüssel auswählen
Jede Decisioning-Studio-Synchronisierung benötigt einen Primär- oder zusammengesetzten Schlüssel, also eine oder mehrere Spalten, die jede Zeile eindeutig identifizieren. Öffnen Sie nach erfolgreicher Validierung das Dropdown-Menü Primärschlüssel und wählen Sie eine Spalte als Primärschlüssel aus. Wenn Sie mehrere Spalten auswählen, entsteht ein zusammengesetzter Schlüssel.
Ein guter Primärschlüssel ist für jede Zeile eindeutig, nie leer und über alle Synchronisierungsläufe hinweg stabil. Vermeiden Sie Werte, die erst bei der Abfrage erzeugt werden, etwa UUID() oder CURRENT_TIMESTAMP, da diese zu doppelten oder fehlenden Zeilen führen können.
Schritt 5: Benachrichtigungen und Zeitplan festlegen und Synchronisierung erstellen
- Geben Sie im Schritt Benachrichtigungen eine oder mehrere Kontakt-E-Mail(s) ein, die Benachrichtigungen über Synchronisierungsfehler erhalten sollen. Sie können außerdem Benachrichtigungen für Zeilenfehler und Erfolgreiche Synchronisierung aktivieren.
- Aktivieren Sie im Schritt Zeitplan die Option Wiederkehrende Synchronisierung, um die Synchronisierung automatisch nach Zeitplan auszuführen. Ist Wiederkehrende Synchronisierung deaktiviert, läuft die Synchronisierung nur, wenn Sie sie auslösen – entweder manuell im Dashboard oder über den Endpunkt Synchronisierung triggern.
- Überprüfen Sie die Zusammenfassung und erstellen Sie dann die Synchronisierung.
Synchronisierung bearbeiten
Wenn Sie eine bestehende Synchronisierung bearbeiten, muss jede Änderung an Ihrer SQL-Abfrage erneut validiert werden, bevor Sie speichern können. Primär- und zusammengesetzte Schlüssel können nicht geändert werden und müssen weiterhin zurückgegeben werden.
Gültige Änderungen werden beim nächsten Synchronisierungslauf wirksam.
Umgang mit Schemaänderungen
CDI verarbeitet Änderungen am Quellschema additiv. Bei jedem Synchronisierungslauf vergleicht CDI Ihr Quellschema mit dem vorhandenen Decisioning Studio-Asset. Dabei fügt CDI alle neuen Spalten hinzu und behält die bereits vorhandenen bei.
| Änderung in Ihrer Quelltabelle | Synchronisierungsverhalten |
|---|---|
| Eine neue Spalte wird hinzugefügt | CDI fügt die Spalte dem Decisioning Studio-Asset hinzu. Zeilen, die vor dem Anlegen der Spalte geliefert wurden, zeigen dafür null an. |
| Eine Spalte wird entfernt | CDI aktualisiert diese Spalte nicht mehr, aber die Spalte und ihre vorhandenen Daten bleiben im Asset erhalten. Die übrigen Spalten werden weiterhin synchronisiert. |
| Eine Spalte wird umbenannt | Wird als entfernte Spalte plus neue Spalte behandelt. Die ursprüngliche Spalte bleibt im Asset erhalten, und die neue Spalte wird hinzugefügt. |
| Der Datentyp einer Spalte ändert sich | CDI konvertiert Werte, soweit möglich. Zeilen, die nicht konvertiert werden können, werden in den Laufdetails der Synchronisierung als Zeilenfehler gemeldet. |
Wenn CDI eine Schemaänderung erkennt, wird diese in den Laufdetails der Synchronisierung und auf der Seite zum Bearbeiten der Synchronisierung angezeigt. Außerdem erhalten Ihre Benachrichtigungskontakte eine E-Mail-Warnung. Wenn Sie ändern möchten, welche Spalten geliefert werden, aktualisieren Sie Ihre SQL-Abfrage und validieren Sie sie erneut.