Skip to content

Importation CSV

Veuillez découvrir comment enregistrer et mettre à jour les attributs utilisateur et les événements personnalisés à l’aide de l’importation CSV.

À propos de l’importation CSV

Vous pouvez utiliser l’importation CSV pour enregistrer et mettre à jour les événements personnalisés et les attributs utilisateurs suivants.

Utilisation de l’importation CSV

Étape 1 : Veuillez télécharger un modèle CSV.

Pour ouvrir l’importation CSV, veuillez vous rendre dans Audiences > Importer des utilisateurs. Vous trouverez ici un tableau répertoriant les détails des importations les plus récentes, tels que la date de téléchargement, le nom de la personne qui a effectué le téléchargement, le nom du fichier, la disponibilité du ciblage, le nombre de lignes importées et le statut de l’importation.

Pour vous aider à démarrer avec votre fichier CSV, veuillez télécharger un modèle pour les attributs ou les événements.

La page "Importation d'utilisateurs" du tableau de bord de Braze.

Étape 2 : Veuillez sélectionner un identifiant

Le fichier CSV que vous importez nécessitera un identifiant spécifique. Vous avez le choix entre les options suivantes :

Lors de l’importation de vos données clients, vous pouvez utiliser un identifiantexternal_id unique pour chaque client. Lorsque vous fournissez un identifiantexternal_iddans votre importation d’utilisateurs, Braze met à jour tout utilisateur existant avec le mêmeexternal_ididentifiant ou crée un nouvel utilisateur identifié avec cetexternal_ididentifiant défini si aucun n’est trouvé.

Pour cibler les utilisateurs qui ne disposent pas d’un compteexternal_id, il est possible d’importer une liste d’utilisateurs avec leurs pseudonymes. Un pseudonyme sert d’identifiant utilisateur unique alternatif et peut être utile si vous souhaitez cibler des utilisateurs anonymes qui ne se sont pas inscrits ou n’ont pas créé de compte sur votre application.

Si vous téléchargez ou mettez à jour des profils d’utilisateur qui sont alias uniquement, vous devez avoir les deux colonnes suivantes dans votre CSV :

  • user_alias_name : Un identifiant unique de l’utilisateur ; une alternative à l’identifiant de l’utilisateur. external_id
  • user_alias_label : Une étiquette commune permettant de regrouper les alias utilisateurs.

Lorsque vous fournissez à la fois unuser_alias_name et unuser_alias_label dans votre importation d’utilisateurs, Braze met à jour tout utilisateur existant avec le mêmeuser_alias_name et le mêmeuser_alias_label . Si aucun utilisateur n’est trouvé, Braze crée un nouvel utilisateur identifié avec cetuser_alias_nameensemble.

Télécharger : Modèle d’importation des attributs CSV : Alias d’utilisateur

Pour mettre à jour les profils utilisateurs existants dans Braze en utilisant une valeur ID interne de Braze au lieu d’une valeur external_id ou user_alias_name et user_alias_label, spécifiez braze_id comme en-tête de colonne.

Cela peut s’avérer utile si vous avez exporté des données d’utilisateurs de Braze via notre option d’exportation CSV dans le cadre de la segmentation et que vous souhaitez ajouter un nouvel attribut personnalisé à ces utilisateurs existants.

Vous pouvez omettre un ID externe ou un alias utilisateur et utiliser une adresse e-mail ou un numéro de téléphone pour importer des utilisateurs. Avant d’importer un fichier CSV contenant des adresses e-mail ou des numéros de téléphone, vérifiez les points suivants :

  • Vérifiez que vous n’avez pas d’ID externe ou d’aliasing de l’utilisateur pour ces profils dans votre fichier CSV. Si vous le faites, Braze utilisera en priorité l’ID externe ou l’alias d’utilisateur avant l’adresse e-mail pour identifier les profils.
  • Confirmez que votre fichier CSV est correctement formaté.

Si un profil existant contient cette adresse e-mail ou ce numéro de téléphone, ce profil est mis à jour et Braze ne crée pas de nouveau profil. S’il existe plusieurs profils avec la même adresse e-mail, Braze utilisera la même logique que l’endpoint/users/track où le profil le plus récemment mis à jour sera mis à jour.

Si aucun profil n’existe avec cette adresse e-mail ou ce numéro de téléphone, Braze crée un nouveau profil avec cet identifiant. Vous pouvez utiliser l’endpoint/users/identify pour identifier ce profil ultérieurement. Pour supprimer un profil utilisateur, vous pouvez également utiliser l’enpoint /users/delete.

Étape 3 : Veuillez créer votre fichier CSV.

Vous pouvez télécharger l’un des types de données suivants sous forme de fichier CSV unique. Pour télécharger plusieurs types de données, veuillez télécharger plusieurs fichiers CSV.

  • Attributs utilisateur : Cela inclut à la fois les attributs utilisateur par défaut et personnalisés. Les attributs utilisateur par défaut sont des clés réservées dans Braze (telles quefirst_nameou email) et les attributs personnalisés sont des attributs utilisateur uniques à votre entreprise (tels que last_destination_searched).
  • Événements personnalisés : Ces paramètres sont uniques à votre entreprise et reflètent les actions effectuées par un utilisateur, par exempletrip_bookedpour une application de réservation de voyages.

Lorsque vous êtes prêt à commencer à créer votre fichier CSV, veuillez vous référer aux informations suivantes :

Identifiants requis

Bien queexternal_idcela ne soit pas obligatoire, il est nécessaire d’inclure l’un des identifiants suivants en tant qu’en-tête dans votre fichier CSV. Pour plus de détails sur chacun d’entre eux, veuillez consulter la section Choisir un identifiant.

  • external_id
  • braze_id
  • user_alias_name et user_alias_label
  • email
  • phone

Attributs personnalisés

Les types de données suivants peuvent être utilisés comme attributs personnalisés pour l’importation CSV. Les en-têtes de colonne qui ne correspondent pas exactement à un attribut par défaut sont importées en tant qu’attributs personnalisés dans Braze.

Attributs par défaut

Les attributs par défaut suivants sont disponibles pour l’importation d’utilisateurs.

Mise à jour du statut du groupe d’abonnement (facultatif)

De plus, vous pouvez ajouter des utilisateurs à des groupes d’abonnement par e-mail ou SMS via l’importation d’utilisateurs. Ceci est particulièrement utile pour les SMS, car un utilisateur doit être inscrit dans un groupe d’abonnement SMS pour recevoir des messages avec le canal de communication SMS. Pour plus d’informations, consultez Groupes d’abonnement SMS.

Si vous mettez à jour les statuts du groupe d’abonnement, les deux colonnes suivantes doivent figurer dans votre fichier CSV :

  • subscription_group_id : Le site id du groupe d’abonnement.
  • subscription_state : Les valeurs disponibles sont unsubscribed (pas dans le subscription groups) ou subscribed (dans le subscription groups).

Identifiants requis

Bien queexternal_idcela ne soit pas obligatoire, il est nécessaire d’inclure l’un des identifiants suivants en tant qu’en-tête dans votre fichier CSV. Pour plus de détails sur chacun d’entre eux, veuillez consulter la section Choisir un identifiant.

  • external_id
  • braze_id
  • user_alias_name et user_alias_label
  • email
  • phone

Événements personnalisés

En plus des éléments suivants, votre fichier CSV peut également contenir des en-têtes de colonnes supplémentaires pour les propriétés d’événement. Ces propriétés doivent comporter un en-tête de colonne intitulé <event_name>.properties.<property name>.

Par exemple, l’événement personnalisétrip_booked peut avoir les propriétésdestinationet duration. Ces données peuvent être importées en utilisant les en-têtes de colonnetrip_booked.properties.destination et trip_booked.properties.duration.

Étape 4 : Veuillez télécharger votre fichier

Pour télécharger votre fichier, veuillez sélectionner Attributs ou Événements, cliquer sur Parcourir les fichiers, puis télécharger votre fichier CSV. Braze affiche un aperçu des premières lignes et un résumé des champs détectés.

La fenêtre modale/boîte de dialogue modale, etc. indiquant que le téléchargement est terminé affiche un aperçu du fichier, le champ de nom d'importation, les préférences de ciblage et la case à cocher de validation du fichier.

Dans le champ Nom de l’importation, vous pouvez renommer votre importation. Par défaut, le nom du fichier est utilisé.

Étape 5 : Veuillez vérifier votre fichier (facultatif)

Avant de procéder à l’importation, il est possible d’effectuer une validation des fichiers afin de vérifier chaque ligne à la recherche d’erreurs et d’avertissements. Pour valider votre fichier, veuillez sélectionner Valider le fichier avant l’importation, puis cliquer sur Démarrer l’importation.

La validation peut prendre jusqu’à 2 minutes pour les fichiers dont la taille est à la limite autorisée. Pendant l’exécution de la validation, vous pouvez sélectionner Ignorer la validation pour la contourner et continuer immédiatement.

Résultats de la validation

Une fois la validation terminée, l’un des résultats suivants s’affiche.

La boîte de dialogue « Problèmes détectés » affiche le nombre de lignes contenant des erreurs et des avertissements, avec des options permettant d'annuler, de télécharger le rapport d'erreurs ou de procéder à l'importation malgré tout.

Comprendre le rapport d’erreurs

Le rapport d’erreurs est un fichier CSV qui contient toutes les lignes signalées, ainsi que leurs données d’origine et une description du problème.

Après avoir examiné le rapport, vous pouvez corriger les problèmes dans votre fichier d’origine et le télécharger à nouveau, ou procéder à l’importation et accepter les résultats partiels.

Étape 6 : Sélectionnez vos préférences de ciblage

Vous pouvez également sélectionner parmi les préférences de ciblage suivantes. Si vous n’avez pas besoin de créer un nouveau filtre de ciblage ou segment à partir de votre importation, veuillez sélectionner Ne pas rendre cette liste disponible en tant que filtre de ciblage.

Un groupe de filtres avec le filtre « Mis à jour/Importé depuis CSV » comprenant un fichier CSV intitulé « Plaisirs de la saison d'Halloween ».

Étape 7 : Veuillez commencer l’importation CSV.

Lorsque vous êtes prêt, veuillez cliquer sur « Commencer l’importation ». Vous pouvez suivre la progression actuelle sur la page Importer des utilisateurs, qui s’actualise automatiquement toutes les 5 secondes.

Statuts d’importation

Une fois l’importation lancée, vous pouvez vérifier son statut sur la page Importer des utilisateurs.

La page de l'importation d'utilisateurs affiche un statut de réussite partielle avec le menu contextuel ouvert, présentant les options Télécharger le rapport d'erreurs et Télécharger le fichier CSV téléchargé.

Le rapport d’erreurs post-importation inclut les lignes qui ont échoué pour des raisons non couvertes par la validation, par exemple lorsqu’un utilisateur n’existe pas dans Braze.

Considérations relatives aux points de données

Chaque donnée client importée à partir d’un fichier CSV remplace la valeur existante dans les profils utilisateurs et enregistre un point de donnée, à l’exception des ID externes et des valeurs vides. Si vous avez des questions concernant les subtilités des points de donnée Braze, votre gestionnaire de compte Braze se fera un plaisir d’y répondre.

Résolution des problèmes

Si vous avez utilisé la validation des fichiers, veuillez commencer par consulter le rapport d’erreurs. Il contient le problème spécifique pour chaque ligne signalée et une description de la manière de le résoudre. Pour les lignes qui ont échoué lors de l’importation plutôt que lors de la validation, veuillez télécharger le rapport d’erreurs à partir du menu à trois points sur la page Importer des utilisateurs.

Si vous rencontrez des difficultés avec l’importation CSV, veuillez consulter les problèmes courants ci-dessous. Vous avez toujours besoin d’aide ? Veuillez contacter [email protected].

Problèmes de formatage des fichiers

Ligne mal formée

Si votre téléchargement s’est terminé avec des erreurs, il se peut qu’il y ait une ligne mal formée dans votre fichier CSV.

Pour importer correctement les données, il est nécessaire d’inclure une ligne d’en-tête. Chaque ligne doit avoir le même nombre de cellules que la ligne d’en-tête. Les lignes qui ont plus, ou moins, de valeurs que la ligne d’en-tête seront exclues de l’importation. Les virgules dans une valeur seront interprétées comme un séparateur et peuvent conduire à cette erreur. De plus, toutes les données doivent être encodées en UTF-8.

Si votre fichier CSV contient des lignes vides et que vous importez moins de lignes que le nombre total de lignes dans le fichier CSV, cela ne signifie pas nécessairement qu’il y a un problème avec l’importation, car les lignes vides n’ont pas besoin d’être importées. Vérifiez le nombre de lignes correctement importées et assurez-vous qu’elles correspondent au nombre d’utilisateurs que vous essayez d’importer.

Ligne manquante

Plusieurs raisons peuvent expliquer pourquoi le nombre d’utilisateurs importés ne correspond pas forcément au total de lignes dans votre fichier CSV :

Quote de chaîne de caractères

Les valeurs encapsulées dans des guillemets simples ('') ou doubles ("") seront lues comme des chaînes de caractères lors de l’importation.

Dates incorrectement formatées

Les dates qui ne sont pas au format ISO-8601 ne seront pas lues comme datetimes lors de l’importation.

Problèmes liés à la structure des données

E-mails non valides

Si votre téléchargement s’est terminé avec des erreurs, il se peut qu’une ou plusieurs adresses e-mail cryptées ne soient pas valides. Veuillez vous assurer que toutes les adresses e-mail sont correctement cryptées avant de les importer dans Braze.

  • Lors de la mise à jour ou de l’importation d’adresses e-mail dans Braze, veuillez utiliser la valeur hachée de l’adresse e-mail chaque fois qu’une adresse e-mail est incluse. Ces valeurs de hachage des e-mails sont fournies par votre équipe interne.
  • Lors de la création d’un nouvel utilisateur, il est nécessaire d’ajouter la valeur email_encryptedcryptée de l’adresse e-mail de l’utilisateur. Dans le cas contraire, Braze ne créera pas l’utilisateur. De même, si vous ajoutez une adresse e-mail à un utilisateur existant qui n’en possède pas, vous devez ajouter email_encrypted. Dans le cas contraire, Braze ne mettra pas à jour les informations de l’utilisateur.

Données importées comme attribut personnalisé

Si une donnée utilisateur par défaut (telle que email ou first_name) est importée en tant qu’attribut personnalisé, vérifiez la casse et l’espacement de votre fichier CSV. Par exemple,First_name est importé en tant qu’attribut personnalisé, tandis quefirst_name est correctement importé dans le champ « prénom » du profil utilisateur.

Plusieurs types de données

Braze s’attend à ce que toutes les valeurs d’une colonne soient du même type de données. Les valeurs qui ne correspondent pas au type de données de leur attribut entraînent des erreurs de segmentation.

De plus, commencer un attribut numérique par zéro peut entraîner des problèmes, car les nombres commençant par zéro sont considérés comme des chaînes de caractères. Lorsque Braze convertit cette chaîne de caractères, elle peut être traitée comme une valeur octale (qui utilise les chiffres de zéro à sept), ce qui signifie qu’elle est convertie en sa valeur décimale correspondante. Par exemple, si la valeur dans le fichier CSV est 0130, le profil Braze affiche 88. Pour éviter ce problème, veuillez utiliser des attributs avec des types de données de chaîne de caractères. Cependant, ce type de données n’est pas disponible dans la comparaison des numéros de segmentation.

Types d’attributs par défaut

Certains attributs par défaut peuvent n’accepter que certaines valeurs comme valides pour les mises à jour utilisateur. Pour obtenir des conseils, veuillez vous référer à la section Création de votre fichier CSV.

Les espaces finaux et les différences dans l’utilisation des majuscules peuvent entraîner l’interprétation d’une valeur comme non valide. Par exemple, dans le fichier CSV suivant, seul l’utilisateur de la première ligne (brazetest1) a vu son e-mail et ses statuts push mis à jour avec succès, car les valeurs acceptées sont unsubscribed, subscribed, et opted_in.

1
2
3

external_id,email,email_subscribe,push_subscribe
brazetest1,[email protected],unsubscribed,unsubscribed
brazetest2,[email protected],Unsubscribed,Unsubscribed

La fonction « Sélectionner un fichier CSV » ne fonctionne pas correctement.

Plusieurs raisons peuvent expliquer pourquoi le bouton Sélectionner un fichier CSV ne fonctionne pas :
Github   Modifier cette page sur GitHub
New Stuff!