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 événements personnalisés suivants. Braze accepte ces données sous forme de fichiers CSV standard dans les limites de taille maximale indiquées dans le tableau suivant.

Utiliser l’importation CSV

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

Pour ouvrir l’importation CSV, accédez à Audiences > Import Users. Vous y trouverez un tableau répertoriant les détails des importations les plus récentes, tels que la date de téléversement, le nom de la personne ayant effectué le téléversement, le nom du fichier, la disponibilité du ciblage, le nombre de lignes importées et le statut de l’importation.

Pour commencer avec votre CSV, téléchargez un modèle pour les attributs ou les événements.

Étape 2 : Choisir un identifiant

Le CSV que vous importez doit contenir un identifiant dédié. Vous pouvez choisir parmi les options suivantes :

• id externe
• alias d'utilisateur
• id braze
• adresse e-mail et numéros de téléphone

Étape 3 : Construire votre fichier CSV

Vous pouvez téléverser l’un des types de données suivants dans un seul fichier CSV. Pour téléverser plus d’un type de données, téléversez 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 : Ceux-ci sont propres à votre entreprise et reflètent les actions effectuées par un utilisateur, comme trip_booked pour une application de réservation de voyages.

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

• attributs utilisateur
• événements personnalisés

Étape 4 : Téléverser votre fichier

Pour téléverser votre fichier, sélectionnez Attributes ou Events, cliquez sur Browse Files, puis téléversez votre CSV. Braze affiche un aperçu des premières lignes et un résumé des champs détectés.

Pour les fichiers volumineux (jusqu’à 500 Mo pour les attributs par défaut et personnalisés, ou 50 Mo pour les événements personnalisés), le tableau de bord peut sembler temporairement non réactif pendant le téléversement du fichier et le calcul de l’importation par Braze. Ces téléversements et calculs peuvent prendre plus de temps que pour des fichiers plus petits. Laissez cette étape se terminer. Pour plus de contexte sur les limites de fichiers et les délais, consultez Construire votre CSV.

Dans le champ Import name, 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 du fichier pour vérifier chaque ligne à la recherche d’erreurs et d’avertissements. Pour valider votre fichier, sélectionnez Validate file before importing, puis cliquez sur Start import.

La validation peut prendre jusqu’à 2 minutes pour les fichiers à la taille maximale autorisée. Pendant la validation, vous pouvez sélectionner Skip validation pour la contourner et procéder immédiatement.

Résultats de la validation

Lorsque la validation est terminée, l’un des résultats suivants apparaît.

Comprendre le rapport d’erreurs

Le rapport d’erreurs est un fichier CSV qui contient chaque ligne signalée avec ses 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 retéléverser, 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 Do not make this list available as a targeting filter.

Étape 7 : Lancer votre importation CSV

Lorsque vous êtes prêt, sélectionnez Start import. Vous pouvez suivre la progression en cours sur la page Import Users, qui s’actualise automatiquement toutes les 5 secondes. Le traitement peut prendre de quelques minutes à quelques heures selon la taille de votre CSV. Pendant ce temps, le tableau de bord peut sembler non réactif ou répondre lentement, mais l’importation est toujours en cours.

Statuts d’importation

Après avoir lancé votre importation, vous pouvez vérifier son statut sur la page Import Users.

Le rapport d’erreurs post-importation inclut les lignes qui ont échoué pour des raisons que la validation ne couvre pas, comme lorsqu’un utilisateur n’existe pas dans Braze.

Considérations relatives aux points de donnée

Chaque donnée client importée depuis un fichier CSV écrase la valeur existante sur 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ée Braze, votre gestionnaire de compte Braze peut y répondre.

Résolution des problèmes

Si vous avez utilisé la validation du fichier, commencez par le rapport d’erreurs, car il inclut le problème spécifique pour chaque ligne signalée et une description de la façon de le corriger. 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 Import Users.

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

Problèmes de formatage du fichier

Ligne mal formée

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

Pour importer correctement les données, il doit y avoir 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 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 provoquer cette erreur. De plus, toutes les données doivent être encodées en UTF-8.

Si votre fichier CSV contient des lignes vides et importe moins de lignes que le nombre total de lignes dans le fichier CSV, cela peut ne pas indiquer un problème avec l’importation puisque 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

Il y a plusieurs raisons pour lesquelles le nombre d’utilisateurs importés peut ne pas correspondre au nombre total de lignes dans votre fichier CSV :

Guillemets de chaîne

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

Dates mal formatées

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

Problèmes de structure des données

Adresses e-mail invalides

Si votre téléversement s’est terminé avec des erreurs, il peut y avoir une ou plusieurs adresses e-mail chiffrées invalides. Confirmez 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 e-mail hachée partout où un e-mail est inclus. Ces valeurs e-mail 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 e-mail chiffrée de l’utilisateur. Sinon, Braze ne créera pas l’utilisateur. De même, si vous ajoutez une adresse e-mail à un utilisateur existant qui n’en a pas, vous devez ajouter email_encrypted. Sinon, 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 comme attribut personnalisé, vérifiez la casse et l’espacement de votre fichier CSV. Par exemple, First_name est importé comme attribut personnalisé, tandis que first_name est correctement importé dans le champ « prénom » du profil d’un 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.

Types de données multiples

Braze s’attend à ce que chaque valeur d’une colonne soit du même type de données. Les valeurs qui ne correspondent pas au type de données de leur attribut provoquent des erreurs de segmentation.

De plus, commencer un attribut numérique par zéro causera 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 chaîne de caractères. Cependant, ce type de données n’est pas disponible dans la comparaison numérique de 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 Construire votre CSV.

Les espaces en fin de chaîne et les différences de casse peuvent faire en sorte qu’une valeur soit interprétée comme invalide. 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

Il y a plusieurs raisons pour lesquelles le bouton Select CSV File peut ne pas fonctionner :