Exporter les données de segment au format CSV
Cette page explique comment demander une exportation CSV des données utilisateur d’un segment, ainsi que les données incluses dans l’exportation.
Les options d’exportation CSV apparaissent dans le menu déroulant User Data uniquement pour les utilisateurs de l’entreprise disposant de l’autorisation « Exporter les données utilisateur en CSV » pour cet espace de travail.
Pour exporter les données d’un segment vers un fichier CSV, sélectionnez le menu déroulant User Data lorsque vous modifiez un segment et choisissez d’exporter soit les données utilisateur, soit les adresses e-mail pour le segment.
Vous pouvez également demander une exportation CSV à partir de la page principale Segments en sélectionnant le menu déroulant Settings pour un segment :
Pour exporter les données de tous vos profils utilisateurs, créez un segment sans filtre, puis demandez une exportation CSV.
Le fichier CSV contient les données de chaque profil utilisateur capturé dans le segment au moment de l’exportation. Vous pouvez exporter n’importe quel segment en sélectionnant l’icône d’engrenage, puis l’exportation CSV. Braze génère le rapport en arrière-plan et l’envoie par e-mail à l’utilisateur actuellement connecté.
Détails de l’exportation CSV de segment
Les utilisateurs du tableau de bord doivent disposer de l’autorisation Exporter les données utilisateur pour utiliser les options d’exportation CSV. S’ils ne disposent pas de cette autorisation, les options d’exportation CSV n’apparaissent pas.
Exporter les adresses e-mail en CSV inclut uniquement les lignes des utilisateurs du segment qui possèdent une adresse e-mail. Par exemple, si votre segment contient 100 000 utilisateurs mais que seulement 50 000 ont une adresse e-mail, Exporter les adresses e-mail en CSV produit environ 50 000 lignes. Exporter les données utilisateur en CSV exporte toutes les données utilisateur du segment.
En raison des limites de taille de fichier, votre exportation peut échouer si la taille estimée de votre segment dépasse 500 000 utilisateurs. Notez que cette restriction est basée sur la taille estimée de votre segment, et non sur le calcul exact. Pour plus de détails, reportez-vous à la section Exporter des segments volumineux.
Si vous avez lié vos identifiants Amazon S3 à Braze, le fichier CSV sera téléchargé dans votre compartiment S3 sous la clé segment-export/SEGMENT_ID/YYYY-MM-dd/users-RANDOMSTRING.zip. Vous devez être connecté au tableau de bord pour accéder au lien de téléchargement qui vous a été envoyé par e-mail.
Les fichiers exportés stockés dans les compartiments S3 sont automatiquement supprimés après l’expiration du lien de téléchargement (quatre heures après l’envoi de l’e-mail d’exportation, sauf indication contraire).
Données incluses dans l’exportation
Les éléments suivants sont inclus dans votre exportation en fonction de votre sélection.
Exporter les données utilisateur en CSV
| Nom du champ | Description |
|---|---|
| Appboy ID | ID interne (non modifiable) |
| country | Pays |
| created_at | Date et heure de création du profil utilisateur |
| created_from | Méthode utilisée pour créer le profil utilisateur (par exemple, REST API, SDK ou importation CSV) |
| devices | Informations sur l’appareil |
| date_of_birth | Date de naissance |
| Adresse e-mail | |
| unsubscribed_from_emails_at | Date de désabonnement aux e-mails |
| user_id | ID externe |
| first_name | Prénom |
| first_session | Date et heure de la première session |
| gender | Genre |
| google_ad_ids | ID publicitaires Google associés à l’utilisateur |
| city | Ville |
| IDFAs | Valeurs de l’identifiant pour la publicité (IDFA) |
| IDFVs | Valeurs de l’identifiant du fournisseur (IDFV) |
| language | Langue dans la norme ISO-639-1 |
| last_app_version_used | Dernière version de l’application utilisée |
| last_name | Nom |
| last_session | Date et heure de la dernière session |
| number_of_google_ad_ids | Nombre d’ID publicitaires Google associés |
| number_of_IDFAs | Nombre d’IDFA associés |
| number_of_IDFVs | Nombre d’IDFV associés |
| number_of_push_tokens | Nombre de jetons de notification push associés |
| number_of_roku_ad_ids | Nombre d’ID publicitaires Roku associés |
| number_of_windows_ad_ids | Nombre d’ID publicitaires Windows associés |
| phone_number | Numéro de téléphone |
| opted_into_push_at | Date d’abonnement aux notifications push |
| unsubscribed_from_push_at | Date de désabonnement aux notifications push |
| random_bucket | Numéro de compartiment aléatoire |
| roku_ad_ids | ID publicitaires Roku |
| session_count | Nombre total de sessions |
| timezone | Fuseau horaire de l’utilisateur dans le même format que la base de données des fuseaux horaires de l’IANA |
| in_app_purchase_total | Montant total dépensé en achats in-app |
| user_aliases | Alias de l’utilisateur, le cas échéant |
| windows_ad_ids | ID publicitaires Windows |
| Custom events | En fonction de la sélection à l’exportation |
| Custom attributes | En fonction de la sélection à l’exportation |
Lorsque vous exportez les données utilisateur d’une étape Canvas, le fichier CSV inclut tous les utilisateurs qui sont passés par cette étape au cours de la durée de vie de l’étape Canvas. Vous ne pouvez pas limiter l’exportation à une plage de dates ou à une autre fenêtre temporelle. Pour savoir comment effectuer ces exportations, consultez Exporter les données Canvas.
Exporter les adresses e-mail en CSV
| Nom du champ | Description |
|---|---|
| user_id | ID externe de l’utilisateur |
| first_name | Prénom |
| last_name | Nom |
| unsubscribed_from_emails_at | Date de désabonnement aux e-mails |
| opted_in_to_emails_at | Date d’abonnement aux e-mails |
| user_aliases | Alias de l’utilisateur, le cas échéant |
Pour obtenir de l’aide sur les exportations CSV et API, consultez notre article de résolution des problèmes.
Exporter des segments volumineux
Il existe plusieurs méthodes pour exporter un segment d’utilisateurs volumineux contenant plus de 500 000 utilisateurs.
Vous pouvez diviser un segment volumineux en segments plus petits, puis exporter chacun d’entre eux depuis Braze.
Vous pouvez également utiliser des numéros de compartiment aléatoire pour diviser votre base d’utilisateurs en plusieurs segments, puis les combiner après l’exportation. Par exemple, si vous devez diviser votre segment en deux, vous pouvez le faire avec les filtres suivants :
- Segment 1 : le numéro de compartiment aléatoire est inférieur à 5 000 (inclut 0-4999)
- Segment 2 : le numéro de compartiment aléatoire est supérieur à 4999 (inclut 5000-9999)
Vous pouvez également tirer parti des endpoints suivants pour exporter les données utilisateur d’un segment spécifique. Notez que ces endpoints sont soumis à des limites de données.