User Import

Braze propose différentes manières d’importer les données des utilisateurs dans la plate-forme : SDK, API, Cloud Data Ingestion, intégrations de partenaires technologiques et fichiers CSV.

Avant de poursuivre, notez que Braze ne nettoie pas (valide ou formate correctement) les données HTML lors de l’importation. Cela signifie que les balises de script doivent être supprimées pour toutes les données d’importation destinées à la personnalisation Web.

Lorsque vous importez dans Braze des données spécifiquement destinées à la personnalisation dans un navigateur web, veillez à ce qu’elles soient dépourvues de HTML, de JavaScript ou de toute autre étiquette de script susceptible d’être utilisée à des fins malveillantes lorsqu’elles sont affichées dans un navigateur web.

Pour le HTML, vous pouvez également utiliser les filtres Liquid de Braze (strip_html) afin d’extraire le texte rendu du HTML. Par exemple :

• entrée
• sortie

1
{{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}

1
Have you read Ulysses?

API REST

Utilisez l’endpoint /users/track pour enregistrer des événements personnalisés, des attributs utilisateurs et des achats pour les utilisateurs.

Ingestion de données cloud

Utilisez Braze Cloud Data Ingestion ] pour importer et gérer les attributs des utilisateurs.

Importation CSV

Vous pouvez télécharger et mettre à jour les profils utilisateurs à l’aide de fichiers CSV à partir de Audience > Importer des utilisateurs.

L’importation d’un fichier CSV permet d’enregistrer et de mettre à jour les attributs des utilisateurs, tels que le prénom et l’e-mail, ainsi que des attributs personnalisés comme la pointure. Vous pouvez importer un fichier CSV en spécifiant l’un des deux identifiants uniques de l’utilisateur : un external_id ou un alias d’utilisateur.

Création de votre fichier CSV

Il y a plusieurs types de données dans Braze. Lors de l’importation ou de la mise à jour de profils utilisateurs à l’aide d’un fichier CSV, vous pouvez créer ou mettre à jour des attributs utilisateurs par défaut ou des attributs personnalisés.

• Les attributs utilisateur par défaut sont des clés réservées à Braze. Par exemple, first_name ou email.
• Les attributs personnalisés sont spécifiques à votre entreprise. Par exemple, une application de réservation de voyages peut avoir un attribut personnalisé nommé last_destination_searched.

Braze accepte les données des utilisateurs au format CSV standard à partir de fichiers d’une taille maximale de 500 Mo. Reportez-vous aux sections précédentes sur l’importation pour avoir des modèles CSV téléchargeables.

Considérations relatives aux points de données

Chaque donnée client importée à partir d’un fichier CSV remplacera la valeur existante dans les profils utilisateurs et comptera comme un point de données, à l’exception des ID externes et des valeurs vides.

• Les ID externes téléchargés à partir d’un fichier CSV ne consomment pas de points de données. Si vous chargez un CSV pour segmenter des utilisateurs de Braze existants en chargeant uniquement des ID externes, cela ne consommera pas de points de données. Si vous deviez ajouter des données supplémentaires telles que les e-mails ou les numéros de téléphone des utilisateurs dans votre importation, cela écraserait les données existantes sur les utilisateurs, consommant ainsi vos points de données.
  • Les importations CSV à des fins de segmentation (importations effectuées avec external_id, braze_id, ou user_alias_name comme seul champ) ne consommeront pas de points de données.
• Les valeurs vides ne remplacent pas les valeurs existantes du profil utilisateur, et vous n’avez pas besoin d’inclure tous les attributs utilisateur existants dans votre fichier CSV.
• La mise à jour de email_subscribe, push_subscribe, subscription_group_id ou subscription_state n’est pas prise en compte dans la consommation des points de données.

En-têtes de colonne par défaut des données utilisateur

Importation d’un CSV

Pour importer votre fichier CSV, allez dans Audiences > Importation d’utilisateurs . Vous y trouverez un tableau qui répertorie les importations les plus récentes, avec des détails 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 chaque importation.

Sélectionnez Parcourir les fichiers et votre fichier. Braze téléchargera votre fichier et vérifiera les en-têtes de colonne et les types de données de chaque colonne.

Pour télécharger un modèle CSV, reportez-vous aux sections Importation avec ID externe ou Importation avec alias utilisateur sur cette page.

Une fois le chargement terminé, une fenêtre modale s’affiche avec un aperçu du contenu de votre fichier. Toutes les informations de ce tableau sont basées sur les valeurs dans les premières lignes de votre fichier CSV. Pour les en-têtes de colonne, les attributs standard sont écrits en texte normal, tandis que les attributs personnalisés sont en italique et leur type est noté entre parenthèses. Un résumé de votre dossier figure également en haut de la fenêtre contextuelle.

Vous pouvez importer plusieurs CSV en même temps. Les importations CSV sont exécutées simultanément, de sorte que l’ordre des mises à jour n’est pas garanti. Si vous souhaitez que les importations CSV soient exécutées l’une après l’autre, attendez qu’une importation CSV soit terminée avant d’en télécharger une seconde.

Si Braze constate une anomalie dans votre fichier pendant le chargement, ces erreurs apparaîtront dans le résumé. Par exemple, si votre fichier contient une ligne mal formée, cette erreur est signalée dans l’aperçu lorsque vous importez le fichier. Ainsi, un fichier peut être importé avec des erreurs, mais une importation ne peut pas être annulée ou inversée une fois qu’elle a commencé. Examinez l’aperçu et, si vous trouvez des erreurs, annulez l’importation et modifiez votre fichier.

Les lignes mal formées et les lignes manquant une ID externe ne seront pas importées. Toutes les autres erreurs peuvent être importées, mais elles risquent d’interférer avec le filtrage lors de la création d’un segment. Pour plus d’informations, passez à la section Résolution des problèmes.

Lorsque vous êtes satisfait du chargement, démarrez l’importation. La fenêtre contextuelle se ferme et l’importation commence en arrière-plan. Vous pouvez suivre sa progression sur la page Importations d’utilisateurs, qui sera actualisée toutes les cinq secondes, ou en appuyant sur le bouton d’actualisation dans la boîte Imports récents.

Sous Lignes traitées se trouve l’état d’avancement de l’importation ; l’état passera à Terminé lorsque l’importation sera terminée. Vous pouvez toujours utiliser le reste du tableau de bord de Braze pendant l’importation, et vous serez notifié lorsque l’importation commence et se termine.

Si le processus d’importation rencontre une erreur, une icône d’avertissement jaune s’affiche à côté du nombre total de lignes dans le fichier. Vous pouvez survoler l’icône pour obtenir des détails sur les raisons de l’échec de certaines lignes. Une fois l’importation terminée, toutes les données seront ajoutées aux profils existants ou de nouveaux profils seront créés.

Importation avec ID Externe

Lors de l’importation de vos données clients, vous devrez spécifier l’identifiant unique de chaque client (external_id). Avant de commencer votre importation CSV, il est important de voir avec votre équipe d’ingénierie comment les utilisateurs seront identifiés dans Braze. Il s’agit généralement d’un ID de base de données interne. Cela devrait s’aligner sur la façon dont les utilisateurs seront identifiés par le SDK de Braze sur les mobiles et le web et est conçu pour que chaque client ait un profil utilisateur unique au sein de Braze sur l’ensemble de ses appareils. Découvrez plus d’informations sur le cycle de vie du profil utilisateur de Braze.

Lorsque vous indiquez un external_id dans votre importation, Braze mettra à jour un utilisateur existant avec le même external_id, ou créera un utilisateur nouvellement identifié avec cet external_id défini si Braze ne le trouve pas.

Téléchargez : [Modèle d’importation CSV][modèle]

Importation avec alias utilisateur

Pour cibler les utilisateurs qui n’ont pas d’external_id, vous pouvez importer une liste d’utilisateurs avec des alias utilisateurs. Un alias sert d’identifiant unique pour un utilisateur, et peut être utile si vous essayez de vendre à des utilisateurs anonymes qui ne sont pas abonnés 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 votre importation comporte à la fois un user_alias_name et un user_alias_label, Braze mettra à jour tous les utilisateurs existants avec les mêmes user_alias_name et user_alias_label. Si un utilisateur est trouvé, Braze va créer un utilisateur nouvellement identifié avec cet user_alias_name défini.

Télécharger : [Modèle d’importation d’alias CSV][template_alias]

Importation avec ID Braze

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.

Importation d’adresses e-mail et de numéros de téléphone

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 l’enpoint /users/delete.

Importation de données personnalisées

Tout en-tête qui ne correspond pas exactement aux données utilisateur par défaut créera un attribut personnalisé dans Braze.

Les types de données suivants sont acceptés dans l’importation d’utilisateurs :

• Datetime : Doit être stocké au format ISO-8601
• Booléen : true ou false
• Nombre : Entier ou float sans espace ni virgule, les floats doivent utiliser un point (.) comme séparateur décimal.
• Chaîne de caractères : Peut contenir des virgules si des guillemets doubles ("") entourent la valeur de la colonne.
• En blanc : Les valeurs vides n’écraseront pas les valeurs existantes du profil utilisateur et vous n’avez pas besoin d’inclure tous les attributs existants de l’utilisateur dans votre fichier CSV.

Importation CSV d’un utilisateur Lambda

Vous pouvez utiliser notre script d’importation CSV Lambda S3 sans serveur pour charger vos attributs utilisateurs vers la plateforme. Cette solution fonctionne comme un téléchargeur CSV où vous déposez vos CSV dans un compartiment S3, et les scripts les téléchargent via notre API.

Le temps d’exécution estimé pour un fichier de 1 000 000 de lignes devrait être d’environ cinq minutes. Pour plus d’informations, reportez-vous à la section Importation d’un attribut utilisateur au format CSV vers Braze.

Mise à jour du statut du groupe d’abonnement

Vous pouvez ajouter des utilisateurs à des groupes d’abonnement e-mail ou SMS par le biais de 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).

Création d’un filtre reciblage à partir d’une importation d’utilisateurs

L’importation d’utilisateurs peut être utilisée pour transformer le fichier CSV en filtre de reciblage en sélectionnant Importer des utilisateurs dans ce CSV et permettre de recibler ce lot spécifique d’utilisateurs en tant que groupe. Pour filtrer par fichier dans un segment ou partout où le filtrage est possible, sélectionnez le filtre Mise à jour/Importation depuis CSV, puis recherchez le nom exact du fichier.

Création de segmentations à partir d’une importation d’utilisateurs

L’importation d’utilisateurs peut également être utilisée pour créer des segments en sélectionnant Importer des utilisateurs dans ce CSV et permettre de recibler ce lot spécifique d’utilisateurs en tant que groupe et en cochant Générer automatiquement un segment à partir des utilisateurs importés de ce CSV avant de lancer l’importation.

Vous pouvez définir le nom du segment ou accepter la valeur par défaut, qui correspond au nom de votre fichier. Les fichiers qui ont été utilisés pour créer un segment comporteront un lien permettant de visualiser le segment une fois l’importation terminée.

Le filtre utilisé pour créer le segment sélectionne les utilisateurs qui ont été créés ou mis à jour dans une importation sélectionnée et sont disponibles avec tous les autres filtres sur la page Modifier le Segment.

Considérations

Résolution des problèmes

Le téléchargement s’est terminé avec des erreurs

Ligne mal formée

Il doit y avoir une ligne d’en-tête pour que les données soient correctement importées. 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 importe moins de lignes que le nombre total de lignes du fichier CSV, cela n’indique pas forcément un problème 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’elles correspondent au nombre d’utilisateurs que vous essayez d’importer.

Adresses e-mail non valides

Braze a détecté des 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.

Lignes manquantes

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

• Dupliquer des ID externes, des alias d’utilisateurs, des ID Braze, des adresses e-mail ou des numéros de téléphone : Si des colonnes d’ID externe sont dupliquées, cela peut entraîner des lignes mal formées ou non importées, même si les lignes sont correctement formatées. Dans certains cas, il se peut qu’aucune erreur spécifique ne soit signalée. Vérifiez si des ID externes dupliqués sont présents dans votre CSV. Si c’est le cas, retirez les doublons et essayez de les charger à nouveau.
• Caractères accentués : Votre CSV peut comporter des noms ou des attributs qui contiennent des accents. Assurez-vous que votre fichier est encodé UTF-8 pour éviter tout problème.
• L’ID de Braze appartient à un utilisateur orphelin : Lorsqu’un utilisateur est orphelin, l’utilisateur restant avec lequel l’orphelin a été fusionné peut encore ne pas associer l’ID Braze de l’utilisateur orphelin au profil. Dans ce cas, Braze ne trouvera pas d’utilisateur à mettre à jour, et la ligne ne sera donc pas considérée comme importée.
• Rangée vide : Il y a une ligne vide dans le fichier CSV. Cela peut être vérifié si vous ouvrez le fichier CSV dans un programme d’édition de texte (n’utilisez pas Excel ou Sheets). Si vous téléchargez le fichier CSV avec une ligne vide, un message d’erreur s’affichera, indiquant que certaines lignes contiennent des données mal formées.
• Y compris les guillemets doubles (") : Ce caractère n’est pas valide et rendra la ligne malformée. Utilisez plutôt des guillemets simples (').
• Sauts de ligne incohérents : Par exemple, si le fichier CSV utilise \n pour la première ligne et \r\n pour chaque ligne suivante, la première ligne de données sera traitée comme faisant partie de l’en-tête, et ces données ne seront pas importées comme prévu. Vous pouvez le vérifier dans un éditeur hexagonal ou un éditeur de texte spécialisé qui distingue les caractères d’espacement.
• Fichier mal encodé : Le fichier CSV peut inclure des noms ou des attributs comportant des accents, mais le fichier doit être codé en UTF-8 pour les importer correctement. D’autres codages de caractères peuvent fonctionner dans certaines instances, mais seul l’UTF-8 est totalement compatible.

Dates incorrectement formatées

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

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.

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 serait importé comme attribut personnalisé, alors que first_name serait correctement importé dans le champ « prénom » sur le profil d’un 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î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

Le bouton “Select CSV File” ne fonctionne pas

Il y a plusieurs raisons pour lesquelles le bouton Sélectionner un fichier CSV peut ne pas fonctionner :

• Bloqueur de pop-up : Cela peut empêcher l’affichage de la page. Confirmez que votre navigateur autorise les fenêtres pop-up sur le site web du tableau de bord de Braze.
• Navigateur obsolète : Assurez-vous que votre navigateur est à jour ; si ce n’est pas le cas, mettez-le à jour.
• Processus de base : Fermez toutes les instances de votre navigateur, puis redémarrez votre ordinateur.

[erreurs] :#common-errors [modèle] : /docs/fr/assets/download_file/braze-user-import-template-csv.xlsx?3aafd0c03634ac03f248b3055fbc3126 [template_alias]: /docs/fr/assets/download_file/braze-user-import-alias-template-csv.xlsx?c0ce6c0aa1e901395161d87c5ba17747