Braze Cloud-Datenaufnahme
Mit Braze Cloud Data Ingestion (CDI) können Sie eine direkte Verbindung von Ihrer Datenspeicherlösung einrichten, um relevante Nutzerdaten und andere Nicht-Nutzerdaten mit Braze zu synchronisieren. Diese Daten können anschließend für die Personalisierung oder Segmentierung verwendet werden, um Ihre Marketing-Anwendungsfälle zu optimieren. Die flexible Integration der Cloud-Datenaufnahme unterstützt komplexe Datenstrukturen, einschließlich verschachtelter JSON-Objekte und Objekt-Arrays.
Funktionsweise
Mit Braze Cloud-Datenaufnahme (CDI) richten Sie eine Integration zwischen Ihrer Data-Warehouse-Instanz und Ihrem Braze-Workspace ein, um Daten nach Zeitplan oder bei Bedarf zu synchronisieren. Jede Integration kann einen eigenen Zeitplan haben.
- Geplante Synchronisierungen: Wiederkehrende Synchronisierungen können bis zu alle 5 Minuten oder auch nur einmal im Monat laufen. Standardmäßig ist das kürzeste Intervall, das Sie im Dashboard festlegen können, 15 Minuten. Das hilft Ihnen, die Rechenkosten Ihres Data Warehouse und das Anfragevolumen zu steuern. Wenn Sie bis zu alle 5 Minuten synchronisieren möchten, wenden Sie sich an den Braze-Support oder Ihre:n Customer-Success-Manager:in.
- On-Demand-Synchronisierungen: Wenn Sie Daten synchronisieren möchten, sobald sie sich ändern, rufen Sie den Endpunkt Synchronisierung triggern mit Ihrer Integrations-ID auf, sobald Ihr Lade- oder Transformationsjob im Data Warehouse abgeschlossen ist. On-Demand-Synchronisierungen wirken sich nicht auf Ihren wiederkehrenden Zeitplan aus. Pro Integration kann jeweils nur eine Synchronisierung gleichzeitig laufen.
Dateispeicher-Integrationen (Amazon S3, Azure Blob Storage und Google Cloud Storage) sind Event-gesteuert und verwenden keinen Zeitplan. Braze nimmt neue Dateien auf, sobald sie hochgeladen werden. Details zur Einrichtung finden Sie unter Amazon S3, Google Cloud Storage oder Azure Blob Storage.
Wenn eine Synchronisierung läuft, stellt Braze eine direkte Verbindung zu Ihrer Data-Warehouse-Instanz her, ruft alle neuen Daten aus der angegebenen Tabelle ab und aktualisiert die entsprechenden Daten in Ihrem Braze-Dashboard. Bei jeder Synchronisierung werden alle aktualisierten Daten in Braze übernommen.
Anwendungsfälle
Mit den Funktionen der Braze Cloud-Datenaufnahme können Sie:
- In nur wenigen Minuten eine einfache Integration direkt von Ihrem Data Warehouse oder Ihrer Dateispeicherlösung zu Braze erstellen.
- Nutzerdaten, einschließlich Attributen, Events und Käufen, sicher von Ihrem Data Warehouse mit Braze synchronisieren.
- Den Datenkreislauf mit Braze schließen, indem Sie die Cloud-Datenaufnahme mit Currents oder Snowflake Data Sharing kombinieren.
Darüber hinaus sind verbundene Quellen eine Zero-Copy-Alternative. Sie können Braze Ihr Data Warehouse oder Ihre Dateispeicherlösung direkt abfragen lassen, um CDI-Segmente zu erstellen — ganz ohne die zugrunde liegenden Daten nach Braze zu kopieren.
Unterstützte Datenquellen
Die Cloud-Datenaufnahme kann Daten aus den folgenden Quellen synchronisieren. Für jede Quelle gibt es eine eigene Einrichtungsseite unter Quellen für die Cloud-Datenaufnahme.
Data Warehouses
Dateispeicher
Unterstützte Datentypen
Die Cloud-Datenaufnahme unterstützt die folgenden Datentypen:
Nutzerdaten
- Nutzerattribute, einschließlich:
- Verschachtelte angepasste Attribute
- Arrays von Objekten
- Abo-Status
- Angepasste Events
- Kauf-Events
- Anfragen zur Löschung von Nutzer:innen
Nicht-Nutzer-Objekte
- Katalogartikel
- Datenobjekte, einschließlich Nutzerbeziehungen und Objektbeziehungen
Zero-Copy-Messaging
- Canvas-Trigger
- Verbundene Quellen
Nutzer-Bezeichner für die Datenaufnahme
Wenn Sie Nutzerdaten über die Cloud-Datenaufnahme synchronisieren, können Sie Nutzer:innen mit einem oder mehreren der folgenden Bezeichnertypen identifizieren. Jede Zeile in Ihrer Quelltabelle sollte jeweils nur einen Wert für einen einzigen Bezeichnertyp enthalten. Ihre Tabelle kann jedoch Spalten für einen, zwei, drei, vier oder alle fünf Bezeichnertypen enthalten.
| Bezeichner | Beschreibung |
|---|---|
EXTERNAL_ID |
Die externe ID, die das zu erstellende oder zu aktualisierende Nutzerprofil identifiziert. Sie sollte mit dem in Braze verwendeten Wert external_id übereinstimmen. |
ALIAS_NAME und ALIAS_LABEL |
Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein, und alias_label gibt den Typ des Alias an. Nutzer:innen können mehrere Aliasse mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label. |
BRAZE_ID |
Der vom Braze SDK generierte Braze-Nutzer-Bezeichner. Über die Cloud-Datenaufnahme können keine neuen Nutzer:innen mit einer Braze-ID erstellt werden. Um neue Nutzer:innen zu erstellen, geben Sie eine externe Nutzer-ID oder einen Nutzer-Alias an. |
EMAIL |
Die E-Mail-Adresse der Nutzer:in. Wenn mehrere Profile mit derselben E-Mail-Adresse existieren, wird das zuletzt aktualisierte Profil bei Updates priorisiert. Wenn Sie sowohl E-Mail als auch Telefonnummer angeben, wird die E-Mail als primärer Bezeichner verwendet. |
PHONE |
Die Telefonnummer der Nutzer:in. Wenn mehrere Profile mit derselben Telefonnummer existieren, wird das zuletzt aktualisierte Profil bei Updates priorisiert. |
Ausführliche Informationen zur Einrichtung von Tabellenspalten und zu den Anforderungen an die Formatierung der Payload finden Sie unter Tabelleneinrichtung für die Cloud-Datenaufnahme.
Quellenspezifische Einrichtungsanleitungen und SQL-Beispiele finden Sie unter Quellen für die Cloud-Datenaufnahme.
Integrations-ID finden
Sie finden Ihre Integrations-ID in der URL, wenn Sie eine Integration im Braze-Dashboard aufrufen. Gehen Sie zu Dateneinstellungen > Cloud-Datenaufnahme und wählen Sie eine Integration aus. Die Integrations-ID erscheint in der URL im Format https://[instance].braze.com/integrations/cloud_data_ingestion/[integration_id]. Lautet Ihre URL beispielsweise https://dashboard-01.braze.com/integrations/cloud_data_ingestion/abc123xyz, ist Ihre Integrations-ID abc123xyz. Sie können diese ID bei API-Aufrufen verwenden, um Synchronisierungen zu triggern oder den Synchronisierungsstatus zu überprüfen.
Datenpunkt-Nutzung
Für Kund:innen mit datenpunktbasierter Abrechnung entspricht die Datenpunkt-Abrechnung für die Cloud-Datenaufnahme der Abrechnung von Updates über den Endpunkt /users/track. Weitere Informationen finden Sie unter Datenpunkte.
Die Braze Cloud-Datenaufnahme wird auf das verfügbare Rate-Limit angerechnet. Wenn Sie Daten also auch über eine andere Methode senden, teilen sich die Braze API und die Cloud-Datenaufnahme dasselbe Rate-Limit.
Produktbeschränkungen
| Beschränkung | Beschreibung |
|---|---|
| Anzahl der Integrationen | Es gibt keine Begrenzung für die Anzahl der Integrationen, die Sie einrichten können. |
| Anzahl der Zeilen | Standardmäßig kann jeder Lauf bis zu 500 Millionen Zeilen synchronisieren. Synchronisierungen mit mehr als 500 Millionen neuen Zeilen werden gestoppt. Wenn Sie ein höheres Limit benötigen, wenden Sie sich an Ihren Braze Customer-Success-Manager oder den Braze-Support. |
| Attribute pro Zeile | Bei Synchronisierungen mit einer PAYLOAD-Spalte sollte jede Zeile eine einzelne Nutzer-ID und ein JSON-Objekt mit bis zu 250 Attributen enthalten. Jeder Schlüssel im JSON-Objekt zählt als ein Attribut (ein Array zählt also als ein Attribut). |
| Felder pro Datenobjekt | Ein Datenobjekttyp kann bis zu 500 Felder haben. Eine Beziehung zwischen zwei Typen kann bis zu 25 Felder haben. |
| Payload-Größe | Bei Synchronisierungen mit einer PAYLOAD-Spalte kann jede Zeile eine Payload von bis zu 1 MB enthalten. Payloads, die größer als 1 MB sind, werden abgelehnt, und der Fehler „Payload was greater than 1MB“ wird zusammen mit der zugehörigen externen ID und der gekürzten Payload im Synchronisierungsprotokoll erfasst. |
| Datentyp | Über die Cloud-Datenaufnahme können Sie Nutzerattribute, angepasste Events, Kauf-Events, Anfragen zum Löschen von Nutzer:innen, Canvas-Trigger, Katalogartikel, Datenobjekte und Datenobjektbeziehungen synchronisieren. |
| Braze-Region | Dieses Produkt ist in allen Braze-Regionen verfügbar. Jede Braze-Region kann sich mit jeder Region der Quelldaten verbinden. |
| Quellregion | Braze verbindet sich mit Ihrem Data Warehouse oder Ihrer Cloud-Umgebung in jeder Region und bei jedem Cloud-Anbieter. |