Personyze Wiki Personyze Wiki docs
Français
Open Personyze
Docs/ Flux et imports/ Importer des flux et des fichiers de données
Flux et imports

Importer des flux et des fichiers de données

Alimenter Personyze en catalogues, centres d’intérêt, listes d’utilisateurs et transactions : modèles, quatre méthodes d’envoi, dépôt SFTP, règles de format et association des colonnes.

34 min read Updated 1 hour ago

Alimenter Personyze en données

Où se trouvent désormais les données. Chaque type de données a son propre écran dans le panneau, et chacun ouvre le même assistant Importer des données depuis un fichier ou un flux (les écrans de catalogue l’affichent sous forme de section Flux entrants). Allez à l’écran correspondant à ce que vous chargez :

Ce que vous importez Où l’importer
Catalogue de produits (pour les recommandations de produits) — y compris les centres d’intérêt / tags d’affinité des produits sous forme de colonnes Paramètres → Recommandations → Catalogue produits
Catalogue de contenus / d’articles (pour les recommandations de contenu) Paramètres → Recommandations → Catalogue d’articles
Transactions passées / hors ligne (historique d’achats) Paramètres → Recommandations → Suivi des produits
Interactions passées avec le contenu (historique des lectures / vues) Paramètres → Recommandations → Suivi des articles
Listes d’utilisateurs / fiches CRM, champs de profil, attributs de session Paramètres → Attributs des visiteurs

Les écrans Recommandations apparaissent dès que votre compte a les produits ou les articles activés. L’assistant, les méthodes d’envoi et les règles de format sont identiques sur tous les écrans — cette page est la référence commune ; seules les colonnes diffèrent.

L’assistant d’import depuis un fichier ou un flux — étape 1, source d’import, avec les options import de fichier, flux URL, envoi SFTP et API JSON
L’assistant Importer des données depuis un fichier ou un flux (étape 1, Source de l’import) : choisissez un fichier, un flux URL, SFTP ou l’API JSON. C’est le même assistant sur tous les écrans de données. Cliquez pour agrandir.

Presque tout ce sur quoi Personyze personnalise peut lui être fourni sous forme de fichier de données — un catalogue de produits pour les recommandations, un catalogue de contenus pour les recommandations d’articles, des centres d’intérêt produits pour les ventes croisées et le ciblage par affinité, des listes d’utilisateurs issues de votre CRM, et plus encore. Tous passent par le même assistant Importer des données depuis un fichier ou un flux ; seules les colonnes diffèrent.

Cette page explique comment faire entrer le fichier — les méthodes d’envoi, les règles de format qui piègent souvent, et l’étape d’association — avec des exemples réels, éprouvés sur le terrain.

Télécharger un modèle de flux

Partez d’un fichier tout prêt plutôt que d’une page blanche. Chaque modèle a les bons en-têtes, les bons guillemets et quelques lignes d’exemple exactement au format attendu par l’importateur — remplacez les lignes d’exemple par vos propres données et importez. Tous utilisent des URL fictives example.com et des produits de démonstration génériques.

Flux Colonnes Téléchargement
Catalogue de produits
Pour les recommandations de produits — les colonnes essentielles.		 Internal ID, SKU, Title, Product Page URL, Main Image URL, Price, Sale Price, Is in Stock, Rating, Category, Brand 📥 Télécharger le CSV
Flux de produits (Google / TSV)
Flux au format Google Shopping — directement utilisable comme flux URL.		 id, title, link, image_link, price, sale_price, availability, brand, product_type, gtin 📥 Télécharger le TSV
Catalogue de contenus
Pour les recommandations d’articles / de vidéos.		 Internal ID, Title, Content Page URL, Main Image URL, Content Type, Category, Author, Published Date 📥 Télécharger le CSV
Centres d’intérêt produits
Tags d’affinité par produit pour les ventes croisées et le ciblage.		 Id, Interest (quoted, comma-separated), Category 📥 Télécharger le CSV
Transactions passées
Historique d’achats — relie les utilisateurs aux produits qu’ils ont achetés.		 User Id, Email, Order Id, Product Id, Product Title, Quantity, Price, Currency, Order Date 📥 Télécharger le CSV
Liste d’utilisateurs / CRM
Champs de profil indexés par e-mail ou par identifiant utilisateur.		 User Id, Email, First Name, Last Name, Account Type, Industry, Lifetime Value, Signup Date 📥 Télécharger le CSV

Le modèle .tsv se télécharge en .txt (tabulations préservées) — renommez-le en .tsv si vos outils l’exigent, ou importez-le tel quel.

Vous préférez une visite guidée ? Voici tout le parcours — choisir une source, formater le fichier, associer les colonnes, importer. Référence détaillée plus bas.

Importer un flux
Choisir comment arrivent les données

Choisir comment arrivent les données

Allez à l’écran correspondant à ce que vous chargez — Paramètres → Recommandations → Catalogue produits / Catalogue d’articles / Suivi des produits, ou Paramètres → Attributs des visiteurs — et ouvrez Importer des données depuis un fichier ou un flux. Choisissez une source : importer un fichier (ponctuel), un flux URL / RSS / Atom ou SFTP (synchronisés), ou l’API JSON (en temps réel). Le même assistant partout — seuls les champs diffèrent.

💡 Un fichier est un instantané ; un flux URL, SFTP ou API se resynchronise selon un calendrier.
Formater le fichier

Formater le fichier

L’importateur est délimité par des virgules. Toute cellule qui contient elle-même une virgule — une liste de centres d’intérêt, plusieurs catégories — doit être entourée de guillemets doubles, sinon elle se découpe en colonnes supplémentaires. Tout le reste est du CSV ordinaire.

💡 Le compteur « Detected N columns » de l’étape suivante est votre contrôle d’analyse — fiez-vous à lui plutôt qu’à l’aspect du fichier dans Excel.
Associer les colonnes

Associer les colonnes

Associez chaque colonne détectée à un champ Personyze. Une clé est obligatoire — un Internal ID (ou SKU / Product Page URL). Associez le reste à leurs champs ; ajoutez éventuellement un prétraitement ou un masque pour nettoyer une valeur à l’entrée.

💡 La clé doit correspondre à la façon dont votre catalogue est indexé. « L’import passe mais ne correspond à rien » est presque toujours un problème de clé.
Vérifier et importer

Vérifier et importer

Confirmez l’association et lancez l’import. Un fichier se charge une fois ; un flux URL, SFTP ou API continue de se synchroniser à partir de là — relu environ toutes les quelques minutes pour que le stock, les prix et les nouveaux enregistrements restent à jour.

Terminé ✓

Choisir comment arrivent les données

Choisir comment arrivent les données

Allez à l’écran correspondant à ce que vous chargez — Paramètres → Recommandations → Catalogue produits / Catalogue d’articles / Suivi des produits, ou Paramètres → Attributs des visiteurs — et ouvrez Importer des données depuis un fichier ou un flux. Choisissez une source : importer un fichier (ponctuel), un flux URL / RSS / Atom ou SFTP (synchronisés), ou l’API JSON (en temps réel). Le même assistant partout — seuls les champs diffèrent.

💡 Un fichier est un instantané ; un flux URL, SFTP ou API se resynchronise selon un calendrier.
Formater le fichier

Formater le fichier

L’importateur est délimité par des virgules. Toute cellule qui contient elle-même une virgule — une liste de centres d’intérêt, plusieurs catégories — doit être entourée de guillemets doubles, sinon elle se découpe en colonnes supplémentaires. Tout le reste est du CSV ordinaire.

💡 Le compteur « Detected N columns » de l’étape suivante est votre contrôle d’analyse — fiez-vous à lui plutôt qu’à l’aspect du fichier dans Excel.
Associer les colonnes

Associer les colonnes

Associez chaque colonne détectée à un champ Personyze. Une clé est obligatoire — un Internal ID (ou SKU / Product Page URL). Associez le reste à leurs champs ; ajoutez éventuellement un prétraitement ou un masque pour nettoyer une valeur à l’entrée.

💡 La clé doit correspondre à la façon dont votre catalogue est indexé. « L’import passe mais ne correspond à rien » est presque toujours un problème de clé.
Vérifier et importer

Vérifier et importer

Confirmez l’association et lancez l’import. Un fichier se charge une fois ; un flux URL, SFTP ou API continue de se synchroniser à partir de là — relu environ toutes les quelques minutes pour que le stock, les prix et les nouveaux enregistrements restent à jour.

Terminé ✓
L’écran du catalogue de produits dans Personyze
Chaque catalogue sur un seul écran, chacun avec son propre état, sa dernière synchronisation et sa propre voie d’entrée. Ceux qui sont facultatifs l’indiquent. Cliquez pour agrandir.

L’écran du catalogue, et ce qu’il vous apprend

Paramètres → Recommandations → Catalogue produits (et Catalogue d’articles pour le contenu) n’est plus un simple formulaire d’import. C’est un tableau de tous les catalogues qui alimentent le moteur, chacun avec son état : « mes données sont-elles arrivées ? » se vérifie donc d’un coup d’œil plutôt qu’en réimportant :

Ligne Ce qu’elle contient
Flux actifs Ce qui maintient le catalogue synchronisé, et s’il est Opérationnel.
Catalogue de produits Les articles eux-mêmes, avec la dernière synchronisation.
Centres d’intérêt Le regroupement des produits par thème.
Catégories Les chemins de navigation qu’empruntent les visiteurs.
Liens de vente croisée / de montée en gamme manuels Des paires que vous définissez vous-même, par fichier ou à la main.
Ventes croisées générées par le système Des données d’amorçage, qui préparent le moteur jusqu’à ce que les données d’achat réelles prennent le relais.

Chaque ligne porte son propre état — Opérationnel, Configuré, Non défini, Non configuré — et tout, sauf le catalogue lui-même, est marqué facultatif : une première configuration voit ainsi ce qui est réellement obligatoire.

Les données arrivent dans chacun d’eux des quatre mêmes façons : un import de fichier, un flux URL, SFTP ou l’API REST. Chaque ligne propose son propre Upload file or set RSS/Atom feed : vous n’avez pas à chercher à quel écran appartient un catalogue donné.

Deux clés, pas une

Les produits peuvent être associés à jusqu’à deux clés — Internal ID et SKU — pour que les événements du site se rattachent quel que soit l’identifiant qu’émet votre site. Des champs personnalisés peuvent être ajoutés à tout moment ; rien n’a besoin d’être déclaré à l’avance.

Quelle colonne est votre Internal ID ?

Se tromper ici est l’erreur la plus coûteuse d’un flux : le catalogue se remplit, les recommandations s’affichent, et rien ne correspond à ce que les visiteurs ont réellement consulté. L’importateur répond donc avec des preuves plutôt qu’une supposition.

Il compare chaque colonne candidate avec les identifiants que votre site envoie déjà et indique ce qu’il a mesuré — « correspond à 96 % des identifiants que votre site envoie déjà », « aucune de ces valeurs n’apparaît dans ce que votre site envoie », « vérifié sur les 500 premières lignes ». Les colonnes qui ne peuvent pas du tout servir de clé — vides dans toutes les lignes échantillonnées, absentes de certaines lignes, identiques à une autre colonne — sont signalées comme telles.

Si aucun événement n’est encore arrivé, il se rabat sur d’autres méthodes, et indique sur laquelle il s’appuie :

  • Mesuré sur des événements réels — la réponse fiable.
  • Trouvé sur la page de l’article — « aucun événement n’est encore arrivé : nous avons donc lu l’une de vos pages d’article ».
  • Meilleure estimation d’après la seule forme du fichier — et il le dit : « vérifiez-la par rapport à ce que votre site envoie ».

{W}Associez l’URL en plus de l’identifiant. L’assistant recommande les deux — « Associez les deux : celle-ci comme Internal ID et celle-là comme Product Page URL » — car ils ne jouent pas le même rôle. L’identifiant est ce que portent les événements de panier et d’achat ; l’URL est ce qui permet de reconnaître une page d’arrivée comme une page produit. Si vous n’associez que l’identifiant, le ciblage des pages produit n’a rien sur quoi s’appuyer.

Prévisualiser avant d’importer

Le récapitulatif Prêt à importer propose Prévisualiser les changements — un essai à blanc qui n’écrit rien et vous dit ce que ferait l’import réel :

{I}Un nombre élevé de « nouvelles » lignes lors d’une réimportation est le signal d’alerte. Réimporter un catalogue que vous avez déjà devrait donner presque uniquement des lignes inchangées. Si presque toutes les lignes sont nouvelles, la colonne de clé est mauvaise, et c’est dans l’aperçu que cela devient évident, plutôt qu’une fois le catalogue doublé.

Quatre façons d’envoyer un flux

À la première étape de l’assistant (Source de l’import), vous choisissez comment les données arrivent dans Personyze. Le choix porte en réalité sur la fréquence à laquelle elles changent.

Les quatre façons d’envoyer un flux à Personyze : importer un fichier, un flux URL/RSS/Atom, un envoi SFTP ou un envoi par API JSON
1 Importer un fichier — CSV, TSV ou XLSX depuis votre ordinateur. Un instantané ; idéal pour les listes ponctuelles et les petits exports.
2 Flux URL / RSS / Atom — saisissez une URL publique ; Personyze l’interroge selon un calendrier (environ toutes les 10 minutes). Idéal pour un catalogue ou une liste tenus à jour par votre plateforme ou un service de flux.
3 Envoi SFTP — vous déposez des fichiers sur un point de terminaison SFTP configuré. Idéal pour de gros exports nocturnes depuis un entrepôt de données.
4 Envoi par API JSON — envoyez des enregistrements en POST depuis votre back-end, en temps réel.

Un flux URL, SFTP ou API en direct continue de se synchroniser après le premier import ; un import de fichier est un instantané que vous réimportez pour actualiser.

Dépôt de fichiers SFTP — déposez et oubliez

SFTP est l’option sans intervention. Vous obtenez un compte d’envoi privé, votre script d’export dépose les fichiers dans son dossier /upload , et chaque nouvel envoi est importé automatiquement quelques minutes après sa fin. Personne n’a rien à cliquer dans le panneau.

Où le trouver : vos identifiants SFTP se trouvent sous Paramètres → Profil du site, dans la section Dépôt de fichiers SFTP — c’est la page à ouvrir chaque fois qu’il vous faut l’hôte, le nom d’utilisateur ou un nouveau mot de passe. La même carte d’identifiants apparaît aussi partout où l’assistant d’import propose SFTP comme source : suivi des produits et des articles, écrans des catalogues de produits et d’articles, et attributs visiteur.

La section de dépôt de fichiers SFTP du profil du site : le bouton de configuration de l’accès SFTP, et un tableau associant des noms de fichiers comme products.csv et users.csv à ce qu’ils importent
Paramètres → Profil du site → Dépôt de fichiers SFTP. Un bouton configure le compte ; le tableau en dessous constitue toute la règle d’acheminement — le nom du fichier décide de ce que devient un envoi. Cliquez pour agrandir.

Configurer le compte

  1. Cliquez sur Configurer l’accès SFTP.
  2. Personyze crée un compte privé pour vous. Il indique « Configuration de votre compte SFTP — généralement moins de 5 minutes » pendant l’opération, et se remplit tout seul une fois prêt. Vous pouvez quitter la page et revenir.
  3. La carte affiche alors votre hôte (sftp://upload.personyze.com), votre nom d’utilisateur et votre mot de passe — avec les boutons Afficher et Copier.

Un seul compte sert à tous les types de fichiers ci-dessous, et il appartient à ce profil de site. Placez tous les fichiers dans le dossier /upload — rien d’autre n’est pris en compte.

La carte du compte d’envoi SFTP, avec l’hôte sftp://upload.personyze.com, un nom d’utilisateur, un mot de passe masqué avec les boutons Afficher et Copier, la consigne d’envoyer dans le dossier /upload et un lien pour renouveler le mot de passe
Une fois le compte créé, la carte affiche tout ce qu’il faut pour se connecter. Le mot de passe reste masqué tant que vous n’appuyez pas sur Afficher ou Copier. Cliquez pour agrandir.
Le mot de passe n’est récupéré que lorsque vous appuyez sur Afficher ou Copier, jamais avec la page elle-même — il reste hors du code source de la page et des journaux. Renouveler le mot de passe en émet un nouveau et l’ancien cesse de fonctionner en quelques minutes : mettez-le à jour dans votre tâche d’export en même temps. Si votre compte a été configuré manuellement par le support par le passé, aucun mot de passe enregistré ne peut être affiché ; renouvelez-le une fois et vous en aurez un visible.

Le nom du fichier décide de ce qu’est un envoi

Il n’y a aucune configuration par envoi. L’importateur achemine chaque fichier d’après son nom ; l’extension n’indique que le format. Le singulier et le pluriel fonctionnent tous deux — product.csv équivaut à products.csv.

Nom du fichier Importé dans
products.csv / product.csv Catalogue de produits
articles.csv / article.csv Catalogue d’articles
users.csv Listes d’utilisateurs importées (flux d’utilisateurs)
products_interactions.csv / product_interactions.csv Historique des interactions produit
articles_interactions.csv / article_interactions.csv Historique des interactions avec les articles
products_cross.csv / product_cross.csv Liens produit-produit
articles_cross.csv / article_cross.csv Liens article-article

Extensions acceptées : .csv, .json, .xml, .xls, .xlsx. Réimporter un fichier plus récent le réimporte — le fichier correspondant le plus récent l’emporte — : une tâche nocturne peut donc simplement écraser le même nom à chaque fois.

Le premier envoi : l’associer une fois

Un fichier doit être associé avant que quoi que ce soit n’en soit importé — il faut indiquer à Personyze quelle colonne contient quoi. Vous ne le configurez pas à l’avance : déposez d’abord le fichier, et le panneau vient à vous.

Quelques minutes après la fin de l’envoi, un bandeau apparaît sur l’écran de destination — pour users.csv il s’agit de Paramètres → Attributs des visiteurs, sous Listes d’utilisateurs importées :

Dans votre dossier SFTP : users.csv
1 Ko · envoyé il y a 36 min
Pas encore associé : rien n’en est donc importé. Personyze ne sait pas encore quelle colonne du fichier contient quoi.

Deux boutons se trouvent à côté : Vérifier à nouveau, qui analyse à nouveau le dossier, et Mapper ce fichier, qui ouvre l’association.

La boîte de dialogue d’association

Associer « users.csv » depuis votre dossier SFTP affiche tout ce qu’elle a déduit du fichier lui-même :

Cliquez sur Enregistrer le mappage et le fichier est importé. C’est une étape unique par nom de fichier — à partir de là, chaque envoi de users.csv s’importe tout seul avec la même association.

Tant qu’un fichier n’est pas associé, rien ne se passe — et rien ne prévient votre script. L’envoi lui-même a réussi : une tâche d’export voit donc un succès pendant que les données restent non lues. Si vous avez envoyé un fichier et que les chiffres n’ont pas bougé, ouvrez l’écran de destination et cherchez le bandeau ci-dessus.
Une fois un flux en service, vous pouvez activer M’envoyer un email si ce flux cesse de se synchroniser sur le même écran — le moyen le plus simple d’apprendre que l’export de la nuit dernière n’est jamais arrivé. La liste des sources peut aussi être filtrée selon leur provenance : Importé, RSS / Atom, SFTP ou Envoi API.

La règle de format la plus importante

L’importateur de fichiers de Personyze est délimité par des virgules, et cela ne peut pas être modifié à l’étape d’import. Ce seul fait détermine toutes les décisions de formatage :

C’est du CSV standard, mais c’est la raison la plus fréquente d’un import qui se comporte mal : cela vaut donc la peine de le dire clairement.

Exemple concret : centres d’intérêt produits

Les centres d’intérêt sont une liste de tags par produit — utilisés pour les ventes croisées, les segments d’affinité et les recommandations basées sur les centres d’intérêt. Le format qui fonctionne comporte deux colonnes, Id et Interest, avec les centres d’intérêt séparés par des virgules dans une cellule entre guillemets :

Id,Interest
NW-1001,"Sneakers,Footwear,Casual,Running"
NW-1002,"Backpack,Bags,Commuting,Canvas"
NW-1003,"Headphones,Audio,Wireless,Electronics"

La cellule Interest de chaque produit contient un ensemble de tags différent. Ce sont les guillemets qui permettent aux virgules intérieures de survivre. Sans eux, NW-1001,"Sneakers,Footwear,Casual,Running" devient cinq colonnes au lieu de deux, et l’import échoue.
📥 Téléchargez le fichier d’exemple des centres d’intérêt — ouvrez-le dans un éditeur de texte simple (pas un tableur) pour voir les guillemets exactement comme l’importateur en a besoin.

Séparateurs — ce qui fonctionne et ce qui ne fonctionne pas

Objectif Ça fonctionne ? Comment
Centres d’intérêt séparés par des virgules dans une cellule Oui Mettez la cellule entre guillemets : "Sneakers,Footwear,Running"
Centres d’intérêt répartis sur une colonne chacun Oui Associez chaque colonne de centre d’intérêt au même champ Intérêts
Barre verticale / oblique / point-virgule entre les centres d’intérêt Non Le champ Centres d’intérêt n’accepte que les virgules
Point-virgule comme délimiteur de colonnes Non L’étape d’import est verrouillée sur la virgule
Virgules sans guillemets dans une cellule Non L’importateur les découpe en nouvelles colonnes

Remarque sur le TSV : l’assistant accepte les fichiers .tsv, et un vrai flux séparé par des tabulations (comme un flux Google Shopping) s’importe proprement — les tabulations sont le délimiteur, les virgules dans les descriptions sont donc du simple texte. La règle des virgules ci-dessus concerne spécifiquement les fichiers séparés par des virgules.

Le même principe pour un champ de catégorie

Le principe de la virgule dans une cellule entre guillemets ne vaut pas que pour les centres d’intérêt — tout champ qui contient plus d’une valeur fonctionne de la même façon. Un champ catégorie est le deuxième cas courant. Deux façons de le représenter, toutes deux valides :

La règle est toujours la même : une virgule dans une valeur impose de mettre la cellule entre guillemets. Un chemin délimité par >, ou un chemin délimité par /, ne contient pas de virgules : il passe donc sans guillemets.

Transporter des champs supplémentaires dans le même fichier

Vous n’avez pas besoin d’un fichier distinct par attribut. Une même ligne peut porter la clé, les centres d’intérêt, la catégorie et tout ce que vous voulez dans l’enregistrement — marque, disponibilité, un tag personnalisé — et vous associez chaque colonne à l’étape Choisir les colonnes :

Id,Interest,Category,Brand,Availability
NW-1001,"Sneakers,Footwear,Casual,Running",Footwear > Sneakers,Acme Footwear,in stock
NW-1003,"Headphones,Audio,Wireless,Electronics",Electronics > Audio > Headphones,Soundry,in stock

Seules les cellules Interest contiennent des virgules : ce sont donc les seules entre guillemets ; le reste passe en colonnes ordinaires. Associez Id → Internal ID, Interest → Interests, et chaque colonne restante à son champ Personyze.

📥 Téléchargez l’exemple étendu (Id + Interest + Category + Brand + Availability), à côté de l’exemple des centres d’intérêt à deux colonnes.

Association obligatoire

Chaque import nécessite une colonne de clé, sinon Suivant reste désactivé avec un message rouge « Missing required mapping » :

La clé doit correspondre à celle sur laquelle le catalogue est déjà indexé. Si votre catalogue est indexé sur le SKU, la colonne Id du fichier doit contenir ce même SKU. Un import qui se termine mais « ne correspond à aucun produit » est presque toujours un problème de clé — les identifiants se sont bien chargés, ils ne concordent simplement pas.

Associer les colonnes

À l’étape Choisir les colonnes, Personyze affiche chaque colonne détectée et vous permet de l’associer à un champ Personyze, avec un prétraitement et un masque facultatifs par colonne.

L’étape d’association des colonnes de l’assistant d’import de Personyze, associant chaque colonne du fichier à un champ Personyze avec des options de prétraitement et de masque
L’étape d’association des colonnes. Personyze indique combien de colonnes il a détectées et affiche des lignes d’exemple, pour que vous confirmiez que le fichier a été correctement analysé avant d’associer.

Le nombre de colonnes à cette étape est votre contrôle d’analyse. Pour le fichier de centres d’intérêt à deux colonnes, il doit indiquer Detected 2 source columns. S’il indique 6, les guillemets ont été perdus à l’export — corrigez et réimportez. Jugez d’après ce qu’indique cette étape, pas d’après l’aspect du fichier dans Excel ou Numbers.

Pour les centres d’intérêt : associez Id → Internal ID (ce qui supprime l’erreur rouge), associez Interest → Intérêts, laissez Preprocessing = Transmettre tel quel et Mask = Tout transmettre, puis passez à Prêt pour l’import.

Construire le fichier (recette reproductible)

Si vous avez un export source avec une colonne de centres d’intérêt reliés par des virgules, produisez le fichier à deux colonnes entre guillemets avec quelques lignes de Python — csv.writer ajoute automatiquement les guillemets autour de tout champ contenant une virgule :

import csv
rows = list(csv.DictReader(open('source.csv', encoding='utf-8-sig')))
with open('Id_Interest.csv', 'w', newline='', encoding='utf-8-sig') as f:
    w = csv.writer(f)                 # quotes cells with commas automatically
    w.writerow(['Id', 'Interest'])
    for r in rows:
        ints = ','.join(x.strip() for x in r['Interests'].split(',') if x.strip())
        w.writerow([r['Product ID'], ints])

Flux de catalogue de produits

Un catalogue de produits est indexé sur un identifiant de produit — et vous pouvez fournir Internal ID, SKU ou les deux. Seule une clé est obligatoire.

Quand vous n’avez pas d’identifiant produit

Si votre catalogue n’a pas d’identifiant stable, Personyze peut en générer un automatiquement à partir d’un hachage de l’URL de la page produit. Cela suffit à reconnaître un produit pour les pages vues et les ajouts au panier — l’URL est la même à chaque fois, le hachage est donc stable.

C’est au suivi des achats qu’un hachage d’URL devient délicat. Une page de remerciement ou de confirmation de commande ne porte généralement pas les URL des produits achetés : il n’y a donc rien à hacher. Suivre les achats sur des identifiants hachés est possible, mais la configuration est laborieuse. C’est bien plus simple avec un vrai identifiant produit que Personyze peut récupérer automatiquement dans une variable de la page — une valeur du data layer, une variable du gestionnaire de balises ou un champ du DOM — car ce même identifiant relie alors le catalogue, le comportement sur le site et l’achat. Si vous vendez, utilisez un vrai identifiant. Le repli par hachage d’URL sert à la personnalisation sur les vues et les clics quand aucun identifiant n’existe.

Le fichier du catalogue

Un catalogue de produits utilise plus de colonnes, mais les mêmes règles. Une disposition typique :

Internal ID, SKU, Title, Product Page URL, Main Image URL,
Price, Sale Price, Is in Stock, Rating

Associez Internal ID comme clé, Main Image URL et Product Page URL pour que les cartes s’affichent et renvoient vers le produit, et Price / Sale Price / Is in Stock pour que les widgets puissent afficher les prix, les remises et les badges de stock. Les cellules vides ne posent pas de problème — un Sale Price vide signifie simplement pas de remise.
📥 Téléchargez le fichier d’exemple de catalogue de produits — la vraie disposition de colonnes utilisée par une boutique en ligne.
Pour un catalogue en direct, la configuration pratique est un flux URL : faites pointer Personyze vers un flux que votre plateforme ou un service de flux produit déjà. Un flux Google Shopping / Merchant standard (TSV, avec id, title, link, price, availability, image_link, product_type, etc.) fonctionne directement — Personyze lit ces colonnes et réinterroge l’URL pour que le stock et les prix restent à jour. Si vous n’avez pas encore de flux, des outils comme Feedoptimise, DataFeedWatch ou l’export natif de votre plateforme en produisent un.

La logique de recommandation — meilleures ventes, vus ensemble, basée sur le panier, basée sur les centres d’intérêt — se règle dans la configuration de l’algorithme de l’action et lit le catalogue que vous fournissez ici. Consultez Configurer le flux de produits / de contenus et Algorithmes de recommandation de produits.

Images : une obligatoire, d’autres facultatives

Chaque produit a besoin d’une image principale pour que les cartes de recommandation puissent s’afficher. Vous pouvez ajouter d’autres colonnes d’images — les images supplémentaires alimentent les widgets qui font tourner ou changent la photo au survol de la souris. Associez la première à Main Image URL et les autres aux champs d’images supplémentaires.

Transportez autant de champs personnalisés que vous le souhaitez

Au-delà des colonnes standard, une ligne de flux peut contenir toutes les données supplémentaires dont vous disposez — frais de livraison, prix dégressifs, prix par type de client, tags, marque, couleur, n’importe quoi. Trois usages possibles d’un champ personnalisé :

La plupart du temps, il s’agit d’attributs simples comme la marque ou la couleur ; il n’y a pas de limite, et les colonnes non associées sont simplement ignorées.

Achats groupés / prix conditionnels

Vous pouvez aussi transporter un prix par combinaison dans le flux — un prix remisé qui s’applique quand des produits précis sont achetés ensemble — pour que le prix d’un lot vienne directement du catalogue au lieu d’être calculé. Le principe et la configuration sont décrits dans Remise « achetés ensemble » pour les recommandations e-commerce. (La disposition exacte des colonnes pour les prix par combinaison sera ajoutée ici.)

Flux de catalogue de contenus

Un catalogue de contenus (articles, vidéos, guides) alimente les recommandations de contenu. La version la plus légère est simplement l’URL du contenu — Personyze génère automatiquement un identifiant et suit l’engagement par l’URL ou le chemin de l’URL : les vues et les lectures sont donc correctement attribuées sans que vous fournissiez de clé. Vous pouvez aussi fournir votre propre Internal ID si vous en avez un.

Tout le reste fonctionne comme le catalogue de produits : une image principale (d’autres facultatives pour les widgets au survol), plus toutes les colonnes personnalisées que vous voulez afficher, filtrer ou utiliser pour l’entraînement — type de contenu, catégorie, auteur, date de publication, tags.

📥 Télécharger le modèle de catalogue de contenus

Flux de listes d’utilisateurs (enrichissement CRM pour le ciblage)

Une liste d’utilisateurs rattache des données CRM à vos visiteurs. Le minimum est une clé plus un attribut :

Vous pouvez ajouter autant de colonnes d’attributs que vous le souhaitez. Le point important : tout ce que vous renseignez ici devient disponible pour le ciblage, et pas seulement dans l’action qui utilise la liste. Chargez le prénom ou le type de compte d’un visiteur, et vous pourrez ensuite créer une audience qui cible dessus — « Type de compte est VIP », « Secteur est Commerce de détail » — exactement comme n’importe quel autre champ de profil. Envoyez-la sous forme de fichier, ou maintenez-la synchronisée via SFTP ou une URL de flux.

📥 Téléchargez le modèle minimal de liste d’utilisateurs (e-mail + prénom)  ·  version étendue (avec type de compte, secteur).

Paires de ventes croisées et de montée en gamme (dans le catalogue de produits)

Où : Paramètres → Recommandations → Catalogue produits. Sous les flux et les champs, l’écran du catalogue comporte deux sections facultatives pour indiquer à Personyze quels produits vont ensemble. Les deux sont facultatives — le moteur apprend aussi les associations de lui-même à partir du comportement réel — mais elles sont utiles pour démarrer avant d’avoir des données, ou pour les associations que vous voulez contrôler à la main.

L’écran du catalogue de produits montrant le catalogue ainsi que les sections des liens de vente croisée manuels, des liens de montée en gamme manuels et des ventes croisées générées par le système (données d’amorçage)
L’écran du catalogue de produits (Paramètres → Recommandations → Catalogue produits) : votre catalogue, plus les sections facultatives Liens de vente croisée manuels, Liens de montée en gamme manuels et Ventes croisées générées par le système (données d’amorçage). Cliquez pour agrandir.

Liens de vente croisée / de montée en gamme manuels (facultatif)

Des associations explicites que vous définissez vous-même — les liens « fréquemment achetés ensemble » ou « vous aimerez aussi ». Elles sont utilisées quand l’algorithme d’une campagne de recommandation est réglé sur « Cross-sell (manual) » ou « Up-sell (manual) » :

Ajoutez des paires à la main, ou importez un fichier — un lien par ligne, le produit de départ et le produit lié tous deux par leur identifiant interne. Les liens sont directionnels : pour recommander dans les deux sens, ajoutez les deux lignes :

Subject Internal ID,Linked Internal ID
AQB14X,AQB15X
AQB15X,AQB14X
BARR4FJ3,LABAR4114

📥 Télécharger le modèle de vente croisée / montée en gamme

Ventes croisées générées par le système — données d’amorçage (facultatif)

Un moyen d’amorcer le moteur de recommandation avant qu’il n’ait vu de vrais achats. Vous ajoutez des ensembles d’amorçage : indiquez à Personyze qu’une paire de produits a été achetée ensemble, et il les recommande l’un pour l’autre jusqu’à ce que les données d’achat réelles prennent le relais. Chaque ensemble se compose d’un article Subject, d’un article Recommended et de l’interaction qu’il simule — « Purchased → Purchased » amorce les ventes croisées « achetés ensemble ». Idéal pour un catalogue tout neuf sans données comportementales ; dès que de vrais achats arrivent, ils l’emportent naturellement sur les données d’amorçage.

La boîte de dialogue de nouvel ensemble d’amorçage, avec les réglages Subject, Recommended, Interaction, Rate, utilisateurs et transactions
1. Créez un ensemble d’amorçage. Sur la carte des ventes croisées générées par le système, cliquez sur Nouveau jeu d’amorçage. Chaque ensemble associe un produit Subject à un produit Recommended ; choisissez l’Interaction simulée (« Purchased → Purchased » amorce les ventes croisées « achetés ensemble »), et définissez éventuellement le taux, le nombre d’utilisateurs et les transactions. Cliquez pour agrandir.
Le formulaire d’ensemble d’amorçage rempli avec Subject SKU-1001 et Recommended SKU-1002
2. Choisissez les produits. Choisissez les produits Subject et Recommended dans la liste avec recherche (les deux doivent déjà être dans le catalogue) — chaque combinaison devient un ensemble d’amorçage — puis cliquez sur Ajouter un jeu d’amorçage. Cliquez pour agrandir.
La liste des ensembles d’amorçage montrant deux ensembles configurés, avec les vignettes des produits et leurs réglages
3. Il apparaît dans la liste — la carte passe à Configuré et chaque ensemble affiche sa paire (avec vignettes), l’interaction, le taux et les nombres d’utilisateurs / de transactions. Le moteur recommande désormais la paire jusqu’à ce que les données d’achat réelles prennent le relais. Cliquez pour agrandir.

Flux de transactions historiques

Où : Paramètres → Recommandations → Suivi des produits → Importer les achats passés. Procédure pas à pas : Importer des transactions passées / hors ligne.

Importer les achats passés permet à Personyze d’entraîner les recommandations sur de vrais comportements d’achat et de cibler l’historique d’achats dès le premier jour, avant d’avoir observé ces achats en direct. Chaque ligne est légère — juste de quoi dire qui a acheté quoi, et quand :

Ni titre, ni quantité, ni prix, ni devise ne sont nécessaires — Personyze les lit dans le catalogue. Pour l’horodatage, utilisez une date-heure standard comme 2026-07-21 14:30:00 ou un horodatage Unix comme 1751389200. (En cas de doute, confirmez le format exact accepté avec votre gestionnaire de compte.)

📥 Télécharger le modèle de transactions

Catalogues de contenus et autres flux

Au-delà des types ci-dessus, le même assistant charge n’importe quelle donnée tabulaire — tables d’affinité, listes de segments, ensembles d’attributs personnalisés. Choisissez la méthode d’envoi, soignez le format, associez une clé, associez le reste.
Un catalogue de contenus (articles, vidéos, guides) fonctionne de la même façon — les colonnes clés deviennent l’identifiant et l’URL du contenu, avec le titre, l’image et tous les attributs sur lesquels vous voulez recommander ou cibler. Il en va de même pour les tables de ventes croisées, les données d’affinité et les listes d’utilisateurs CRM : choisissez la méthode d’envoi, soignez le format, associez une clé, associez le reste.

Terminer l’import

La dernière étape de l’assistant d’import de Personyze, prête à lancer l’import
La dernière étape : vérifiez l’association et lancez l’import. Un fichier est un chargement ponctuel ; un flux URL, SFTP ou API continue de se synchroniser selon son calendrier à partir de là.

Dépannage

Symptôme Cause Solution
« Detected 6 source columns » (2 attendues) La cellule des centres d’intérêt n’était pas entre guillemets, ou les guillemets ont été supprimés à l’export Réexportez avec la cellule entre guillemets ; vérifiez que le fichier brut affiche "Sneakers,Footwear,..."
Toute la ligne tombe dans une seule colonne Vous jugez d’après un tableur, pas d’après l’importateur Fiez-vous à ce qu’indique l’étape 2/3, pas à Excel ou Numbers
« Missing required mapping » (en rouge) Aucun Internal ID / Product Page URL n’est associé Associez votre colonne de clé à Internal ID (ou Product Page URL)
Les centres d’intérêt s’importent comme une longue chaîne Le séparateur n’est pas une virgule Utilisez des virgules entre les centres d’intérêt, rien d’autre
L’import passe mais ne correspond à aucun produit L’Id ne correspond pas à la clé du catalogue Utilisez l’identifiant sur lequel le catalogue est indexé (souvent le SKU)

Lire plutôt une valeur en direct sur la page

Indépendamment de l’import de fichiers, Personyze peut aussi lire une valeur en direct sur une page produit pendant la navigation des visiteurs — utile quand la donnée ne figure pas dans un flux. Cette méthode utilise un sélecteur CSS ou du JavaScript plutôt qu’un fichier ; elle est décrite dans Capturer des données sur votre site. Deux remarques de terrain à retenir :

En bref

Fichier délimité par des virgules ; mettez entre guillemets toute cellule contenant une virgule ; associez une colonne de clé (Internal ID ou Product Page URL) qui correspond à la façon dont votre catalogue est indexé ; associez le reste. Importez un fichier pour un chargement ponctuel, ou faites pointer Personyze vers un flux URL / SFTP / API pour le garder synchronisé.

Voir aussi

Did this page answer your question?
Thank you — that goes to whoever maintains this page.