> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Trouvez les réponses aux questions courantes sur les fonctionnalités de recommandation de produits et de merchandising, y compris la configuration, les algorithmes, la configuration du flux et les limitations.

<AccordionGroup>
  <Accordion title="Comment activer et accéder aux fonctionnalités de recommandation de produits ?">
    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**.
  </Accordion>

  <Accordion title="Qu'est-ce qu'une stratégie de recommandation de produits ?">
    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.
  </Accordion>

  <Accordion title="Comment publier une stratégie de recommandation sur mon site web ?">
    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](../../developer-docs/apis/activation-api-js/api-reference/api-reference#obtainrecommendedproducts) 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.
  </Accordion>

  <Accordion title="Pourquoi le nombre de produits recommandés est-il bien inférieur à mon stock total de produits ?">
    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 manquantes**

    Une 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ées**

    Si 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](./recommendations/import-your-product-catalog-feed#syncing-your-product-feed-using-an-xml-file).

    **Comment trouver les produits problématiques**

    Identifiez 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'algorithme**

    Lors 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.
  </Accordion>

  <Accordion title="À quelle fréquence le flux de données produits est-il mis à jour ?">
    Personnalisez la fréquence et le moment spécifique des mises à jour de votre flux de données produits dans **Store settings**.
  </Accordion>

  <Accordion title="Puis-je utiliser les recommandations de produits dans des campagnes par e-mail ?">
    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.
  </Accordion>

  <Accordion title="Existe-t-il un mode de prévisualisation pour les recommandations ?">
    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](./recommendations/use-a-product-recommendation-block-in-a-campaign#use-a-product-recommendation-block-in-an-experiment). Une fois configuré, utilisez la [fonctionnalité de simulation](../assets/widgets/create-a-widget-with-the-widget-studio/simulate-your-widgets) 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.
  </Accordion>

  <Accordion title="Puis-je trier les produits recommandés ?">
    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.
  </Accordion>

  <Accordion title="Puis-je utiliser des expressions régulières dans les règles de recommandation ?">
    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.
  </Accordion>

  <Accordion title="Puis-je importer mon propre algorithme 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.
  </Accordion>

  <Accordion title="Existe-t-il une limite au nombre de recommandations que je peux afficher ?">
    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](./merchandising/activate-and-deploy-a-product-collection-on-your-website).
  </Accordion>

  <Accordion title="Tous les algorithmes fonctionnent-ils partout sur mon site ?">
    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.
  </Accordion>

  <Accordion title="Puis-je utiliser les tailles de produits importées depuis Google Merchant dans les modèles de recommandation Liquid ?">
    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.
  </Accordion>

  <Accordion title="Puis-je utiliser un nom de champ personnalisé (comme `shop_recommend`) pour l'algorithme Store Recommendations ?">
    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).
  </Accordion>

  <Accordion title="Comment fournir les données pour l'algorithme de recommandation 'Currently on wishlist' ?">
    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](../../developer-docs/apis/activation-api-js/api-reference/api-reference#trackaddtowishlist). Cette méthode envoie les données d'événement nécessaires à Kameleoon, qui alimente l'algorithme de liste de souhaits.
  </Accordion>

  <Accordion title="Quels attributs puis-je importer depuis Google Merchant Center par rapport au XML Kameleoon ?">
    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`).
  </Accordion>

  <Accordion title="Comment choisir entre l'importation XML et l'importation API pour mon catalogue ?">
    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**](../../developer-docs/apis/product-recommendation-api-rest/tutorials/import-a-product-catalog-into-kameleoon-using-the-product-recommendation-api) si votre catalogue dépasse 50 000 produits.
  </Accordion>
</AccordionGroup>