Vous pouvez importer des événements produit dans Positive User à partir d’un fichier CSV ou XLSX afin d’en ajouter un grand nombre en une seule fois. Cela vous permet d’éviter les manipulations manuelles et d’intégrer plus facilement des données d’événements structurées dans la plateforme. Dans cet article, nous vous expliquons comment préparer votre fichier et importer vos événements produit correctement.
Avant de lancer l’import, assurez-vous que votre fichier est bien structuré et que vous comprenez comment la donnée est gérée dans Positive User. La plateforme repose à la fois sur des attributs standards (présents par défaut comme l’email ou le numéro de téléphone) et des attributs personnalisés (que vous créez selon vos besoins).
Gestion des produits : Définissez en amont votre logique de gestion des produits : création des nouveaux produits, mise à jour et ajout d’occurrences d’événement produit.
Types d’événement produit : Seuls les types d’événement listés dans cet article peuvent être importés dans l’espace de travail.
Correspondance avec les attributs standards : Si les colonnes de votre fichier correspondent aux attributs standards, vous pourrez lancer l’import immédiatement.
Créer des attributs personnalisés : Si vous souhaitez ajouter des informations supplémentaires non prises en charge par défaut, vous devrez d’abord créer les attributs personnalisés correspondants. Suivez les étapes de “Comment créer un attribut personnalisé ?“.
Vérifier les types de données : Vérifiez que chaque colonne correspond bien au bon type d’attribut. Par exemple, un champ “Scoring” doit être de type integer (entier), tandis qu’une “Date” doit être au format datetime. Consultez l’article “Qu'est-ce qu'un attribut ?” pour plus d’informations.
Avant d’importer votre fichier, assurez-vous qu’il est correctement formaté. Si vous n'êtes pas sûr de la structure à adopter, vous pouvez télécharger un modèle prêt à l'emploi directement depuis l'application en cliquant sur le bouton “xlsx” ou “csv” dans la section “Données” → “Importateurs”.
Pour en savoir plus, consultez notre article dédié au formatage des données.
Champs requis
Importer des événements produit signifie ajouter des occurrences à deux timelines : celle du contact ayant effectué l’action et celle du produit concerné (par exemple, l’historique d’achats d’un produit). Chaque occurrence doit donc être associée à un contact et à un produit spécifiques. Cela peut être fait via “user_id”/“email” pour le contact et “product_id” pour le produit.
Le fichier doit aussi contenir les colonnes suivantes :
product_id (identifiant personnalisé du produit dans votre base de donnée)
user_id / email (identifiant du contact ayant effectué l’action)
timestamp (date et heure de l’événement au format ISO 8601 (ex. 2017-07-25T14:14:08.612Z))
event_type (type d’événement, issu de la liste autorisée)
Le nom du produit est facultatif. S’il n’est pas renseigné et que le produit n’existe pas encore, il sera créé sans nom.
En-têtes de colonnes
La première ligne de votre fichier doit toujours contenir les en-têtes de colonnes.
Essayez d’utiliser exactement les mêmes noms que les attributs existants dans Positive User. Si le nom de la colonne est identique au nom de l’attribut, le système les associera automatiquement lors de l’import.
Encodage
L’encodage indique à l’ordinateur comment interpréter les caractères présents dans votre fichier. Le format par défaut et recommandé est UTF-8. Cet encodage permet de s’assurer que les caractères spéciaux, les accents et les symboles seront correctement importés, sans être remplacés par des caractères incorrects.
Séparateur
Dans les fichiers CSV (Comma Separated Values), un séparateur est le signe de ponctuation utilisé pour séparer les données en différentes colonnes. Les séparateurs les plus courants sont la virgule (,) et le point-virgule (;).
Champs à valeurs multiples
Si une colonne contient plusieurs valeurs (par exemple “Tags” ou tout attribut de type choix fixe autorisant plusieurs valeurs), séparez-les avec le caractère pipe : “|”
Exemple : tag1|tag2|tag3
Accédez à “Données” → “Importateurs” et sélectionnez “Importer des événements produit”.
Importez votre fichier manuellement ou par glisser & déposer.
Choisissez l’encodage correspondant à votre fichier (UTF-8 est sélectionné par défaut).
Sélectionnez le séparateur utilisé dans votre fichier.
À cette étape, vous devez faire correspondre les en-têtes de colonnes de votre fichier avec les attributs existants dans Positive User.
Correspondance automatique : Si le nom d’une colonne est identique au nom d’un attribut dans le système, la correspondance sera faite automatiquement.
Correspondance manuelle : Pour les colonnes qui ne sont pas associées automatiquement, il suffit de sélectionner l’attribut correspondant dans le menu déroulant.
Une fois toutes les correspondances effectuées, cliquez sur “Suivant”. Vous serez redirigé vers l’étape “Confirmation”.
Lors de l’étape “Confirmation”, vous pouvez vérifier le récapitulatif de l’import avant de valider l’opération. Une fois l’import confirmé, le système commence à traiter votre fichier.
Vous pouvez suivre la progression de l’import et consulter les résultats dans la section “Résultats d’importation". Vous y serez redirigé automatiquement.
Cette section est également accessible à tout moment via “Données” → “Importateurs” → “Résultats d’importation”.
Vous y trouverez les informations suivantes :
Statut (commencé/en cours/terminé/archivé)
Crée le
Terminé le
Type (type de donnée importée)
Crée par (utilisateur ayant importé le fichier)
Nom du fichier
Total de lignes (dans votre fichier)
Réussi (nombre de lignes importées avec succès)
Échoué (nombre de lignes ayant échoué)
Si une erreur survient pendant l’import, cliquez sur le nom du fichier pour afficher un rapport d’erreurs détaillé.
Vous pouvez enrichir vos données produit en ajoutant des attributs adaptés à vos besoins métier, afin d’améliorer votre suivi et vos analyses
Positive User ne conserve pas l’historique des valeurs des attributs d’événement produit (à l’exception de event_type). Chaque nouvel événement met à jour les valeurs actuelles dans le profil du produit, remplaçant les anciennes.
