Passer au contenu principal
Les fonctionnalités de recommandation de produits sont une fonctionnalité premium. Contactez votre Customer Success Manager pour les activer sur votre compte Kameleoon. Accédez à l’espace Product recommendations en naviguant vers Settings > Recommendations.
Une stratégie de recommandation définit la manière dont vous sélectionnez et filtrez les produits à afficher. Lorsque vous créez une stratégie, saisissez un nom et une description, puis définissez le nombre maximum de produits à afficher dans le bloc. Après avoir enregistré la stratégie, configurez ses règles, ses modèles et son design.
Cliquez sur Recommendations > Recommendation strategy. Cliquez ensuite sur votre bloc de recommandation > Copy code pour générer le snippet de votre bloc. Collez-le dans le code source de votre page à l’endroit où vous souhaitez que le bloc apparaisse.Vous pouvez également utiliser l’Activation API de Kameleoon pour servir des recommandations de produits. L’API utilise la dernière version enregistrée du modèle et renvoie un objet JSON contenant les produits recommandés et le HTML du modèle. La réponse de l’API n’inclut pas de CSS ; vous devez appliquer manuellement le style à la sortie.Lors de l’implémentation du code de votre bloc, incluez le paramètre data-recommender-code (ID du bloc de recommandation de produits). Pour les blocs utilisant des algorithmes tels que Similar et They also buy this, incluez le paramètre data-recommender-item pour spécifier l’ID du produit courant.
Si vous constatez un écart important entre votre inventaire total et le nombre de produits disponibles pour la recommandation par les algorithmes Popular ou Trending (étiquetés produits Widgetable), ces algorithmes ont des exigences strictes en matière de qualité des données.Pour qu’un produit soit widgetable et éligible aux recommandations, vous devez configurer et importer correctement les quatre champs critiques :
  • Prix
  • Nom
  • URL
  • Image (l’URL de l’image doit être valide et récupérable)
Si l’un de ces attributs essentiels est manquant ou incorrect (par exemple, une URL d’image cassée), Kameleoon filtre le produit, qui n’apparaîtra pas dans les résultats de l’algorithme de recommandation.Comment dépanner les images manquantesUne raison fréquente pour laquelle un produit n’est pas widgetable est que Kameleoon n’a pas pu télécharger l’image lors du processus de synchronisation du catalogue.Principales raisons pour lesquelles les images ne peuvent pas être téléchargéesSi votre produit a une URL d’image valide mais ne contient toujours pas d’image, la configuration du serveur de votre boutique peut être à l’origine du problème :
  • Surcharge du serveur : le stockage ou le serveur de votre boutique ne peut pas gérer le volume élevé de requêtes provenant du système Kameleoon. Le système télécharge les images en utilisant 50 threads simultanés, ce qui provoque souvent des erreurs de délai d’attente.
  • Blocage de sécurité : votre pare-feu ou votre protection anti-DDoS peut bloquer les requêtes en fonction du user agent ou de l’adresse IP.
    • User agent : Kameleoon télécharge les images en utilisant le user agent Kameleoon Fetcher 2.0. Si les téléchargements échouent, autorisez ce user agent dans les paramètres de votre serveur.
    • Adresse IP : mettez en liste blanche toutes les IP du cluster Kameleoon pour garantir un accès ininterrompu. Consultez la liste des IP ici.
Comment trouver les produits problématiquesIdentifiez quels produits manquent des champs de données requis en accédant à votre Products Database.
  1. Cliquez sur Settings > Recommendations > Products > Data feed.
  2. Sélectionnez False dans la liste déroulante Widgetable.
  3. Cliquez sur n’importe quel produit pour voir ses attributs. Kameleoon met en évidence le problème (par exemple, prix manquant ou échec de la récupération de l’image) dans la liste des attributs du produit.
Rappel sur la fenêtre temporelle de l’algorithmeLors du dépannage des résultats, notez que l’algorithme Trending calcule les recommandations strictement sur la base des commandes de vente dans la fenêtre temporelle que vous avez sélectionnée. L’algorithme exclut les ventes plus anciennes que cette durée.
Personnalisez la fréquence et le moment spécifique des mises à jour de votre flux de données produits dans Store settings.
Non. Actuellement, les recommandations de produits prennent en charge uniquement les canaux web et app. Vous ne pouvez pas envoyer de widgets de recommandation dynamiques directement vers des modèles d’e-mail.
Oui, vous pouvez prévisualiser et simuler vos recommandations de produits sur votre site web à l’aide du Widget Studio.Pour ce faire, créez un widget contenant votre bloc de recommandation de produits, puis ajoutez-le à votre expérience. Une fois configuré, utilisez la fonctionnalité de simulation du Widget Studio pour visualiser le widget. La simulation vous permet de vérifier à la fois le design et les produits renvoyés par l’algorithme avant le lancement.
Oui. Vous pouvez appliquer des critères de tri aux produits renvoyés par un algorithme. Par exemple, vous pouvez trier les résultats affichés par chiffre d’affaires le plus élevé afin de prioriser les articles à forte valeur.
Non. Les expressions régulières (regex) ne sont actuellement pas disponibles pour définir une logique de correspondance complexe dans les règles de recommandation.
Non. La plateforme ne prend pas en charge le Bring Your Own Algorithm (BYOA). Utilisez la suite d’algorithmes intégrés fournis par Kameleoon.
Bien que Kameleoon n’impose pas de limite stricte, demander de nombreux produits affecte les performances de l’algorithme et augmente les temps de réponse. Affichez moins de 50 produits par bloc. Pour afficher des ensembles de produits plus importants, utilisez les Collections.
Non, certains algorithmes ne fonctionnent que dans des conditions spécifiques. Par exemple, l’algorithme Similar products, l’algorithme Products usually purchased with this item et l’algorithme Store recommendations ne fonctionnent que sur les pages de détail produit. L’algorithme Products usually viewed with this product ne fonctionne que si le panier contient des articles.
Oui. Vous pouvez utiliser la taille du produit comme variable HTML dans votre modèle, à condition que la taille apparaisse en tant que paramètre dans le flux de données.
Non. L’algorithme Store Recommendations exige spécifiquement le champ accessories dans votre flux de données. Il ne reconnaît pas les noms de champ personnalisés pour les relations manuelles entre produits.Pour lier manuellement des produits (par exemple, pour afficher des articles complémentaires), mappez les ID des produits associés au champ accessories.L’algorithme affiche uniquement les produits liés via la balise accessories. Vous pouvez restreindre davantage ces résultats en appliquant des filtres standards au bloc de recommandation (par exemple, pour exclure les articles en rupture de stock de la liste manuelle).
Pour utiliser l’algorithme Currently on wishlist, suivez explicitement le moment où un utilisateur ajoute un article à sa liste de souhaits. Le moteur de recommandation ne détecte pas automatiquement ces interactions sans un signal d’API spécifique.Implémentez la méthode trackAddToWishList() de l’Activation API. Cette méthode envoie les données d’événement nécessaires à Kameleoon, qui alimente l’algorithme de liste de souhaits.
Les attributs pris en charge dépendent du format de votre flux. Notez les limitations suivantes concernant les étiquettes et les données de stock :Étiquettes personnalisées (custom_label_0 - custom_label_4)
  • Non prises en charge.
  • Le module de recommandation n’importe pas les attributs custom_label des flux Google Merchant Center. Vous ne pouvez pas utiliser ces champs pour le filtrage ou l’affichage.
Quantité en stock (stockquantity)
  • Flux Google Merchant : Non pris en charge. La spécification de données produit Google n’inclut pas de comptage numérique du stock (uniquement le statut “availability”). Par conséquent, vous ne pouvez pas importer les nombres d’inventaire exacts via Google CSV/XML.
  • XML Kameleoon : Pris en charge. Pour utiliser des comptages de stock exacts, utilisez le format XML Kameleoon natif et renseignez le champ stockquantity.
  • Affichage et utilisation des données de stock : si vous importez des données de stock via XML Kameleoon, les valeurs apparaissent dans la vue d’ensemble Data feed. Utilisez l’attribut stockquantity pour créer des filtres (par exemple, stockquantity > 5).
Basez votre décision sur la taille de votre catalogue et votre infrastructure technique. Utilisez la méthode XML import si votre catalogue contient moins de 50 000 produits et que vous n’avez pas de data layer sur votre site web. À l’inverse, utilisez la Product Recommendation API si votre catalogue dépasse 50 000 produits.