Segmentdaten nach CSV exportieren
Auf dieser Seite erfahren Sie, wie Sie einen CSV-Export von Nutzerdaten eines Segments anfragen können und welche Daten im Export enthalten sind.
CSV-Exportoptionen werden im Dropdown-Menü User Data nur für Unternehmensnutzer:innen angezeigt, die über die Berechtigung „Nutzerdaten exportieren“ für diesen Workspace verfügen.
Um Segmentdaten in eine CSV-Datei zu exportieren, wählen Sie bei der Bearbeitung eines Segments das Dropdown-Menü User Data aus und wählen Sie, ob Sie die Nutzerdaten oder die E-Mail-Adressen für das Segment exportieren möchten.
Sie können einen CSV-Export auch von der Hauptseite Segments aus anfragen, indem Sie das Dropdown-Menü Settings für ein Segment auswählen:
Um Daten aus all Ihren Nutzerprofilen zu exportieren, erstellen Sie ein Segment ohne Filter und fragen dann einen CSV-Export an.
Die CSV-Ausgabe enthält die Daten der einzelnen Nutzerprofile, die zum Zeitpunkt des Exports im Segment erfasst wurden. Sie können jedes Segment exportieren, indem Sie das Zahnradsymbol und den CSV-Export auswählen. Braze erstellt den Bericht im Hintergrund und sendet ihn per E-Mail an die Person, die gerade angemeldet ist.
Details zum Segment-CSV-Export
Dashboard-Nutzer:innen benötigen die Berechtigung Nutzerdaten exportieren, um CSV-Exportoptionen verwenden zu können. Wenn sie diese Berechtigung nicht haben, werden die CSV-Exportoptionen nicht angezeigt.
E-Mail-Adressen als CSV exportieren enthält nur Zeilen für Nutzer:innen im Segment, die eine E-Mail-Adresse haben. Wenn Ihr Segment beispielsweise 100.000 Nutzer:innen umfasst, aber nur 50.000 eine E-Mail-Adresse haben, erzeugt E-Mail-Adressen als CSV exportieren etwa 50.000 Zeilen. Nutzerdaten als CSV exportieren exportiert alle Nutzerdaten für das Segment.
Aufgrund von Dateigrößenbeschränkungen kann Ihr Export fehlschlagen, wenn die geschätzte Größe Ihres Segments über 500.000 Nutzer:innen liegt. Beachten Sie, dass diese Einschränkung die geschätzte Größe Ihres Segments verwendet und nicht die genaue Berechnung. Weitere Einzelheiten finden Sie unter Exportieren großer Segmente.
Wenn Sie Ihre Amazon S3-Anmeldedaten mit Braze verknüpft haben, wird die CSV stattdessen in Ihrem S3-Bucket unter dem Schlüssel segment-export/SEGMENT_ID/YYYY-MM-dd/users-RANDOMSTRING.zip hochgeladen. Sie müssen im Dashboard eingeloggt sein, um auf den Download-Link zuzugreifen, der Ihnen per E-Mail zugesandt wurde.
In S3-Buckets gespeicherte Exportdateien werden automatisch gelöscht, sobald der Download-Link abläuft (vier Stunden nach Versand der Export-E-Mail, sofern nicht anders angegeben).
Im Export enthaltene Daten
Abhängig von Ihrer Auswahl ist Folgendes in Ihrem Export enthalten.
Nutzerdaten als CSV exportieren
| Feldname | Beschreibung |
|---|---|
| Appboy ID | Interne ID (kann nicht geändert werden) |
| country | Land |
| created_at | Datum und Uhrzeit, zu der das Nutzerprofil erstellt wurde |
| created_from | Methode, mit der das Nutzerprofil erstellt wurde (z. B. REST API, SDK oder CSV-Import) |
| devices | Informationen zum Gerät |
| date_of_birth | Geburtsdatum |
| E-Mail-Adresse | |
| unsubscribed_from_emails_at | Datum der Abmeldung von E-Mails |
| user_id | Externe ID |
| first_name | Vorname |
| first_session | Datum und Uhrzeit der ersten Sitzung |
| gender | Geschlecht |
| google_ad_ids | Mit den Nutzer:innen verknüpfte Google-Werbe-IDs |
| city | Ort |
| IDFAs | Identifier for Advertisers (IDFA)-Werte |
| IDFVs | Identifier for Vendors (IDFV)-Werte |
| language | Sprache im ISO-639-1-Standard |
| last_app_version_used | Zuletzt verwendete Version der App |
| last_name | Nachname |
| last_session | Datum und Uhrzeit der letzten Sitzung |
| number_of_google_ad_ids | Anzahl der zugehörigen Google-Werbe-IDs |
| number_of_IDFAs | Anzahl der zugehörigen IDFAs |
| number_of_IDFVs | Anzahl der zugehörigen IDFVs |
| number_of_push_tokens | Anzahl der zugehörigen Token für Push-Benachrichtigungen |
| number_of_roku_ad_ids | Anzahl der zugehörigen Roku-Werbe-IDs |
| number_of_windows_ad_ids | Anzahl der zugehörigen Windows-Werbe-IDs |
| phone_number | Telefonnummer |
| opted_into_push_at | Datum des Opt-in für Push-Benachrichtigungen |
| unsubscribed_from_push_at | Datum der Abmeldung von Push-Benachrichtigungen |
| random_bucket | Zufällige Bucket-Nummer |
| roku_ad_ids | Roku-Werbe-IDs |
| session_count | Gesamtzahl der Sitzungen |
| timezone | Zeitzone der Nutzer:innen im gleichen Format wie in der IANA-Zeitzonendatenbank |
| in_app_purchase_total | Gesamtbetrag, der für In-App-Käufe ausgegeben wurde |
| user_aliases | Nutzer-Aliase, falls vorhanden |
| windows_ad_ids | Windows-Werbe-IDs |
| Custom events | Basierend auf der Auswahl beim Export |
| Custom attributes | Basierend auf der Auswahl beim Export |
Wenn Sie Nutzerdaten aus einem Canvas-Schritt exportieren, enthält die CSV alle Nutzer:innen, die sich im Laufe der Lebensdauer des Canvas-Schritts in diesem Schritt befunden haben. Sie können den Export nicht auf einen Datumsbereich oder ein anderes Zeitfenster beschränken. Informationen zur Durchführung dieser Exporte finden Sie unter Canvas-Daten exportieren.
E-Mail-Adressen als CSV exportieren
| Feldname | Beschreibung |
|---|---|
| user_id | Externe ID der Nutzer:innen |
| first_name | Vorname |
| last_name | Nachname |
| unsubscribed_from_emails_at | Datum der Abmeldung von E-Mails |
| opted_in_to_emails_at | Datum des Opt-in für E-Mails |
| user_aliases | Nutzer-Aliase, falls vorhanden |
Hilfe zu CSV- und API-Exporten finden Sie in unserem Artikel zur Fehlerbehebung.
Abo-Gruppendaten sind über Segment-Exporte nicht verfügbar. Um Nutzer:innen nach Abo-Status zu identifizieren, erstellen Sie ein separates Segment basierend auf der Zugehörigkeit zur Abo-Gruppe und exportieren Sie dieses Segment.
Exportieren großer Segmente
Es gibt mehrere Methoden, um ein großes Segment mit mehr als 500.000 Nutzer:innen zu exportieren.
Sie können ein großes Segment in kleinere Segmente aufteilen und dann jedes der kleineren Segmente aus Braze exportieren.
Sie können auch zufällige Bucket-Nummern verwenden, um Ihre Nutzerbasis in mehrere Segmente aufzuteilen, die Sie dann nach dem Export kombinieren können. Wenn Sie zum Beispiel Ihr Segment in zwei verschiedene Segmente aufteilen möchten, können Sie dies mit den folgenden Filtern tun:
- Segment 1: Zufällige Bucket-Nummer ist kleiner als 5000 (umfasst 0–4999)
- Segment 2: Zufällige Bucket-Nummer ist größer als 4999 (umfasst 5000–9999)
Sie können auch die folgenden Endpunkte nutzen, um Nutzerdaten für ein bestimmtes Segment zu exportieren. Beachten Sie, dass für diese Endpunkte Datenbeschränkungen und Rate-Limits gelten.
Wenn Sie Ihre Amazon S3-Anmeldedaten verknüpft haben, können große Exporte zusätzlich zum per E-Mail versendeten Download-Link in Ihren Bucket übertragen werden, wie unter Details zum Segment-CSV-Export beschrieben.