Au-delà des transactions en ligne que Personyze suit en temps réel, vous pouvez lui fournir vos transactions passées ou hors ligne. Comme les recommandations reposent sur des statistiques de transactions, importer l’historique améliore vos recommandations et vous permet d’exploiter les ventes en magasin, par téléphone, ou de tout canal que Personyze ne voit pas sur le site.
Pourquoi importer les transactions passées ?
Généralement pour donner un coup d’accélérateur à un nouveau compte Personyze. Sinon, les recommandations mettent un certain temps à devenir pertinentes, car elles se construisent à mesure que Personyze suit les interactions des clients à partir du jour de l’installation. Indiquer quels utilisateurs ont acheté quels produits par le passé permet d’atteindre la pertinence bien plus vite.
Pourquoi importer les transactions hors ligne ?
Pour enrichir les recommandations avec les ventes que Personyze ne peut pas observer sur votre site — achats en magasin, données de caisse, commandes par téléphone. Comme il s’agit généralement d’une source continue plutôt que d’un chargement unique, elle est idéalement fournie sous forme de flux récurrent (RSS/Atom, flux par URL ou SFTP) qui se met à jour en permanence.
Ce que doit contenir chaque ligne
Chaque ligne indique qui a acheté quoi, et quand. Dans l’assistant, les champs obligatoires sont marqués d’un astérisque :
- Heure ou ID de transaction (obligatoire) — la date et l’heure de l’achat, ou un ID de commande. Si plusieurs articles partagent un même ID de commande, Personyze apprend qu’ils ont été achetés ensemble (et les recommande ensemble une fois que cela arrive assez souvent). Pour un horodatage, utilisez un format date-heure standard comme
2026-07-21 14:30:00ou une époque Unix comme1751389200. - E-mail de l’utilisateur ou ID interne de l’utilisateur (l’un des deux est obligatoire) — la clé qui relie chaque transaction à un seul client. L’e-mail sert aussi de clé pour les campagnes de recommandation par e-mail (par ex. des e-mails de vente croisée selon ce qui a été acheté). Un ID CRM/interne fonctionne tout aussi bien ; il vous en faut un seul des deux.
- ID interne du produit (obligatoire) — l’ID propre à chaque produit. Il doit correspondre à la clé de votre catalogue de produits ; à défaut d’ID produit, l’URL de la page produit peut le remplacer.
- Quantité et Montant (facultatifs) — incluez-les si vous les avez ; sinon, Personyze lit les détails du produit comme le titre et le prix dans votre catalogue.
Où l’importer
Allez dans Paramètres → Recommandations → Suivi des produits et ouvrez l’assistant Importer les événements d’achat passés. Il comporte trois étapes.
Étape 1 — Source de l’import. Choisissez comment les données parviennent à Personyze :
- Importer un fichier — un CSV ou TSV depuis votre ordinateur (jusqu’à 50 Mo). Un instantané ponctuel ; idéal pour charger l’historique.
- Flux par URL — une URL HTTP(S) qui renvoie du CSV/JSON (ou un flux RSS/Atom). Personyze l’interroge selon un calendrier, pour que les nouvelles transactions continuent d’arriver. Idéal pour les ventes hors ligne continues.
- Dépôt SFTP — déposez votre fichier dans le dossier
/uploadsursftp://upload.personyze.com; il apparaît dans l’assistant dès qu’il est détecté. Idéal pour les gros exports nocturnes. Configurez vos propres identifiants en quelques clics avec Configurer l’accès SFTP — voir Obtenir vos identifiants SFTP. - API JSON — envoyez les enregistrements en POST directement depuis votre backend vers l’endpoint des transactions (
social_site_db_products_interactions_archive). Voir la documentation de l’API.
Étape 2 — Choisir les colonnes. Personyze lit votre ligne d’en-tête et associe automatiquement ce qu’il reconnaît ; ajustez le reste. Associez au moins les trois champs obligatoires (heure ou ID de transaction, ID interne du produit, et e-mail ou ID interne de l’utilisateur). Chaque colonne dispose d’un prétraitement facultatif (par exemple, supprimer un symbole monétaire ou les séparateurs de milliers) et d’un aperçu d’échantillon en direct.
Étape 3 — Prêt pour l’import. Confirmez et lancez. Un fichier se charge une fois ; une source URL, SFTP ou API peut être conservée comme flux récurrent — elle se réimporte selon un calendrier et apparaît sous Flux actifs sur l’écran Suivi des produits, où vous pouvez la réimporter, modifier le mappage ou changer ses réglages à tout moment.
Voir aussi
- Importer des flux et fichiers de données — l’assistant d’import commun, les règles de format et un modèle de transactions à télécharger.
- Configurer le flux de produits / de contenu — le catalogue auquel ces transactions sont associées.