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 bereitgestellt werden, und eine Gruppe von Nutzer:innen zu erstellen, die innerhalb von Braze angesprochen werden können.

Erstellen eines CDI-Segments

Schritt 1: Quelle einrichten

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

Schritt 2: Segment erstellen

1. Gehen Sie zu Zielgruppe > Segmenterweiterungen und wählen Sie Neue Erweiterung erstellen.
2. Wählen Sie im Menü Erstellungsmethode für Segmenterweiterung auswählen die Option Vollständige Aktualisierung (einschließlich CDI-Segmente).

3. Wählen Sie im Menü Datenquelle für diese Segmenterweiterung auswählen die Option CDI-Datentabellen. Dieses Menü wird nur angezeigt, nachdem Sie mindestens eine verbundene Quelle eingerichtet haben.

4. Wählen Sie eine Verbindung aus und schreiben Sie dann Ihre Abfrage. Jede Verbindung verfügt über einen bestimmten Satz von Datentabellen. Ihr Entwicklungsteam kann Ihre Verbindungen und Datentabellen während der CDI-Einrichtung konfigurieren.
5. Sehen Sie sich die verfügbaren Datentabellen an, einschließlich ihres Schemas und etwaiger Beschreibungen, indem Sie Quellen-Explorer auswählen.

6. Schreiben Sie die SQL-Abfrage für Ihr Segment mithilfe 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.
   
   Wenn Ihre Abfrageergebnisse Nutzer:innen enthalten, die in Braze nicht existieren, werden diese ignoriert. Braze erstellt keine neuen Nutzer:innen auf Grundlage der Ausgabe Ihrer CDI-Segmenterweiterung.

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 mit dem external_id-Typ in Braze übereinstimmt.

7. Verwenden Sie diese Segmenterweiterung innerhalb eines Braze-Segments, um eine Campaign oder ein Canvas an diese Zielgruppe zu senden.

Tipp

Informationen dazu, wie Sie Ihre Segmenterweiterungen in der Vorschau anzeigen, verwalten und automatische Mitgliedschaftsaktualisierungen ausführen können, finden Sie unter SQL-Segmenterweiterungen.

Überlegungen

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

Fehlerbehebung

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