Cloud-Datenaufnahme: Visueller Mapper

Diese Seite beschreibt, wie Sie mit dem visuellen Mapper eine Tabelle oder Ansicht aus Ihrem Data Warehouse mit Braze synchronisieren, ohne SQL zu schreiben oder Ihre Daten umzustrukturieren.

Der visuelle Mapper ist für Synchronisierungen von Attributen, angepassten Events und Canvas-Triggern bei allen Data-Warehouse-Quellen der Cloud-Datenaufnahme verfügbar. Informationen zu anderen Synchronisierungstypen finden Sie unter Option zur Datendefinition auswählen.

Mit dem visuellen Mapper können Sie eine vorhandene Tabelle oder Ansicht aus Ihrem Data Warehouse synchronisieren, ohne SQL zu schreiben oder Ihre Daten vorgelagert umzustrukturieren. Anstatt eine Braze-spezifische Tabelle mit den Spalten EXTERNAL_ID, UPDATED_AT und PAYLOAD zu erstellen, ordnen Sie die Spalten Ihrer vorhandenen Tabelle direkt im Dashboard den Braze-Feldern zu.

Voraussetzungen

Bevor Sie eine Synchronisierung mit dem visuellen Mapper erstellen, benötigen Sie Folgendes:

• Eine aktive Data-Warehouse-Quelle für die Cloud-Datenaufnahme. Falls Sie noch keine eingerichtet haben, lesen Sie Quellen für die Cloud-Datenaufnahme.
• Den Namen der Tabelle oder View, die Sie synchronisieren möchten, so wie er in Ihrem Data Warehouse erscheint.
• Eine Spalte in Ihrer Tabelle, die einen unterstützten Nutzer-Bezeichner enthält, sowie eine Spalte mit einem Zeitstempel, den Braze für das Tracking von Änderungen verwenden kann.

Hinweis

Braze führt ausschließlich lesende Abfragen auf Ihren Daten aus und verändert Ihre zugrunde liegenden Tabellen nicht. Während der Ausführung von Abfragen können temporäre Objekte erstellt werden, diese werden jedoch nicht dauerhaft gespeichert.

Synchronisierung mit dem visuellen Mapper erstellen

Schritt 1: Synchronisierung konfigurieren

1. Gehen Sie zu Dateneinstellungen > Cloud-Datenaufnahme > Synchronisierungen und wählen Sie dann Datensynchronisierung erstellen aus.
2. Wählen Sie einen Namen für Ihre Synchronisierung und eine aktive Datenquelle aus. Nur aktive Quellen können verwendet werden.
3. Wählen Sie unter Datenziel die Option Braze Data Platform aus.
4. Wählen Sie einen Datentyp aus.
5. Wählen Sie Weiter: Datendefinition aus.

Schritt 2: Quellschema abbilden

1. Wählen Sie im Schritt Datendefinition die Option Visuell aus.
2. Geben Sie den Namen der Tabelle oder View so ein, wie er in Ihrem Data Warehouse erscheint.
3. Wählen Sie Quellschema abbilden aus. Braze liest das Schema Ihrer Tabelle oder View aus und listet jede Spalte mit ihrem erkannten Datentyp auf, damit Sie sie einem Braze-Feld zuordnen können.

Schritt 3: Abbildungen überprüfen

Der Bereich Abbildung überprüfen verfolgt zwei erforderliche Abbildungen. Ihre Synchronisierung kann erst erstellt werden, wenn beide abgeschlossen sind:

• Ordnen Sie eine Spalte einem von Braze akzeptierten Nutzer-Bezeichner zu: external_id, braze_id, email, phone oder einem Nutzer-Alias. Die Bezeichner-Optionen werden im Dropdown-Menü für das Zielfeld unter Bezeichner angezeigt.
• Ordnen Sie eine Spalte updated_at zu. Braze verwendet diesen Zeitstempel für das Änderungs-Tracking: Bei jedem Synchronisierungslauf werden Zeilen importiert, deren updated_at-Wert später als der zuletzt synchronisierte Wert ist.

Für jede verbleibende Spalte haben Sie folgende Möglichkeiten:

• Standardabbildung beibehalten. Jede Spalte wird einem gleichnamigen Braze-Feld zugeordnet. Wenn das Feld in Ihrem Workspace noch nicht existiert, wird es als Neues Attribut markiert und beim ersten Lauf der Synchronisierung erstellt.
• Einem bestehenden Feld zuordnen. Durchsuchen Sie das Dropdown-Menü für das Zielfeld, um eine Spalte einem bestehenden Standard- oder angepassten Attribut in Ihrem Workspace zuzuordnen.
• Einem neuen Feld zuordnen. Tippen Sie direkt in das Dropdown-Menü für das Zielfeld, um eine Spalte einem neuen angepassten Attribut zuzuordnen.
• Spalte ausschließen. Deaktivieren Sie das Kontrollkästchen Importieren, um eine Spalte von der Synchronisierung auszuschließen.

Tipp

Bevor Sie ein neues Attribut erstellen, durchsuchen Sie das Dropdown-Menü für das Ziel nach einem bestehenden Attribut. Wenn Ihre Tabelle beispielsweise eine Spalte fav_color enthält, Ihr Workspace aber bereits favorite_color trackt, sollten Sie fav_color besser favorite_color zuordnen, anstatt ein weiteres Attribut zu erstellen.

Hinweis

Felder, deren Datentyp nicht mit dem erkannten Typ Ihrer Spalte übereinstimmt, zeigen eine Warnung Typkonflikt an. Sie können trotzdem fortfahren, aber nicht übereinstimmende Werte werden möglicherweise nicht synchronisiert und als Zeilenfehler gemeldet. Zeilenfehler können Sie in den Laufdetails einer Synchronisierung einsehen.

Schritt 4: Vorschau und Validierung

Wählen Sie Vorschau und Validierung aus, um eine schreibgeschützte Prüfung Ihrer Tabelle oder View durchzuführen. Die Vorschau zeigt die ersten 10 Zeilen mit Ihren zugeordneten Feldnamen an und enthält nur die Spalten, die Sie importieren.

Schritt 5: Erstellung der Synchronisierung abschließen

1. Geben Sie im Schritt Benachrichtigungen mindestens eine Kontakt-E-Mail-Adresse für Benachrichtigungen über Synchronisierungsfehler ein. Optional können Sie Warnungen bei Zeilenfehlern (werden gesendet, wenn ein bestimmter Prozentsatz von Zeilen nicht aktualisiert werden kann) und Benachrichtigungen bei erfolgreicher Synchronisierung aktivieren.
2. Aktivieren Sie im Schritt Zeitplan die Option Wiederkehrende Synchronisierung, um die Synchronisierung nach einem Zeitplan auszuführen, oder lassen Sie sie für eine einmalige Synchronisierung deaktiviert.
3. Überprüfen Sie den Schritt Zusammenfassung. Dort werden Ihre Konfiguration, die neuen und die bestehenden Attribute sowie alle Spalten aufgeführt, die aufgrund von Datentypproblemen oder Ihrer Auswahl vom Import ausgeschlossen wurden.
4. Wählen Sie Synchronisierung erstellen aus. Sie können auch in jedem Schritt Als Entwurf speichern auswählen, um die Erstellung später abzuschließen.

Umgang mit Schemaänderungen

Der visuelle Mapper prüft das Schema Ihrer Tabelle oder Ansicht bei jedem Synchronisierungslauf und reagiert je nach Art der Änderung:

Um eine pausierte Synchronisierung nach dem Entfernen einer Spalte fortzusetzen, wählen Sie Synchronisierung bearbeiten aus und überprüfen Sie Ihre Zuordnungen. Die entfernte Spalte wird markiert und erscheint nicht mehr im Mapper. Wenn Sie Ihre Zuordnungen speichern, bestätigen Sie, dass die Synchronisierung ohne diese Spalte fortgesetzt werden soll. Wenn die Daten in eine andere Spalte verschoben wurden, können Sie alternativ die neue Spalte zuordnen, bevor Sie speichern.

Häufig gestellte Fragen

Kann ich meine Abbildungen nach dem Erstellen einer Synchronisierung bearbeiten?

Ja. Bearbeiten Sie die Synchronisierung und wählen Sie Abbildung anzeigen und bearbeiten. Das aktuelle Schema der Quelltabelle wird geladen, wobei Ihre vorherigen Abbildungen aus der Erstellung der Synchronisierung gespeichert bleiben. Von dort aus können Sie Ihre Abbildungen bearbeiten.

Kann ich meine Daten im visuellen Mapper transformieren?

Nein. Der visuelle Mapper synchronisiert Spaltenwerte genau so, wie sie in Ihrer Quelle erscheinen. Er unterstützt keine Transformationen, keine bedingte Logik und keine Joins über mehrere Tabellen hinweg. Für diese Anwendungsfälle verwenden Sie stattdessen die SQL-Option im Schritt „Datendefinition“, um Ihre Daten mit einer Abfrage aufzubereiten. Weitere Informationen finden Sie unter Cloud-Datenaufnahme: SQL-Editor.

Ändern sich meine bestehenden CDI-Synchronisierungen?

Nein. Synchronisierungen, die das bestehende Tabellenformat mit den Spalten EXTERNAL_ID, UPDATED_AT und PAYLOAD verwenden, funktionieren weiterhin, und Sie können sie auch weiterhin erstellen.

Wie wirkt sich das auf meine Braze-Nutzung aus?

Jede Spalte, die Sie importieren und abbilden, wird als Braze-Feld-Update geschrieben, und die Abrechnung der Datenpunkte funktioniert genauso wie bei anderen CDI-Synchronisierungen von Nutzerdaten. Wenn Sie nicht benötigte Spalten ausschließen, bleiben Ihre Synchronisierungen effizient. Weitere Informationen finden Sie unter Best Practices für die Cloud-Datenaufnahme.