Diese Seite wurde automatisch übersetzt und kann Ungenauigkeiten enthalten. Um einen Übersetzungsfehler zu melden, nutzen Sie das Feedback unten im Inhaltsverzeichnis rechts auf der Seite.

Fehlerbehebung beim Export

Verwenden Sie diese Seite, um CSV- und API-Exportprobleme im Dashboard und den Export-APIs zu diagnostizieren. Informationen zu Export-Workflows und -Limits finden Sie unter Segmentdaten als CSV exportieren und Export-APIs.

Hier starten: Symptom zuordnen

Suchen Sie in der Tabelle nach dem Verhalten, das Sie beobachten, und gehen Sie dann zum entsprechenden Abschnitt für gezielte Prüfungen.

Symptom	Gehe zu
CSV-Download-Link gibt `AccessDenied`, `ExpiredToken` oder „Datei existiert nicht“ zurück	Standardexport: CSV-Fehler oder Cloud-Speicher: CSV-Fehler
API-Export-Download-URL gibt `403 Forbidden` zurück	Exportierte Segment-ZIP kann nicht heruntergeladen werden
Segment-Export schlägt fehl oder meldet, dass das Segment zu groß ist	Segment ist zu groß
Keine E-Mail zum Segment-Export erhalten	Keine Segment-Export-E-Mail
CSV-Zeilenanzahl stimmt nicht mit Campaign-Analytics überein	Campaign- und Canvas-Analytics-Abweichung
Erwartete Spalten fehlen in der Exportdatei	Fehlende Spalten
Cloud-Speicher-Export zeigt `AccessDenied` oder `ExpiredToken`	Cloud-Speicher verbunden: API-Fehler

Standardmäßiger Untersuchungsweg

Verwenden Sie diesen Workflow für jeden Exportvorfall. Beginnen Sie bei Schritt 1.

Stellen Sie fest, ob Sie in den Standard-S3-Bucket von Braze oder einen verbundenen Cloud-Storage-Partner exportieren. Das Ablaufverhalten von Links und die Wiederholungslogik unterscheiden sich zwischen beiden Optionen.
Bestätigen Sie bei Dashboard-CSV-Exporten, dass Sie bei Braze angemeldet sind, wenn Sie den Download-Link öffnen. Links zum Standard-Bucket erfordern eine aktive Dashboard-Sitzung.
Prüfen Sie, wie lange der Export bereits abgeschlossen ist. Per E-Mail versendete Dashboard-Download-Links laufen nach vier Stunden ab – unabhängig davon, ob Sie den Standard-Bucket von Braze oder einen verbundenen Storage-Partner verwenden. Wenn ein Storage-Partner verbunden ist, liefert Braze zusätzlich eine Kopie in Ihren Bucket. Diese Kopie unterliegt Ihren Aufbewahrungsrichtlinien und kann auch nach Ablauf des E-Mail-Links noch verfügbar sein.
Bestätigen Sie bei großen Segment-Exporten, dass die Zielgruppe unter dem Dashboard-CSV-Exportlimit von 500.000 Nutzer:innen liegt. Schätzungen im Segment Builder können von der Auswertung in der Export-Pipeline abweichen.
Warten Sie bei API-Exporten, bis die Verarbeitung abgeschlossen ist, bevor Sie den Download starten. Verwenden Sie callback_endpoint bei /users/export/segment oder führen Sie Abfragen mit exponentiellem Backoff durch, anstatt die URL sofort anzufordern.
Wenn Sie weiterhin blockiert sind, wenden Sie sich an den Braze-Support und geben Sie den Exporttyp (CSV oder API), die Segment- oder Campaign-ID, den Zeitstempel (mit Zeitzone) und die genaue Fehlermeldung an.

Speicherziele

Verwenden Sie die Tabs, um auszuwählen, ob Sie in den Standard-S3-Bucket von Braze oder zu einem Cloud-Speicher-Partner exportieren. Für Anleitungen zum Cloud-Speicher öffnen Sie den Tab Cloud-Speicher verbunden und lesen Sie die Abschnitte zu CSV und API.

default export
cloud storage connected

Wenn Sie keinen Speicherpartner als Standard-Exportziel festgelegt haben, verwendet Braze seinen eigenen Amazon S3-Bucket, um Ihre Exportdateien zu speichern. Die Dateien in dieser Konfiguration sind temporär und verfallen nach vier Stunden.

CSV-Exporte

Symptom: Eine E-Mail zum Dashboard-CSV-Export trifft ein, aber der Download-Link funktioniert nicht, oder der Export wird nicht abgeschlossen.

Wenn Sie eine CSV-Datei aus dem Dashboard exportieren, sendet Braze einen Download-Link per E-Mail an die angemeldete Nutzer:in. Dieser Link verweist auf eine ZIP-Datei, die im S3-Bucket von Braze gehostet wird. Die ZIP-Datei enthält mehrere kleinere Dateien, die zusammen Ihren Export bilden.

Sie müssen im Braze-Dashboard angemeldet sein, um den Link nutzen zu können, und die Datei ist nur vier Stunden lang verfügbar. Danach ist der Link nicht mehr funktionsfähig und die Daten werden gelöscht. Sollten bei sehr umfangreichen Exporten (über 500.000 Nutzer:innen) wiederholt Fehler auftreten, kann der Export fehlschlagen. In diesem Fall empfehlen wir, den Export in kleinere Gruppen oder Felder aufzuteilen oder die Einrichtung eines Speicherpartners in Betracht zu ziehen.

Häufige Fehler

Wenn Sie einen AccessDenied-Fehler sehen, ist die Datei möglicherweise bereits abgelaufen, oder Sie haben versucht, sie zu öffnen, bevor sie bereit war. Größere Berichte benötigen mehr Zeit für die Erstellung – warten Sie einige Minuten und versuchen Sie es erneut.
Ein ExpiredToken-Fehler bedeutet, dass das vierstündige Zeitfenster abgelaufen ist. Führen Sie den Export erneut aus, um einen neuen Link zu generieren.
Die Nachricht Looks like the file doesn't exist anymore wird in der Regel angezeigt, wenn die E-Mail gesendet wurde, die Datei jedoch noch nicht vollständig auf S3 hochgeladen wurde. In der Regel lässt sich das Problem durch einige Minuten Wartezeit beheben.
Apostrophe am Anfang bestimmter Felder (wie -, =, + oder @) sind erwartetes Verhalten. Beispielsweise wird -1943 in der CSV-Datei zu '-1943. Braze tut dies, um zu verhindern, dass Tabellenkalkulationsprogramme die Daten falsch interpretieren. Dies gilt nicht für JSON-Exporte, wie sie etwa vom Endpunkt /users/export/segment zurückgegeben werden.

API-Exporte

Symptom: Ein Export-API-Aufruf ist erfolgreich, aber die Download-URL funktioniert nicht oder gibt leere Daten zurück.

Wenn Sie über die Export-APIs ohne Cloud-Speicher exportieren, speichert Braze die Dateien in seinem S3-Bucket. Sie erhalten keine E-Mail – stattdessen enthält die API-Antwort eine temporäre Download-URL. Der Export erfolgt als ZIP-Datei, die mehrere JSON-Dateien enthält, wobei jede Datei eine Nutzer:in pro Zeile enthält.

Wie bei CSV-Exporten verfallen auch Links aus der API nach vier Stunden. Wenn Sie den Link zu früh öffnen, können Fehler auftreten, da die Datei noch nicht bereit ist. Sie können in Ihrer Anfrage einen callback_endpoint angeben, falls Sie von Braze benachrichtigt werden möchten, sobald die Datei verfügbar ist.

Umfangreiche API-Exporte können ebenfalls zu Zeitüberschreitungen führen. Sollte dies der Fall sein, versuchen Sie, kleinere Anfragen zu stellen, oder verbinden Sie einen Speicherpartner, um das Volumen zu bewältigen.

Häufige Fehler

AccessDenied oder ExpiredToken bedeutet in der Regel, dass der Link abgelaufen oder noch nicht verfügbar war. Führen Sie den Export erneut durch oder warten Sie etwas länger.

Wenn Sie einen Speicherpartner (wie Amazon S3, Google Cloud Storage oder Azure Blob) verbinden und ihn auf der Seite Technologie-Partner im Dashboard als Ihr Standard-Exportziel markieren, schreibt Braze Ihre Exporte direkt in Ihren Bucket. Diese Konfiguration ist in der Regel für umfangreichere Exporte zuverlässiger.

CSV-Exporte

Symptom: Der per E-Mail versandte CSV-Link funktioniert nicht, aber Dateien erscheinen (oder erscheinen nicht) in Ihrem verbundenen Bucket.

Bei CSV-Exporten sendet Ihnen Braze einen Download-Link per E-Mail. Dieser Link läuft nach einer kurzen Zeitspanne ab (in der Regel nach etwa vier Stunden). Wenn Sie einen Speicherpartner verbunden und als Standard-Exportziel festgelegt haben, liefert Braze auch eine Kopie des Exports an Ihren verbundenen Bucket. Diese Kopie wird in Ihrer eigenen Infrastruktur gespeichert, wobei Ablauf und Aufbewahrung Ihren Speicherrichtlinien entsprechen.

Im Cloud-Speicher werden CSV-Exporte in einer ZIP-Datei gebündelt. Die ZIP-Datei enthält mehrere kleinere CSV-Dateien. Umfangreiche Exporte werden häufig in Teile aufgeteilt (beispielsweise jeweils etwa 5.000 Nutzer:innen), wobei die Größe der Teile variieren kann. Kleinere Dateien bedeuten nicht, dass Daten fehlen. Sollte der per E-Mail versandte Link nicht funktionieren, die Kopie in Ihrem Speicher jedoch erfolgreich sein, können Sie Ihre Daten jederzeit direkt aus Ihrem Bucket abrufen.

Häufige Fehler

AccessDenied bedeutet, dass Braze nicht in Ihren Bucket schreiben konnte. Überprüfen Sie, ob Ihre Zugangsdaten und Berechtigungen weiterhin gültig sind.
ExpiredToken wird angezeigt, wenn Braze den Zugriff auf Ihren Bucket verloren hat. Aktualisieren Sie Ihre Zugangsdaten im Braze-Dashboard.
Sollten einige Dateien kleiner als erwartet erscheinen, ist dies normales Verhalten. Der Exportvorgang teilt Dateien aus Stabilitätsgründen absichtlich auf.
Apostrophe am Anfang bestimmter Felder (wie -, =, + oder @) sind erwartetes Verhalten. Beispielsweise wird -1943 in der CSV-Datei zu '-1943. Braze tut dies, um zu verhindern, dass Tabellenkalkulationsprogramme die Daten falsch interpretieren. Dies gilt nicht für JSON-Exporte, wie sie etwa vom Endpunkt /users/export/segment zurückgegeben werden.

API-Exporte

Symptom: API-Exporte erscheinen nicht in Ihrem Bucket oder Dateien sind unvollständig.

Wenn Sie Daten über die APIs mit einem verbundenen Speicherpartner exportieren, werden die Exportdateien in Ihren Bucket geschrieben. Es wird keine E-Mail versendet. Die zugrunde liegenden Objekte werden in Ihrem Speicher aufbewahrt und unterliegen Ihren Aufbewahrungseinstellungen, auch wenn die von Braze zurückgegebenen Download-URLs möglicherweise weiterhin zeitlich begrenzt sind.

Dateien erscheinen in der Regel in Ihrem Bucket, während der Export läuft, sodass Sie nicht warten müssen, bis der gesamte Vorgang abgeschlossen ist, bevor Sie auf Teilergebnisse zugreifen. Braze lädt jeden abgeschlossenen Batch inkrementell hoch, anstatt alles bis zum Ende zurückzuhalten. Umfangreiche Exporte werden in mehrere komprimierte Dateien (ZIP oder GZIP) aufgeteilt, die jeweils JSON-Objekte enthalten, eines pro Zeile. Das macht diese Methode für umfangreiche Exporte zuverlässiger.

Häufige Fehler

AccessDenied tritt auf, wenn Braze nicht in Ihren Bucket schreiben kann oder die Objekte anschließend gelöscht wurden. Überprüfen Sie die Berechtigungen und stellen Sie sicher, dass keine externen Prozesse Dateien löschen.
ExpiredToken bedeutet, dass die Zugangsdaten von Braze für Ihren Bucket veraltet sind. Aktualisieren Sie diese im Dashboard.
Sollten Dateien fehlen oder kleiner als erwartet sein, überprüfen Sie zunächst, ob Objekte außerhalb von Braze gelöscht werden. Kleinere Dateigrößen selbst sind erwartetes Verhalten.

Campaign- und Canvas-Analytics

Die Nutzer:innenanzahl im CSV-Export stimmt nicht mit Gesendete Nachrichten oder Eindeutige Empfänger:innen überein

Symptom: Der CSV-Export einer Campaign zeigt eine andere Nutzer:innenanzahl als Gesendete Nachrichten oder Eindeutige Empfänger:innen auf der Analytics-Seite.

Der CSV-Export einer Campaign kann aus folgenden Gründen eine andere Nutzer:innenanzahl anzeigen als Gesendete Nachrichten und Eindeutige Empfänger:innen:

Erneute Berechtigung ist aktiviert

Wenn Nutzer:innen die Campaign mehr als einmal erhalten können (oder dies zu einem früheren Zeitpunkt konnten), stimmen die Campaign-Analytics-Zahlen und die Anzahl der Zeilen im Nutzerdaten-Export nicht überein. Gesendete Nachrichten zählt jeden Versand, auch wenn dieselbe Person die Nachricht mehrfach erhalten hat. Der Download CSV-Export Nutzerdaten listet eindeutige Nutzer:innen auf – eine Zeile pro Profil, das die Campaign erhalten hat – nicht eine Zeile pro Versand. Wenn Gesendete Nachrichten beispielsweise 12 beträgt und die CSV-Datei 10 Zeilen enthält, wurden diese 12 Sendungen an 10 verschiedene Nutzer:innen gesendet (einige Nutzer:innen haben die Campaign mehr als einmal erhalten).

Nutzer:innen wurden seit dem Versand der Campaign oder des Canvas gelöscht oder zusammengeführt

Der CSV-Export liefert eine Momentaufnahme der vorhandenen Nutzer:innen, die eine bestimmte Campaign oder einen bestimmten Canvas erhalten haben. Da Nutzer:innen gelöscht oder zusammengeführt werden können, kann die Anzahl im CSV-Export niedriger sein als die Anzahl der eindeutigen Empfänger:innen. Wenn beispielsweise 1.000 Nutzer:innen eine Campaign erhalten, zeigt die Campaign 1.000 eindeutige Empfänger:innen an, und der CSV-Export am selben Tag enthält ebenfalls 1.000 Nutzer:innen. Wenn einen Monat später 50 dieser 1.000 Nutzer:innen gelöscht werden, enthält der CSV-Export 950 Nutzer:innen, während die inkrementierte Anzahl eindeutiger Empfänger:innen weiterhin 1.000 beträgt.

Dashboard-Segment-Export-E-Mails

Segment ist zu groß oder Export schlägt fehl, obwohl mein Segment unter 500.000 Nutzer:innen zu haben scheint

Symptom: Der Dashboard-Segment-Export schlägt fehl oder zeigt einen Größenfehler an, obwohl die Segment-Schätzung akzeptabel aussieht.

Die Segment-Größe im Dashboard ist eine Schätzung. Der CSV-Export verwendet diese Schätzung, um das Exportlimit von 500.000 Nutzer:innen durchzusetzen; die Export-Pipeline kann die Größe außerdem anders bewerten als die Segment-Builder-UI. Wenn Exporte für ein Segment nahe diesem Schwellenwert fehlschlagen, verwenden Sie zufällige Bucket-Nummern, teilen Sie die Zielgruppe in kleinere Segmente auf oder nutzen Sie den /users/export/segment-Endpunkt, wie unter Große Segmente exportieren beschrieben.

Warum erhalte ich keine Segment-Export-E-Mails?

Symptom: Ein Segment-CSV-Export wurde ausgelöst, aber es ist keine E-Mail angekommen.

Überprüfen Sie zunächst Ihren Spam-Ordner auf eine E-Mail von [email protected]. Falls die E-Mail dort ist, fügen Sie diese Adresse zu Ihrer Liste sicherer Absender hinzu, damit zukünftige Export-Nachrichten nicht gefiltert werden.

Falls die E-Mail nicht in Ihrem Spam-Ordner ist, prüfen Sie, ob eine andere Person in Ihrem Team den Export erhalten kann. Falls nicht, berücksichtigen Sie die Größe Ihres Exports. Die Zustellzeit variiert je nach Exportgröße. Wenn die E-Mail aber nach einer Stunde noch nicht angekommen ist, wenden Sie sich an den Support.

Segment-Export-API-Downloads

Exportierte Segment-ZIP-Datei kann nicht von einer Braze-URL heruntergeladen werden

Symptom: Ein 403 Forbidden-Fehler beim Herunterladen von der /users/export/segment-Antwort-URL.

Wenn Sie beim Verwenden des /users/export/segment-Endpunkts einen 403 Forbidden-Fehler erhalten, ist die Datei möglicherweise noch nicht bereit. Große Exporte können eine Weile dauern. Warten Sie bis zu einer Stunde, bevor Sie den Download erneut versuchen.

Wenn Sie ein automatisiertes Skript zum Abrufen der Datei verwenden, erhalten Sie möglicherweise ebenfalls einen 403 Forbidden-Fehler, wenn Sie die URL zu früh anfordern. Falls Sie regelmäßig Segmentdaten exportieren, sollten Sie Ihre eigene S3-Bucket-Integration anbinden und die Dateien in Ihre eigene ETL-Pipeline (ETL) einspeisen.

Exporte benötigen Zeit, daher schlägt ein sofortiger Zugriff über ein Skript häufig fehl. Sie können:

Die Download-URL mit exponentiellem Backoff abfragen, oder
Den callback_endpoint-Parameter verwenden und auf einen Dienst verweisen, der Ihr Skript ausführt, sobald der Export bereit ist.

Segment- und Nutzer:innen-Export-API-Felder

Erwartete Spalten fehlen in einer Segment-Exportdatei

Symptom: Bei einem API- oder Dashboard-Export fehlen Felder, die Sie erwartet haben.

Der Dashboard-Export CSV Export User Data aus einem Segment verwendet einen festen Spaltensatz (siehe Segmentdaten als CSV exportieren). Er enthält weder eine fields_to_export-Spalte noch einen entsprechenden Parameter.

Für API-Segment-Exporte müssen Sie fields_to_export im Anfrage-Body übergeben. Einige Felder ziehen automatisch zugehörige Daten mit ein – wenn Sie beispielsweise canvases_received anfordern, werden auch Journey-Zusammenfassungsdaten im Kundenprofil benötigt. In der Endpunkt-Referenz unter /users/export/segment finden Sie gültige Feldnamen und Anforderungen.

Falls in einem API-Export-ZIP Spalten fehlen, prüfen Sie, ob das fields_to_export-Array in Ihrer Anfrage jedes benötigte Feld enthält und ob Ihr Workspace über die erforderlichen Exportberechtigungen verfügt.

Wann Sie den Support kontaktieren sollten

Kontaktieren Sie den Braze-Support, wenn Sie den standardmäßigen Untersuchungspfad abgeschlossen haben und weiterhin Hilfe benötigen. Geben Sie den Exporttyp, die Segment- oder Campaign-ID, den Zeitstempel (mit Zeitzone) sowie die genaue Fehlermeldung oder den HTTP-Statuscode an.

New Stuff!