Chaque widget de recommandation choisit ses produits ou articles avec un algorithme — Meilleures ventes, Personnalisé, Éléments similaires et les autres. Correspondance avec le visiteur décide ensuite de leur ordre pour chaque personne : les éléments qui conviennent à ce visiteur passent en premier. Il peut s’agir des marques, tailles, catégories ou auteurs de son propre historique, de son genre, des prix qu’il consulte, de l’endroit où il se trouve, de sa langue, ou de l’un de ses champs visiteur.
C’est une liste ordonnée de conditions que vous construisez. L’algorithme décide toujours quels éléments sont en lice ; Correspondance avec le visiteur ne change que l’ordre dans lequel chacun les voit.

Où la trouver
Campagne › Contenu › l’éditeur du widget › étape 1 Sélectionner l’algorithme de recommandation › Correspondance avec le visiteur, sur toute la largeur, sous les cartes d’algorithmes et au-dessus de Règles de filtre personnalisées.
Elle figure dans tous les widgets de recommandation :
- les widgets de produits et de contenu sur site ;
- les recommandations dans les e-mails ;
- le bloc de recommandations du Canvas Builder ;
- les flux JSON — Products Recommendations – JSON, Content Recommendations – JSON, External JSON API – Products et External JSON API – Articles. Un widget JSON créé auparavant reçoit ses conditions lorsqu’il est de nouveau enregistré.
Les widgets de catégories et de centres d’intérêt n’ont pas cette section : une catégorie n’a ni marque ni auteur propre. Voir Recommandations de catégories et de centres d’intérêt.

Fonctionnement
- + Faire correspondre par… ajoute une condition, issue de deux groupes : D’après son historique et À propos du visiteur. Chaque ligne se déplace vers le haut ou le bas, et × la retire.
- Les conditions ne font que réordonner ce que l’algorithme a trouvé. Elles reclassent les 200 meilleures recommandations de l’algorithme, et le widget affiche les premiers éléments de cette liste triée, autant qu’il en contient. Elles n’ajoutent jamais un élément venu d’ailleurs.
- Les replis n’interviennent toujours que lorsque l’algorithme principal trouve moins d’éléments que le widget n’en affiche (ou n’en trouve aucun, si le repli est réglé sur Seulement quand il n’y a rien d’autre à montrer). Leurs éléments sont triés selon les mêmes conditions, au sein de leurs propres résultats, et viennent toujours après ceux de l’algorithme principal, aussi bien qu’ils correspondent. Voir solutions de repli.
- Les éléments ajoutés par Remplir les cellules vides ne sont pas triés.
- Une valeur vide ne correspond jamais. Un produit sans marque ne correspond jamais à Marque de l’historique du visiteur.

Ordre
Un seul réglage pour toute la liste. En cas d’égalité, l’ordre propre de l’algorithme est conservé dans les deux cas.
| Ordre | Comment elle classe |
|---|---|
| Priorité stricte (par défaut) | La condition 1 décide d’abord ; la condition 2 ne départage que les éléments à égalité sur la condition 1, et ainsi de suite. Les lignes sont numérotées. Exemple, Marque puis Couleur : un produit de sa marque dans une autre couleur passe avant un produit d’une autre marque dans sa couleur. |
| Le plus de correspondances d’abord | Plus un élément remplit de conditions, plus il passe tôt — peu importe lesquelles. Exemple, Marque et Couleur : un produit qui remplit les deux passe en premier, puis les produits qui remplissent l’une ou l’autre. |
Si rien ne correspond
Ce que fait le widget pour un visiteur quand aucune de ses recommandations ne remplit la moindre condition.
| Option | Ce qui se passe |
|---|---|
| Afficher quand même les meilleurs produits (par défaut ; Afficher quand même les meilleurs articles sur un widget de contenu) | Les conditions ne changent que l’ordre : les éléments qui ne correspondent à rien remplissent quand même le widget, après ceux qui correspondent. Les replis, Remplir les cellules vides et Réserver une place aux nouveautés fonctionnent comme sans conditions. |
| Masquer le widget | Seuls les éléments qui remplissent au moins une condition sont affichés : d’abord ceux de l’algorithme principal, puis — quand ils sont moins nombreux que ce qu’affiche le widget — les éléments correspondants d’un repli. Remplir les cellules vides et la place réservée aux nouveautés sont désactivés (grisés). Quand rien ne correspond nulle part, le widget n’affiche rien. |
Les conditions
D’après son historique
L’historique du visiteur, ce sont les éléments avec lesquels il a interagi — ses 20 derniers environ. Chaque condition d’historique a un choix Historique, qui détermine les éléments à comparer :
| Produits | Articles | Compare avec |
|---|---|---|
| Vu | Lu | Les éléments qu’il a consultés |
| Acheté | Objectif atteint | Les éléments qu’il a achetés, ou qui ont mené à un objectif |
| Vu ou acheté (par défaut) | Lu ou objectif atteint (par défaut) | L’un ou l’autre |
| Toute interaction | Toute interaction | Produits : vus, ajoutés au panier, ajoutés à la liste d’envies ou achetés. Articles : lus, commentés, aimés ou ayant atteint un objectif |
| Condition | Place en premier |
|---|---|
| Marque, Couleur, Taille (produits) | Les produits d’une marque, d’une couleur ou d’une taille présente dans l’historique du visiteur. |
| Sujet, Auteur (articles) | Les articles sur un sujet, ou d’un auteur, présent dans l’historique du visiteur. |
| Catégorie | Les éléments qui partagent une catégorie avec un élément de son historique. Correspondance par choisit Catégorie, Étiquette ou Intérêt, et le nom de la ligne suit ce choix (Étiquette de l’historique du visiteur). Utilisez celui qu’utilise votre catalogue — certains catalogues de contenu rangent leur taxonomie sous forme de centres d’intérêt. |
| Autre champ… | La même vérification sur n’importe quel autre champ du catalogue, champs personnalisés compris, sous les noms que votre compte leur a donnés — Fabricant, Groupe, Matière. |

À propos du visiteur
| Condition | Place en premier |
|---|---|
| Genre (produits) | Les produits correspondant au genre du visiteur. Les produits unisexes, et les produits sans genre, correspondent à tout visiteur dont le genre est connu. Le genre du visiteur est celui de son profil quand il est connu, sinon le genre que portent la plupart des produits de son historique ; un visiteur dont le genre ne peut pas être déterminé ne correspond à rien, et son ordre reste donc inchangé. Champ est le champ du catalogue qui contient le genre du produit — il démarre sur le champ que votre compte a intitulé Gender (de nombreux flux le placent dans un champ personnalisé). Des valeurs comme male/female, men/women et unisex sont comprises. |
| Prix comme les siens (produits) | Les produits à ±X % (30 par défaut) du prix moyen des produits de son historique, remise déduite. 30 % autour d’une moyenne de 100 donne 70 à 130. Un visiteur sans historique de prix ne correspond à rien. |
| Lieu (produits) | Les produits à moins de N km (50 par défaut) du visiteur. Chaque produit a besoin de sa latitude et de sa longitude dans le catalogue. Un visiteur localisé seulement par pays ne correspond jamais — le centre d’un pays n’est pas l’endroit où il se trouve. |
| Langue (articles) | Les articles dans la langue du navigateur du visiteur. Champ est le champ du catalogue qui contient un code de langue comme en, fr ou en-US; tant que votre catalogue d’articles n’en a pas, la ligne le signale. Sur site uniquement : un widget dans un e-mail ne fait jamais correspondre la langue. |
| Correspond à un champ du visiteur… (produits et articles) | Un champ de l’élément égal à l’un des champs propres du visiteur : un champ de profil comme Secteur ou Ville actuelle, ou l’un de vos attributs visiteur. Par exemple, un attribut Groupe préféré face au champ Groupe du produit, ou, pour du contenu B2B, le Secteur de l’article face au secteur de l’entreprise du visiteur. Champs texte uniquement ; une valeur vide d’un côté ou de l’autre ne correspond jamais. |
Une condition qui attend encore un champ — Autre champ…, Langue, Correspond à un champ du visiteur… — affiche une note orange (« Choisissez un champ – d’ici là, cette condition n’est pas enregistrée. ») et n’est pas enregistrée tant que vous n’en choisissez pas un.
Recettes
| Site | Conditions | Réglages |
|---|---|---|
| Mode | Taille de l’historique du visiteur, puis Genre | Priorité stricte, Afficher quand même les meilleurs produits |
| Électronique | Marque de l’historique du visiteur, puis Prix comme les siens à 25 % | Priorité stricte |
| Local ou multi-magasins | Lieu à moins de 25 km | Masquer le widget (nécessite des coordonnées dans le flux) |
| Éditeur ou blog | Auteur, puis Sujet — ou Catégorie avec correspondance par Étiquette | Priorité stricte |
| Contenu B2B | Correspond à un champ du visiteur : le Secteur de l’article face au Secteur du visiteur | Afficher quand même les meilleurs articles |
Limites
- Elle réordonne les 200 premiers résultats propres à l’algorithme ; elle n’ajoute jamais d’éléments que l’algorithme n’a pas choisis.
- L’âge n’est pas proposé : aucun catalogue ne renseigne de tranche d’âge, et les visiteurs ont rarement une date d’anniversaire.
- Langue nécessite un champ de langue dans le catalogue d’articles.
- Un widget de flux JSON existant reçoit ses conditions lorsqu’il est de nouveau enregistré.
Pour les auteurs de modèles
Un modèle écrit à la main peut utiliser les mêmes conditions dans l’en-tête d’un ${foreach} : match by se place après where / group by et avant order by, sur chaque branche.
${foreach recom_products as p where ... match by 'only', p->brand:in_visitor_history('viewed,goal'), p->size:in_visitor_history('viewed,goal') order by p->recom_score desc limit 8}
- Indicateurs :
'most'correspond à « Le plus de correspondances d’abord »,'only'à « Masquer le widget ». - Fonctions :
in_visitor_history,visitor_gender,near_visitor_price('30'),within_km('50')(surp->geolocation),visitor_language(),in_visitor_interests('tag')(surp->id) etequals_visitor('industry'). - Une condition écrite à la main dans un modèle apparaît dans l’éditeur comme une ligne à part : « Une condition écrite à la main dans le modèle. Elle est conservée telle quelle. »
Voir aussi
- Algorithmes de recommandation — ce que chacun choisit, et Plus de stock d’abord
- Définir des filtres sur les recommandations — ce qu’un algorithme peut renvoyer, tout simplement
- Définir des solutions de repli pour les recommandations
- Régler le moteur — les pondérations de tout le compte, sous chaque widget
- Recommandations — par où commencer