Datenobjekte mit Cloud Data Ingestion synchronisieren
Auf dieser Seite erfahren Sie, wie Sie Datensätze von Datenobjekten und ihre Beziehungen mit Cloud Data Ingestion (CDI) aus Ihrer Quelle mit Braze synchronisieren. Mit Datenobjekten können Sie Geschäftsdatensätze wie Konten speichern und mit Ihren Nutzer:innen verknüpfen. Informationen zum zugrunde liegenden Objektmodell und zu den API-Endpunkten finden Sie unter Datenobjekte.
Synchronisierungstypen
Für Datenobjekte gibt es drei separate Synchronisierungstypen. Jeder davon ist eine eigene Synchronisierung in Braze mit einer eigenen Quelltabelle oder Abfrage und einem eigenen Zeitplan.
| Datentyp | Was jede Zeile darstellt | Erforderliche Bezeichner |
|---|---|---|
| Datenobjekte | Ein Datenobjekt-Datensatz, z. B. ein einzelnes Konto. | OBJECT_ID |
| Datenobjekt-Nutzerbeziehungen | Eine Verknüpfung zwischen einem Datensatz und einer Nutzer:in. | OBJECT_ID und mindestens ein Nutzer-Bezeichner |
| Datenobjekt-Beziehungen | Eine Verknüpfung zwischen zwei Datensätzen desselben oder unterschiedlichen Typs. | OBJECT_ID und RELATED_OBJECT_ID |
Synchronisieren Sie Datensätze vor den Beziehungen, die auf sie verweisen. Eine Beziehungszeile, deren Datensatz noch nicht existiert, wird zurückgehalten und erneut versucht, statt angewendet zu werden.
Bevor Sie eine Synchronisierung erstellen
CDI erstellt oder ändert während einer Synchronisierung keine Felder von Datenobjekten. Richten Sie diese daher zuerst ein:
- Fügen Sie unter Dateneinstellungen > Konten jedes Feld und jedes Beziehungsfeld hinzu, das Sie senden möchten. Markieren Sie ein Feld nur dann als erforderlich, wenn jede Zeile einen Wert dafür enthält.
- Erstellen Sie in Ihrer Quelle die Tabelle oder Ansicht für jede Synchronisierung, oder planen Sie die Abfrage, die Sie direkt in CDI schreiben.
Synchronisierung erstellen
- Gehen Sie zu Dateneinstellungen > Cloud Data Ingestion > Synchronisierungen und wählen Sie Datensynchronisierung erstellen aus.
- Geben Sie einen Namen ein und wählen Sie Ihre Quelle aus.
- Wählen Sie unter Datentyp die Option Datenobjekte, Datenobjekt-Nutzerbeziehungen oder Datenobjekt-Beziehungen aus.
- Wählen Sie für eine Datensatz-Synchronisierung den Datenobjekttyp oder für eine der beiden Beziehungs-Synchronisierungen den Beziehungsnamen aus. Beziehungsnamen zeigen die Beziehung, gefolgt von den beiden Typen, die sie verbindet, z. B. User (Account-User) oder Subaccount (Account-Account).
- Wählen Sie im Schritt Datendefinition einen Synchronisierungsmodus aus. Synchronisierungen von Datenobjekten unterstützen Tabelle und SQL bei Data-Warehouse-Quellen. Der visuelle Mapper ist für Synchronisierungen von Datenobjekten nicht verfügbar.
- Wählen Sie Vorschau und Validierung aus und fahren Sie dann mit Benachrichtigungen und Zeitplan fort.
Quellspalten
UPDATED_AT– Der Zeitpunkt, zu dem diese Zeile in der Tabelle aktualisiert oder hinzugefügt wurde. Braze synchronisiert Zeilen, bei denenUPDATED_ATspäter als der zuletzt synchronisierte Wert ist. Zeilen mit genau dem Grenzzeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel haben.OBJECT_ID– Der Bezeichner des Datenobjekt-Datensatzes. Dieser muss mit demobject_id-Wert übereinstimmen, der in Braze für diesen Datenobjekttyp verwendet wird.PAYLOAD– Ein JSON-String mit den zu synchronisierenden Feldern und Werten. Jeder Schlüssel muss einem Feld entsprechen, das für den Datenobjekttyp in Braze definiert ist.DELETED– Beitruelöscht Braze den Datensatz, anstatt ihn zu aktualisieren. Lassen Sie diesen Wert für Zeilen, die Sie erstellen oder aktualisieren möchten, leer (null) oder setzen Sie ihn auffalse.
Bei Feldnamen innerhalb von PAYLOAD wird zwischen Groß- und Kleinschreibung unterschieden. Ein Schlüssel namens NAME entspricht nicht einem Feld namens name. Wenn die Schreibweise nicht übereinstimmt, meldet die Validierung den Schlüssel als undefiniertes Feld und das Feld, das damit befüllt werden sollte, als fehlend. Benennen Sie Ihre Schlüssel genau so, wie die Felder unter Dateneinstellungen > Datenobjekte angezeigt werden.
Braze erstellt oder ändert während einer Synchronisierung keine Datenobjekttypen. Definieren Sie den Typ und alle seine Felder in Braze, bevor Sie die Synchronisierung erstellen. Wenn Sie später ein Feld hinzufügen möchten, fügen Sie es zuerst dem Typ hinzu und aktualisieren Sie anschließend Ihre Quelltabelle oder Abfrage.
Die Spaltendefinitionen und eine Beispiel-DDL im SQL-Dialekt Ihrer Quelle finden Sie auf Ihrer Quellseite.
Bezeichner für Nutzer-Beziehungen
Eine Zeile für eine Nutzer-Beziehung benötigt OBJECT_ID sowie mindestens einen Nutzer-Bezeichner: EXTERNAL_ID, die Kombination aus ALIAS_NAME und ALIAS_LABEL, EMAIL oder PHONE.
Validierung
Wenn Sie Vorschau und validieren auswählen, prüft Braze die Spalten, die Ihre Tabelle oder Abfrage zurückgibt, anhand der Felder, die für den Datenobjekttyp definiert sind. Sie können den Schritt Datendefinition erst abschließen, wenn die Validierung erfolgreich war.
| Fehler | Ursache | Behebung |
|---|---|---|
| Erforderliche Felder fehlen in Ihrer Abfrage oder sind null | Für ein Feld, das im Typ als erforderlich markiert ist, gibt es keine passende Spalte, oder diese Spalte ist in den Vorschauzeilen null. | Fügen Sie für jedes erforderliche Feld eine Spalte hinzu und stellen Sie sicher, dass jede Zeile einen Wert enthält. |
| Für den Datenobjekttyp sind die folgenden Felder nicht definiert | Eine Spalte stimmt mit keinem Feld des Typs überein. Bei Feldern wird zwischen Groß- und Kleinschreibung unterschieden, daher stimmt TEAM_ID nicht mit team_id überein. |
Korrigieren Sie den Spaltennamen so, dass er exakt mit dem Feld übereinstimmt, entfernen Sie die Spalte oder fügen Sie das Feld in Braze zum Typ hinzu. |
| Felder erwarten einen anderen Datentyp als in Ihrer Abfrage | Der Datentyp einer Spalte stimmt nicht mit dem Datentyp des Feldes überein, zum Beispiel ein String, wo das Feld eine Zahl erwartet. | Wandeln Sie die Spalte in Ihrer Quelltabelle oder Abfrage in den erwarteten Typ um. |
Beachten Sie, dass die Validierung nur die ersten 10 Zeilen prüft, die Ihre Quelle zurückgibt. Zeilen, die während einer Synchronisierung fehlschlagen, werden in den Synchronisierungsprotokollen gemeldet.
Datensätze und Beziehungen löschen
Fügen Sie Ihrer Quelle eine Spalte DELETED hinzu, um Datensätze oder Beziehungen zu entfernen. Wenn DELETED den Wert true hat, löscht Braze den Datensatz oder die Beziehung, statt sie zu aktualisieren. Das Löschen eines Datensatzes oder einer Beziehung löscht nicht die Nutzer:innen, mit denen er bzw. sie verknüpft war.
Verwandte Seiten
- Tabellen-Setup für erforderliche Spalten und die Formatierung von Payloads
- Best Practices für die Planung von Synchronisierungen und eine effiziente Nutzung von Datenpunkten
- Synchronisierungsprotokolle und Beobachtbarkeit für das Monitoring von Synchronisierungsläufen
- FAQ für häufige Fragen zu allen Quellen