Nutzerprofile nach Segment exportieren
/users/export/segment
Verwenden Sie diesen Endpunkt, um alle Nutzer:innen innerhalb eines Segments zu exportieren.
Wenn Sie diesen Endpunkt verwenden, beachten Sie Folgendes:
1. Das Feld fields_to_export in dieser API-Anfrage ist erforderlich.
2. Die Felder für custom_events, purchases, campaigns_received und canvases_received enthalten nur Daten der letzten 90 Tage.
Nutzerdaten werden als mehrere Dateien mit Nutzer-JSON-Objekten exportiert, die durch Zeilenumbrüche getrennt sind (z. B. ein JSON-Objekt pro Zeile). Die Daten werden an eine automatisch generierte URL oder an einen S3-Bucket exportiert, sofern diese Integration bereits eingerichtet ist.
Export-Ausgabeformat: Wenn ein Export erfolgreich war und Sie keine Zugangsdaten für den Cloud-Speicher konfiguriert haben, enthält die HTTP-Antwort eine URL zum Herunterladen eines komprimierten Archivs (ZIP- oder GZIP-Datei). Wenn Cloud-Speicher-Zugangsdaten (S3, Azure oder Google Cloud Storage) konfiguriert sind, schreibt Braze den Export direkt in Ihren Bucket, und die Antwort enthält keine Download-URL. Sollte der Export fehlschlagen, erhalten Sie stattdessen eine E-Mail-Benachrichtigung. Durch die Einrichtung von Zugangsdaten für den Cloud-Speicher verringert sich die Wahrscheinlichkeit von Fehlern bei umfangreichen Exporten.
Beachten Sie, dass ein Unternehmen über diesen Endpunkt zu einem bestimmten Zeitpunkt höchstens einen Export pro Segment durchführen kann. Warten Sie, bis Ihr Export abgeschlossen ist, bevor Sie es erneut versuchen.
Sie können das OpenAPI-Dokument herunterladen und damit Schemas validieren. Wie das geht, erfahren Sie unter OpenAPI-Schemas zur Validierung von Anfragen verwenden.