Zum Inhalt springen

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:

  1. 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.
  2. 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

  1. Gehen Sie zu Dateneinstellungen > Cloud Data Ingestion > Synchronisierungen und wählen Sie Datensynchronisierung erstellen aus.
  2. Geben Sie einen Namen ein und wählen Sie Ihre Quelle aus.
  3. Wählen Sie unter Datentyp die Option Datenobjekte, Datenobjekt-Nutzerbeziehungen oder Datenobjekt-Beziehungen aus.
  4. 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).
  5. 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.
  6. 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 denen UPDATED_AT spä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 dem object_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 – Bei true lö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 auf false.

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.

New Stuff!