CDI-Segmenterweiterungen

Mit der Cloud-Datenaufnahme (CDI) von Braze können Sie eine direkte Verbindung von Ihrem Data Warehouse oder Dateispeichersystem zu Braze einrichten, um relevante Nutzer:innen- oder Katalogdaten regelmäßig zu synchronisieren.

Warnung

CDI-Segmenterweiterungen fragen Ihr Data Warehouse direkt ab, sodass Ihnen alle Kosten entstehen, die mit der Ausführung dieser Abfragen in Ihrem Data Warehouse verbunden sind. CDI-Segmenterweiterungen verbrauchen keine SQL-Segment-Credits, zählen nicht zu Ihrem Segmenterweiterungs-Limit und protokollieren keine Datenpunkte.

Voraussetzungen

Um Ihre Data-Warehouse-Daten für die Segmentierung in Ihrem Braze-Workspace zu nutzen, müssen Sie eine verbundene Quelle erstellen und dann ein CDI-Segment in Ihren Segmenterweiterungen anlegen. CDI-Segmenterweiterungen ermöglichen es Ihnen, SQL zu schreiben, das Ihr eigenes Data Warehouse direkt abfragt, indem es Daten nutzt, die über Ihre CDI-Verbindungen verfügbar gemacht werden, und eine Gruppe von Nutzer:innen zu erstellen, die innerhalb von Braze angesprochen werden kann.

Ein CDI-Segment erstellen

1. Schritt: Quelle einrichten

Bevor Sie Ihre erste CDI-Segmenterweiterung erstellen, richten Sie eine neue verbundene Quelle mit Ihrem Data Warehouse ein, indem Sie den Schritten unter Verbundene Quellen folgen.

2. Schritt: Segment erstellen

Erstellen Sie zunächst eine neue Segmenterweiterung und wählen Sie dann Full refresh aus.

Wählen Sie als Datenquelle CDI Data Tables aus.

Im Rahmen Ihrer CDI-Einrichtung können Sie aus verschiedenen Verbindungen auswählen, die in CDI-Segmenterweiterungen verwendet werden sollen. Jede Verbindung verfügt über einen bestimmten Satz von Datentabellen. Ihr Entwicklungsteam kann Ihre Verbindungen und Datentabellen während der CDI-Einrichtung konfigurieren.

Um die verfügbaren Datentabellen einschließlich ihres Schemas und etwaiger Beschreibungen anzuzeigen, wählen Sie Reference aus. Wenn Sie bereit sind, wählen Sie eine Verbindung aus.

Schreiben Sie als Nächstes das SQL für Ihr Segment unter Verwendung der Braze-SQL-Syntax.

Beachten Sie, dass alle CDI-Segmenterweiterungen external_user_id als ausgewählte Spalte verwenden müssen und Ihre external_user_id mit der in Braze für Nutzer:innen festgelegten übereinstimmen sollte.

Wichtig

external_user_id muss ein String-Wert sein. Wenn Ihre Quell-ID als Zahl gespeichert ist (zum Beispiel client_id als Integer), wandeln Sie sie in Ihrem SQL in einen String um, damit sie dem external_id-Typ in Braze entspricht.

Wenn Ihre Abfrageergebnisse Nutzer:innen enthalten, die in Braze nicht existieren, werden diese ignoriert. Braze erstellt keine neuen Nutzer:innen basierend auf der Ausgabe Ihrer CDI-Segmenterweiterung.

Tipp

Um zu erfahren, wie Sie Ihre Segmenterweiterungen in der Vorschau anzeigen, verwalten und automatische Mitgliedschaftsaktualisierungen ausführen können, lesen Sie SQL-Segmenterweiterungen.

Schließlich können Sie diese Segmenterweiterung verwenden, um innerhalb eines Braze-Segments eine Campaign oder ein Canvas an diese Zielgruppe zu senden.

Hinweise

• Eine Segmenterweiterung kann nur auf Daten aus einer einzigen Verbindung verweisen, nicht aus mehreren.
• Eine Segmenterweiterung kann eine der folgenden Datenquellen verwenden: CDI-Daten oder Braze-Snowflake-Daten (Currents). Sie können Datenquellen innerhalb einer Segmenterweiterung nicht mischen, aber Sie können mehrere Segmenterweiterungen erstellen, die innerhalb eines Segments gemeinsam referenziert werden.

Fehlerbehebung

• Ihre Abfrage kann ein Timeout erreichen, wenn sie Ihre maximale Laufzeit überschreitet, die für jede Verbindungssynchronisierung auf der Seite Cloud Data Ingestion festgelegt wird. Die maximal zulässige Laufzeit beträgt 60 Minuten.
• Stellen Sie sicher, dass Ihr SQL mit der passenden Syntax für Ihr Data Warehouse geschrieben ist.