Importation CSV

Découvrez 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 attributs utilisateur et les événements personnalisés suivants.

Utilisation de l’importation CSV

Étape 1 : Télécharger un modèle CSV

Pour ouvrir l’importation CSV, accédez à Audiences > Importer des utilisateurs. Vous y trouverez 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 ayant 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 démarrer avec votre CSV, téléchargez un modèle pour les attributs ou les événements.

Étape 2 : Choisir un identifiant

Le fichier CSV que vous importez nécessite un identifiant dédié. Vous pouvez choisir parmi les options suivantes :

• external id
• user alias
• braze id
• email address and phone numbers

Étape 3 : 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, utilisez plusieurs fichiers CSV.

• Attributs utilisateur : Cela inclut 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 que first_name ou email) et les attributs personnalisés sont des attributs utilisateur propres à votre entreprise (tels que last_destination_searched).
• Événements personnalisés : Ces événements sont propres à votre entreprise et reflètent les actions effectuées par un utilisateur, par exemple trip_booked pour une application de réservation de voyages.

Lorsque vous êtes prêt à créer votre fichier CSV, consultez les informations suivantes :

• user attributes
• custom events

Étape 4 : Télécharger votre fichier

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

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

Étape 5 : Valider votre fichier (facultatif)

Avant de lancer votre importation, vous pouvez exécuter une validation de fichier pour vérifier chaque ligne à la recherche d’erreurs et d’avertissements. Pour valider votre fichier, sélectionnez Valider le fichier avant l’importation, puis cliquez sur Démarrer l’importation.

La validation peut prendre jusqu’à 2 minutes pour les fichiers à la taille maximale 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.

Comprendre le rapport d’erreurs

Le rapport d’erreurs est un fichier CSV qui contient toutes les lignes signalées, avec 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 : Choisir les préférences de ciblage

Vous pouvez également choisir 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, sélectionnez Ne pas rendre cette liste disponible en tant que filtre de ciblage.

Étape 7 : Lancer votre importation CSV

Lorsque vous êtes prêt, sélectionnez Démarrer l’importation. Vous pouvez suivre la progression en cours sur la page Importer des utilisateurs, qui s’actualise automatiquement toutes les 5 secondes.

Statuts d’importation

Après avoir lancé votre importation, vous pouvez vérifier son statut sur la page Importer des utilisateurs.

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 utilisateur et enregistre un point de donnée, à l’exception des ID externes et des valeurs vides. Si vous avez des questions sur les subtilités des points de données Braze, votre Account Manager Braze peut y répondre.

Résolution des problèmes

Si vous avez utilisé la validation de fichier, commencez par le rapport d’erreurs, car 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, téléchargez le rapport d’erreurs en survolant la ligne et en sélectionnant le bouton sur la page Importer des utilisateurs.

Pour résoudre les problèmes d’importation CSV, consultez les problèmes courants ci-dessous.

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, une ligne d’en-tête est nécessaire. Chaque ligne doit avoir le même nombre de cellules que la ligne d’en-tête. Les lignes ayant 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 entraîner 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 le nombre de lignes importées est inférieur au nombre total de lignes du fichier CSV, cela n’indique pas nécessairement 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’il correspond 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 au nombre total de lignes dans votre fichier CSV :

Guillemets de chaîne de caractères

Les valeurs encadrées par 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

Adresses e-mail non valides

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

• Lors de la mise à jour ou de l’importation d’adresses e-mail dans Braze, utilisez la valeur hachée de l’adresse e-mail chaque fois qu’une adresse e-mail est incluse. Ces valeurs hachées sont fournies par votre équipe interne.
• Lors de la création d’un nouvel utilisateur, vous devez ajouter email_encrypted avec la valeur chiffré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 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 que first_name est correctement importé dans le champ « prénom » du profil utilisateur.

Modifier le type de données d’un attribut personnalisé

Si vous devez modifier le type de données d’un attribut personnalisé existant (par exemple, de chaîne de caractères à valeur booléenne), mettez à jour le type de données sur la page Attributs personnalisés du tableau de bord avant d’importer votre CSV. Si le type de données dans votre CSV ne correspond pas au type de données actuellement défini pour l’attribut, l’importation échoue avec une erreur.

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, 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, utilisez 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 numérique de la segmentation.

Types d’attributs par défaut

Certains attributs par défaut n’acceptent que certaines valeurs comme valides pour les mises à jour utilisateur. Pour des conseils, consultez Créer votre fichier CSV.

Les espaces en fin de chaîne et les différences de casse 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) voit ses statuts e-mail et 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

« Sélectionner un fichier CSV » ne fonctionne pas

Plusieurs raisons peuvent expliquer pourquoi le bouton Sélectionner un fichier CSV ne fonctionne pas :