Cloud-Datenaufnahme: Visueller Mapper

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

Der visuelle Mapper ist für Attribut-, angepasste Event- und Canvas-Trigger-Synchronisierungen aus allen Data-Warehouse-Quellen der Cloud-Datenaufnahme verfügbar. Für andere Synchronisierungstypen siehe 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 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 Cloud-Datenaufnahme-Data-Warehouse-Quelle. Falls Sie noch keine eingerichtet haben, lesen Sie Data-Warehouse-Integrationen.
• Den Namen der Tabelle oder Ansicht, die Sie synchronisieren möchten, so wie er in Ihrem Data Warehouse angezeigt wird.
• Eine Spalte in Ihrer Tabelle, die einen unterstützten Nutzer:innen-Bezeichner enthält, sowie eine Spalte mit einem Zeitstempel, den Braze für das Änderungs-Tracking verwenden kann.

Hinweis

Braze führt nur schreibgeschützte Abfragen auf Ihre Daten aus und ändert Ihre zugrunde liegenden Tabellen nicht. Temporäre Objekte können während der Abfrageausführung erstellt werden, werden aber nicht dauerhaft gespeichert.

Erstellen einer Synchronisierung mit dem visuellen Mapper

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 wählen Sie 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 zuordnen

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

Schritt 3: Zuordnungen überprüfen

Der Abschnitt Zuordnung überprüfen verfolgt zwei erforderliche Zuordnungen. Ihre Synchronisierung kann erst erstellt werden, wenn beide abgeschlossen sind:

• Ordnen Sie eine Spalte einem von Braze akzeptierten Nutzer:innen-Bezeichner zu: external_id, braze_id, email, phone oder ein Nutzer-Alias. Bezeichner-Optionen erscheinen unter Bezeichner im Dropdown-Menü des Zielfelds.
• Ordnen Sie eine Spalte updated_at zu. Braze verwendet diesen Zeitstempel zur Änderungsverfolgung, wobei jeder Synchronisierungslauf Zeilen importiert, bei denen updated_at neuer ist als der zuletzt synchronisierte Wert.

Für jede verbleibende Spalte können Sie:

• Die Standardzuordnung beibehalten. Jede Spalte wird einem Braze-Feld mit demselben Namen zugeordnet. Wenn das Feld in Ihrem Workspace noch nicht existiert, wird es als Neues Attribut gekennzeichnet und beim ersten Lauf der Synchronisierung erstellt.
• Einem vorhandenen Feld zuordnen. Durchsuchen Sie das Dropdown-Menü des Zielfelds, um eine Spalte einem vorhandenen Standard- oder angepassten Attribut in Ihrem Workspace zuzuordnen.
• Einem neuen Feld zuordnen. Geben Sie direkt in das Dropdown-Menü des Zielfelds ein, um eine Spalte einem neuen angepassten Attribut zuzuordnen.
• Die Spalte ausschließen. Deaktivieren Sie das Kontrollkästchen Import, um eine Spalte aus der Synchronisierung auszuschließen.

Tipp

Bevor Sie ein neues Attribut erstellen, durchsuchen Sie das Ziel-Dropdown nach einem vorhandenen. Wenn Ihre Tabelle beispielsweise eine Spalte fav_color enthält, Ihr Workspace aber bereits favorite_color erfasst, sollten Sie in Betracht ziehen, fav_color auf favorite_color zuzuordnen, anstatt ein weiteres Attribut zu erstellen.

Hinweis

Felder, deren Datentyp nicht mit dem erkannten Typ Ihrer Spalte übereinstimmt, zeigen eine Warnung Typenkonflikt an. Sie können trotzdem fortfahren, aber nicht übereinstimmende Werte können als Zeilenfehler fehlschlagen. Sie können Zeilenfehler in den Laufdetails einer Synchronisierung einsehen.

Schritt 4: Vorschau und Validierung

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

Schritt 5: Erstellung der Synchronisierung abschließen

1. Geben Sie im Schritt Benachrichtigungen mindestens eine Kontakt-E-Mail für Synchronisierungsfehler-Benachrichtigungen ein. Optional können Sie Zeilenfehler-Benachrichtigungen (die gesendet werden, wenn ein bestimmter Prozentsatz der Zeilen nicht aktualisiert werden kann) und Synchronisierung erfolgreich-Benachrichtigungen aktivieren.
2. Aktivieren Sie im Schritt Zeitplan die Option Wiederkehrende Synchronisierung, um die Synchronisierung nach einem Zeitplan auszuführen, oder lassen Sie sie deaktiviert für eine einmalige Synchronisierung.
3. Überprüfen Sie den Schritt Zusammenfassung. Dort werden Ihre Konfiguration aufgelistet, welche Attribute neu im Vergleich zu vorhandenen sind, sowie alle Spalten, die aufgrund von Datentypenproblemen 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 später fortzufahren.

Umgang mit Schemaänderungen

Der visuelle Mapper überprüft das Schema Ihrer Tabelle oder Ansicht bei jedem Synchronisierungslauf und reagiert basierend auf der Art der Änderung:

Um eine pausierte Synchronisierung nach dem Entfernen einer Spalte fortzusetzen, wählen Sie Edit sync aus und überprüfen Sie Ihre Zuordnungen. Die entfernte Spalte ist markiert und erscheint nicht mehr im Mapper. Das Speichern Ihrer Zuordnungen bestätigt, dass die Synchronisierung ohne diese Spalte fortgesetzt werden soll. Alternativ können Sie, wenn die Daten in eine andere Spalte verschoben wurden, die neue Spalte vor dem Speichern zuordnen.

Häufig gestellte Fragen

Kann ich meine Abbildungen bearbeiten, nachdem eine Synchronisierung erstellt wurde?

Ja. Bearbeiten Sie die Synchronisierung und wählen Sie Abbildung anzeigen und bearbeiten aus. Das aktuelle Schema der Quelltabelle wird geladen, wobei Ihre vorherigen Abbildungen aus der Erstellung der Synchronisierung gespeichert sind. 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, bedingte Logik oder Joins über Tabellen hinweg. Für diese Anwendungsfälle verwenden Sie die SQL-Option im Schritt „Datendefinition“, um Ihre Daten stattdessen mit einer Abfrage zu formen. 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 wird meine Braze-Nutzung beeinflusst?

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