> ## 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.

# Créer et configurer une stratégie de recommandation

> Créez une stratégie de recommandation de produits, configurez ses algorithmes et ses règles, sélectionnez un modèle et publiez le bloc sur votre site web.

<Note>
  Il s'agit d'une fonctionnalité premium. Contactez votre Customer Success Manager pour l'activer sur votre compte Kameleoon.
</Note>

Pour accéder à l'espace **Product Recommendations** :

* Cliquez sur **Settings** > **Recommendations**.

## Stratégie de recommandation

### Créer une stratégie

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/reco-menu.png)
</Frame>

1. Dans le menu **Recommendations**, cliquez sur **Recommendation strategy**.
2. Cliquez sur **+ Add block** dans l'en-tête pour créer une nouvelle stratégie.

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/add-block-cta.png)
</Frame>

3. Saisissez un nom et une description.
4. Définissez le nombre maximum de produits à afficher dans le bloc.
5. Cliquez sur **Save**.

Une fois votre stratégie enregistrée, vous pouvez configurer ses règles, ses modèles et son design.

### Configurer les règles

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/rules.png)
</Frame>

Utilisez la section **Rules** pour définir la façon dont votre stratégie de recommandation sélectionne et filtre les produits.

Vous pouvez configurer :

* Le titre et la description de la stratégie
* Les algorithmes, les produits dans le bloc et les tags

Par exemple, vous pouvez utiliser un algorithme si un produit coûte moins qu'un certain montant, et un autre algorithme s'il coûte plus.

Après avoir configuré vos règles, cliquez sur **Save** pour appliquer vos modifications.

Pour apprendre à configurer des règles avancées, consultez [Définir des règles de merchandising avancées](./define-advanced-merchandising-rules).

#### Algorithmes

Les algorithmes Kameleoon déterminent quels produits apparaissent dans votre bloc de recommandation. Vous pouvez sélectionner un algorithme, spécifier combien de produits il renvoie et appliquer des filtres.

Si vous fixez une limite de 10 produits dans l'algorithme et que vous définissez 6 comme limite du bloc, le bloc affichera 6 produits.

Pour voir la liste des algorithmes disponibles, consultez [Sélectionner un algorithme pour votre bloc de recommandation de produits](./select-an-algorithm-for-your-product-recommendation-block).

### Sélectionner un modèle

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/template-selection.png)
</Frame>

Dans la section **Template**, vous pouvez rapidement appliquer des configurations prédéfinies à votre projet. Vous pouvez définir votre propre modèle en modifiant le code par défaut dans l'éditeur en utilisant [Liquid Markup](https://liquidmarkup.org), ou appliquer un modèle existant. Pour personnaliser des modèles existants ou en créer un nouveau, utilisez la page dédiée **[Templates](#manage-templates)**.

Vous pouvez également ajouter des paramètres UTM pour suivre les performances de la stratégie dans votre plateforme d'analyse.

### Publier votre stratégie

Une fois terminé, cliquez sur **Copy code** pour obtenir le snippet généré pour votre bloc. Collez-le dans le code source de votre page à l'endroit où vous souhaitez qu'il 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 automatiquement la dernière version de votre modèle enregistré.

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/copy-code.png)
</Frame>

Lorsque votre bloc utilise certains algorithmes, vous devez inclure les variables prédéfinies de Kameleoon. Par exemple, si vous utilisez l'algorithme **Similar product** et que vous souhaitez afficher votre bloc sur toutes les pages produit, ajoutez la variable `data-recommender-item` pour spécifier l'ID du produit courant. Le tableau ci-dessous répertorie toutes les variables Kameleoon disponibles.

| Paramètre                       | Obligatoire                     | Description                                                                                                                                                   |
| ------------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data-recommender-min`          | Non                             | Le nombre minimum de produits dans la réponse pour que le bloc apparaisse. Le bloc est masqué s'il n'y a pas assez de produits.                               |
| `data-recommender-code`         | Oui                             | ID du bloc de recommandation de produits                                                                                                                      |
| `data-recommender-item`         | Oui (pour certains algorithmes) | ID du produit courant si l'utilisateur est sur la fiche produit. Obligatoire pour les blocs avec les algorithmes "Similar" et "They also buy this".           |
| `data-recommender-exclude`      | Non                             | Une liste séparée par des virgules des ID de produits à exclure des recommandations.                                                                          |
| `data-recommender-search_query` | Non                             | Le terme de recherche courant. Utilisé dans un bloc sur une page de résultats de recherche.                                                                   |
| `data-recommender-callback`     | Non                             | Le nom de la fonction JS à laquelle les résultats de la requête API seront transmis si un gestionnaire personnalisé de recommandation de produits est requis. |
| `data-recommender-error`        | Non                             | Le nom de la fonction JS qui sera appelée si la requête de recommandation de produits échoue.                                                                 |
| `data-recommender-category`     | Non                             | Recommande uniquement des produits de la catégorie spécifiée.                                                                                                 |
| `data-recommender-categories`   | Non                             | Recommande uniquement des produits des catégories spécifiées (liste d'ID de catégories séparées par des virgules).                                            |
| `data-recommender-brands`       | Non                             | Recommande uniquement des produits des marques spécifiées (liste de marques séparées par des virgules).                                                       |

## Gestion du consentement

Par défaut, les recommandations de produits partagent les mêmes paramètres de consentement que vos A/B tests et personnalisations : vous ne pouvez pas configurer indépendamment une politique de consentement distincte pour les recommandations. Vous pouvez contacter votre Customer Success Manager (CSM) pour configurer une politique de consentement distincte spécifiquement pour les recommandations de produits.

### Comment la configuration affecte les recommandations

Le comportement du moteur de recommandation dépend des exigences de consentement de votre compte :

* **Lorsque le consentement n'est pas requis :** Kameleoon stocke les données du visiteur dans des cookies et les transmet au module de recommandation indépendamment du statut de consentement du visiteur.
* **Lorsque le consentement est requis :** le consentement fourni par le visiteur détermine la façon dont Kameleoon gère ses données :
  * **Consentement accordé :** Kameleoon stocke et transmet les données du visiteur pour fournir des recommandations personnalisées basées sur l'historique de navigation et le comportement.
  * **Consentement non accordé :** Kameleoon ne stocke pas les données du visiteur dans les cookies. Les algorithmes de recommandation n'affichent que des produits en utilisant une logique ou des filtres qui ne nécessitent pas de données visiteur, comme la popularité générale ou les filtres globaux statiques.

### Mettre à jour vos paramètres

Contactez votre CSM pour activer une politique de consentement distincte pour les recommandations de produits ou pour mettre à jour votre configuration existante.

## Gérer les modèles

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/template-page.png)
</Frame>

Utilisez la page **Templates** pour créer et personnaliser des modèles pour vos blocs de recommandation.

1. Dans le menu **Recommendations**, cliquez sur **Templates**.
2. Cliquez sur **+ Add template**.
3. Saisissez un nom pour votre modèle.
4. Modifiez le code du modèle pour définir la mise en page et les informations affichées (par exemple, la marque, l'image ou la description du produit).
5. Cliquez sur **Save**.

Vous pouvez créer plusieurs modèles et utiliser les mêmes modèles sur plusieurs stratégies, ou en attribuer un dédié à chaque stratégie.

Les modèles utilisent [Liquid Markup](http://liquidmarkup.org/).

## Personnaliser le design

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/design-page.png)
</Frame>

Dans le menu **Recommendations**, cliquez sur **Design** pour personnaliser le style visuel de votre bloc. Cliquez sur l'icône **crayon** pour accéder aux éditeurs. Vous pouvez choisir entre :

* **Éditeur de base :** personnalisez les éléments visuels via une interface simple.
* **Éditeur CSS :** écrivez du CSS personnalisé pour un contrôle complet du style.
