Skip to content

Importation CSV

Découvrez comment enregistrer et mettre à jour les événements personnalisés et les attributs des utilisateurs à l’aide de l’importation CSV.

A 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 : Téléchargez un modèle CSV

Pour ouvrir l’importation CSV, allez dans Audiences > Importer des utilisateurs. Vous y trouverez un tableau qui répertorie les détails des importations les plus récentes, tels que la date de téléchargement, le nom du téléchargeur, le nom du fichier, la disponibilité du ciblage, le nombre de lignes importées et l’état de l’importation.

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

La page “Importation d’utilisateurs” du tableau de bord de Braze.](/docs/fr/assets/img/csv_import/import_users_page.png?0df1987be02a12967c97903c8182d403)

Étape 2 : Choisissez un identifiant

Le fichier CSV que vous importez aura besoin d’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 external_id qui servira d’identifiant unique pour chaque client. Lorsque vous fournissez un external_id dans votre importation, Braze met à jour tout utilisateur existant avec le même external_id ou crée un nouvel utilisateur identifié avec ce jeu de external_id s’il n’y en a pas.

Pour cibler les utilisateurs qui n’ont pas d’alias external_id, vous pouvez importer une liste d’utilisateurs ayant des alias. Un alias sert d’identifiant unique alternatif pour l’utilisateur et peut être utile si vous essayez de marketeur des utilisateurs anonymes qui ne se sont pas inscrits ou n’ont pas créé de compte avec votre application.

Si vous téléchargez ou mettez à jour des profils utilisateurs qui sont uniquement des alias, 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 user_alias_name et user_alias_label dans votre importation, Braze mettra à jour tout utilisateur existant avec les mêmes user_alias_name et user_alias_label. Si un utilisateur n’est pas trouvé, Braze créera un nouvel utilisateur identifié avec ce jeu de user_alias_name.

Télécharger : Modèle d’importation d’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 comporte cette adresse e-mail ou ce numéro de téléphone, ce profil sera mis à jour et Braze ne créera 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 un profil avec cette adresse e-mail ou ce numéro de téléphone n’existe pas, Braze créera 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 le point de terminaison /users/delete endpoint.

Étape 3 : Créez votre fichier CSV

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

  • Attributs de l’utilisateur : Il s’agit des attributs par défaut et des attributs personnalisés de l’utilisateur. 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 uniques à votre entreprise (tels que last_destination_searched).
  • Événements personnalisés : Celles-ci sont uniques à votre entreprise et reflètent les actions qu’un utilisateur a effectuées, par exemple trip_booked pour une application de réservation de voyages.

Lorsque vous êtes prêt à créer votre fichier CSV, reportez-vous aux informations suivantes :

Identifiants requis

Bien que external_id ne soit pas obligatoire, vous devez inclure l’un des identifiants suivants dans l’en-tête de votre fichier CSV. Pour en savoir plus sur chacun d’entre eux, consultez la rubrique 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 de données CSV. Les en-têtes de colonne qui ne correspondent pas exactement à un attribut par défaut se verront attribuer un attribut personnalisé dans Braze.

Attributs par défaut

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

En outre, vous pouvez ajouter des utilisateurs à des groupes d’abonnement par e-mail ou par SMS grâce à 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, reportez-vous à la section 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 que external_id ne soit pas obligatoire, vous devez inclure l’un des identifiants suivants dans l’en-tête de votre fichier CSV. Pour en savoir plus sur chacun d’entre eux, consultez la rubrique Choisir un identifiant.

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

Champs d’événements personnalisés

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

Par exemple, l’événement personnalisé trip_booked peut avoir les propriétés destination et duration. Ceux-ci peuvent être importés en ayant les en-têtes de colonne trip_booked.properties.destination et trip_booked.properties.duration.

Étape 4 : Téléchargez et prévisualisez vos données

Avant de traiter votre fichier CSV, Braze génère un aperçu des premières lignes afin que vous puissiez vérifier qu’il n’y a pas de problème. Pour générer votre aperçu, choisissez Attributs ou Événements, puis sélectionnez Parcourir les fichiers et téléchargez votre fichier CSV.

Le téléchargement d’un fichier CSV s’est terminé par des erreurs impliquant des types de données mixtes dans une seule colonne.](/docs/fr/assets/img/csv_import/upload_csv.png?2dd609127c56229f139a1416c5a28ef3){: style=”max-width:70%”}

Étape 5 : Choisissez 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 un segment à partir de votre importation, sélectionnez Ne pas rendre cette liste disponible en tant que filtre de ciblage.

Un groupe de filtres avec le filtre “Updated/Imported from CSV” comprenant un fichier CSV intitulé “Halloween season fun”.](/docs/fr/assets/img/csv_import/add_filter_group.png?59c959394e0cb32af8c093f00378dc8f){: style=”max-width:85%;”}

Étape 6 : Commencez votre importation CSV

Lorsque vous êtes prêt, sélectionnez Lancer l’importation. Vous pouvez suivre l’évolution de la situation sur la page Importations d’utilisateurs, qui s’actualise automatiquement toutes les cinq secondes.

S’il n’y a pas de problème, l’état sera mis à jour et le nombre de lignes traitées s’affichera. Toutes les données des lignes traitées seront ajoutées aux profils existants ou aux profils nouvellement créés.

Considérations sur les points de données

Chaque donnée client importée à partir d’un fichier CSV remplacera la valeur existante dans les profils utilisateurs et enregistrera un point de données, à l’exception des ID externes et des valeurs vierges. Si vous avez des questions sur les nuances des points de données de Braze, votre gestionnaire de compte Braze peut y répondre.

Résolution des problèmes

Si vous rencontrez des difficultés avec l’importation de fichiers CSV, passez en revue les problèmes les plus courants. Vous avez encore besoin d’aide ? Contactez [email protected].

Problèmes de formatage des fichiers

Ligne malformée

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

Pour importer correctement des 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 dont la longueur est supérieure ou inférieure à celle de 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. En outre, toutes les données doivent être codées en UTF-8.

Si votre fichier CSV contient des lignes vierges et que vous importez moins de lignes que le nombre total de lignes dans le fichier CSV, cela n’indique peut-être pas un problème d’importation puisque les lignes vierges n’ont pas besoin d’être importées. Vérifiez le nombre de lignes qui ont été correctement importées et assurez-vous qu’il correspond au nombre d’utilisateurs que vous tentez 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 de votre fichier CSV :

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 mal formatées

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

Questions relatives à la structure des données

Adresses e-mail non valides

Si votre téléchargement s’est terminé par des erreurs, il se peut qu’il y ait une ou plusieurs adresses e-mail cryptées non valides. Confirmez 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, utilisez la valeur hachée de l’e-mail chaque fois qu’un e-mail est inclus. Ces valeurs d’e-mail de hachage sont fournies par votre équipe interne.
  • Lors de la création d’un nouvel utilisateur, vous devez ajouter email_encrypted avec la valeur de l’e-mail crypté de l’utilisateur. Sinon, l’utilisateur ne sera pas créé. De même, si vous ajoutez une adresse e-mail à un utilisateur existant qui n’a pas d’e-mail, vous devez ajouter email_encrypted. Sinon, l’utilisateur ne sera pas mis à jour.

Données importées en tant qu’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 serait importé en tant qu’attribut personnalisé, tandis que first_name serait correctement importé dans le champ “prénom” du profil d’un utilisateur.

Plusieurs types de données

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 entraîneront des erreurs de segmentation.

En outre, le fait de commencer un attribut de nombre par zéro posera des problèmes, car les nombres commençant par des zéros 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 sera convertie en sa valeur décimale correspondante. Par exemple, si la valeur du fichier CSV est 0130, le profil Braze affichera 88. Pour éviter ce problème, utilisez des attributs avec des chaînes de caractères. Toutefois, ce type de données n’est pas disponible dans la comparaison des numéros de segmentation.

Types d’attribut par défaut

Certains attributs par défaut peuvent n’accepter que certaines valeurs comme valables pour les mises à jour de l’utilisateur. Pour plus d’informations, reportez-vous à la section Construire votre CSV.

Les espaces de fin et les différences de capitalisation 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) verra ses statuts d’e-mail et de 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.

Il y a plusieurs raisons pour lesquelles le bouton Sélectionner un fichier CSV peut ne pas fonctionner :
Github   Modifier cette page sur GitHub
New Stuff!