Widgets de recommandations sur le site
Un widget est un bloc de produits prêt à l'emploi sur votre site : « Vous aimerez aussi » sur la page d'accueil, « Achetés ensemble » sur la fiche produit, « Consultés récemment » dans le panier. Vous le configurez dans OneTrace.pro et insérez une seule fois un code court sur le site. Ensuite, le type, l'apparence, les règles d'affichage et l'activation se modifient sans toucher au site.
Il faut pour cela que le traceur soit installé (Connexion du site) et que vous disposiez d'un catalogue de produits ainsi que d'événements de consultation, de panier et d'achat (Recommandations et catalogue de produits). Le « Propriétaire », l'« Administrateur » et le « Gestionnaire » peuvent créer et modifier les widgets ; les autres rôles voient les paramètres et les statistiques sans pouvoir enregistrer.
Liste des widgets
Ouvrez Site → Widgets. La fiche de chaque widget affiche son statut, ses statistiques sur 30 jours, la comparaison des variantes s'il en a, et le code pour le site.

L'interrupteur Afficher sur le site web désactive le widget sans modifier le site : le statut passe à « En pause » et le bloc est vidé sur la page. Réactivez-le et les produits reviennent. Le bouton en forme de corbeille supprime définitivement le widget.
Pour créer un widget, cliquez sur Créer un widget. Pour le modifier, cliquez sur son nom ou sur le bouton en forme de crayon. Les deux ouvrent la page de l'éditeur.
Éditeur de widget
À gauche, les paramètres sont répartis en quatre sections : Produits, Apparence, Affichage et Variantes. À droite, l'aperçu affiche le widget comme sur le site, avec les vrais produits de votre catalogue. Si une section contient une erreur, un repère apparaît à côté de son nom. Cliquez sur Enregistrer : les modifications sont visibles sur le site au chargement suivant de la page, inutile de changer le code. Si vous quittez la page avec des modifications non enregistrées, le navigateur vous prévient.

Le sélecteur Ordinateur / Téléphone au-dessus de l'aperçu montre les deux mises en page. Sur le site, la mise en page s'adapte à la largeur de l'emplacement et non à celle de l'écran : dans une colonne étroite, le widget s'affiche comme sur un téléphone. Le widget reprend la police et la couleur du texte du site, sauf si vous définissez les vôtres.
Produits
| Champ | Ce qu'il définit |
|---|---|
| Nom | nom du widget ; visible uniquement dans l'interface d'administration |
| Contenu à afficher | type de recommandations : Personnalisées, Populaires, Tendances, Consultés ensemble, Achetés ensemble, Similaires, Consultés récemment, Il est temps de racheter |
| Catégorie | pour les produits populaires et tendance : id d'une catégorie du catalogue ; vide pour tout le catalogue |
| Produits au total | de 1 à 24 |
| Produit pour l’aperçu | pour « Consultés ensemble », « Achetés ensemble » et « Similaires » : id du produit pour lequel l'aperçu est construit ; vide pour le premier produit en stock |
S'il n'y a aucun produit adapté, l'aperçu affiche des emplacements gris pour juger de l'apparence.
Apparence
| Champ | Ce qu'il définit |
|---|---|
| Titre | texte au-dessus des produits, par exemple « Vous aimerez aussi » |
| Bouton | texte du bouton de la carte, par exemple « Détails » ; vide pour ne pas afficher de bouton |
| Disposition | Grille ou Carrousel avec défilement |
| Cartes par ligne | de 1 à 8 |
| Afficher le prix | prix sur la carte |
| Styles prêts à l'emploi | « Comme sur le site », « Cartes », « Minimaliste », « Contraste » : ils remplissent les champs d'apparence, que vous pouvez ensuite modifier |
| Contenu de la carte | marque, ancien prix, badge de réduction, bordure et ombre de la carte |
| Proportions de l'image et Image | 1:1, 3:4 ou 4:3 ; image entière ou remplissant l'espace avec recadrage des bords |
| Couleurs | accent, fond de la carte, fond de l'image, texte, prix, bouton et texte du bouton ; sans couleur, comme sur le site, et le fond de l'image est blanc |
| Taille du texte, Taille du titre, Titre | tailles en pourcentage de la police du site et alignement du titre |
| Arrondi des angles, Espacement entre les cartes, Marge intérieure de la carte | en pixels |
| Flèches du carrousel | boutons de défilement sur les bords du carrousel |
| Téléphone | cartes par ligne sur écran étroit (de 1 à 3) et disposition propre, par exemple un carrousel au lieu d'une grille |
| CSS personnalisé | règles pour les classes du widget : .cdp-rec__name, .cdp-rec__price, .cdp-rec__button et d'autres |
Le CSS personnalisé ne s'applique qu'à l'intérieur de ce widget et ne modifie pas le reste de la page. Il ne peut pas charger de ressources externes : @import, url() et les constructions similaires sont refusés à l'enregistrement.
Si le projet compte plusieurs langues, le sélecteur Langue des textes apparaît au-dessus du titre. Dans la langue par défaut, vous renseignez le Titre et le Bouton ; dans les autres langues, leurs traductions ; un champ vide affiche le texte de la langue par défaut. Le visiteur voit le titre et le bouton dans sa langue, celle que le traceur transmet au profil (Langue du client) ; sans traduction, dans la langue par défaut. Les prix s'affichent au format de la langue du visiteur.
Style à partir d'une image
Le bouton Style à partir d’une image de la section Apparence choisit l'apparence d'après une capture d'écran de fiches produits, prise sur votre site ou sur un site qui vous plaît.
- Cliquez sur Style à partir d’une image.
- Glissez l'image, collez-la depuis le presse-papiers (Ctrl+V) ou choisissez un fichier : PNG, JPEG ou WebP jusqu'à 3 Mo.
- Si le widget a des variantes, choisissez celle à laquelle appliquer le style.
- Cliquez sur Reprendre le style.
L'IA remplit les couleurs, les tailles, les arrondis, la disposition et le contenu de la carte ; ce que les paramètres ne permettent pas, elle l'ajoute dans CSS personnalisé. Chaque valeur est vérifiée comme lors d'une saisie manuelle, et celles qui ne conviennent pas sont écartées. Le résultat est un brouillon : regardez l'aperçu, puis enregistrez ou cliquez sur Rétablir.

L'image n'est pas conservée. L'analyse est payée sur le solde du projet selon la consommation réelle ; si le solde est insuffisant ou si l'IA n'est pas incluse dans votre forfait, le bouton est indisponible et la raison est indiquée en dessous.
Affichage

| Champ | Ce qu'il définit |
|---|---|
| Afficher sur le site web | activation du widget, comme dans la liste |
| Uniquement sur les pages et Sauf sur les pages | adresses de pages sans le domaine, une par ligne ; * remplace n'importe quels caractères, par exemple /catalog/*. Vide : sur toutes les pages |
| Appareils | tous, uniquement les ordinateurs ou uniquement les téléphones |
| Visiteurs | tous, uniquement les nouveaux ou uniquement les visiteurs de retour |
| Uniquement aux membres des segments et Sauf aux membres des segments | segments du visiteur ; l'appartenance est vérifiée sur le profil à chaque affichage |
Le serveur vérifie les règles à chaque chargement du widget. Hors des règles, l'emplacement reste vide sur la page et la mise en page n'est pas cassée. Ce sont les mêmes règles que pour les formulaires d'inscription.
C'est aussi là que se trouve le Code pour le site web, décrit ci-dessous.
Variantes
Les variantes servent à vérifier quel titre, quel type de recommandations ou quelle apparence apporte le plus de clics et d'achats. Les paramètres principaux du widget forment la variante A. Cliquez sur Ajouter une variante : vous pouvez ajouter jusqu'à trois variantes, B, C et D. Dans chacune, vous pouvez modifier :
- le type de recommandations, Contenu à afficher ;
- le Titre et le Bouton, avec leurs traductions ;
- la disposition et toute l'apparence.
Les champs vides reprennent les valeurs de la variante A.

Les visiteurs sont répartis à parts égales entre les variantes, et chaque visiteur voit toujours la même. Le sélecteur au-dessus de l'aperçu affiche la variante choisie. Les résultats de la comparaison figurent dans les statistiques sous l'éditeur.
Voir sur votre site web
Le bouton Voir sur votre site web au-dessus de l'aperçu ouvre une page de votre site avec le widget tel qu'il est enregistré. Indiquez l'adresse d'une page où le code du widget est inséré, choisissez la variante et cliquez sur Ouvrir.
Le widget est alors visible même s'il est désactivé ou si la page ne correspond pas aux règles d'affichage. Les impressions et les clics de ce mode ne sont pas comptés dans les statistiques. Le lien est valable 24 heures ; tant que l'onglet reste ouvert, le mode aperçu est conservé lorsque vous naviguez entre les pages du site. Les modifications non enregistrées ne sont pas visibles sur le site : enregistrez d'abord.
Code pour le site web
Le code du widget se trouve sur sa fiche dans la liste et dans la section Affichage de l'éditeur. Insérez-le dans le modèle de page à l'endroit où le bloc doit apparaître :
<div data-cdp-widget="a1b2c3d4e5f6" data-item="SKU-1"></div>
Attributs :
data-item: id du produit de la page ou des produits du panier, séparés par des virgules :data-item="SKU-1,SKU-7". Obligatoire pour les types « Consultés ensemble », « Achetés ensemble » et « Similaires » : renseignez-le depuis le modèle de page.data-category: id de catégorie pour les produits populaires, si des pages différentes nécessitent des catégories différentes.data-exclude: id de produits, séparés par des virgules, à ne pas afficher, par exemple ceux déjà dans le panier.
Les produits personnalisés et consultés récemment sont sélectionnés d'après le visiteur ; ils n'ont pas besoin de data-item.
S'il n'y a aucun produit adapté, l'emplacement reste vide sur la page : la mise en page n'est pas cassée.
Statistiques
Sous l'éditeur figurent les statistiques du widget sur 7, 30 ou 90 jours : totaux, graphique par jour et comparaison des variantes. Au-dessus du graphique, choisissez l'indicateur : impressions, clics, CTR ou revenu. Si le widget a des variantes, chacune a sa propre courbe sur le graphique.

| Indicateur | Mode de calcul |
|---|---|
| Impressions | le widget est entré au moins à moitié dans le champ de vision du visiteur. Un chargement de page sans défilement jusqu'au bloc n'est pas compté : le CTR d'un widget placé en bas de page est donc fiable |
| Clics | clics sur les cartes de produits |
| CTR | clics divisés par impressions |
| Achats | achats du produit par le même client dans les 7 jours suivant un clic sur celui-ci ; sur le graphique, comptés le jour du premier clic |
| Revenu | montant de ces achats |
Les jours sont comptés en UTC. Les impressions et les clics de l'aperçu sur votre site ne sont pas comptés.
Le tableau des variantes indique les impressions, les clics, le CTR, les achats et le revenu de chaque variante. En dessous, une conclusion sur les clics et sur les achats par impression : quelle variante est la meilleure et s'il y a déjà assez de données pour s'y fier. Tant que les données sont insuffisantes, la conclusion le dit : patientez plutôt que de choisir une variante sur un écart dû au hasard.
L'effet global des recommandations sur le site, par type, est présenté dans la section Recommandations.
Sites monopages
Le traceur détecte lui-même les widgets après le chargement de la page, à l'apparition de nouveaux éléments et lors d'un changement de data-item. Sur les sites React, Vue et similaires, il suffit donc de modifier l'attribut pour que le bloc soit redessiné.
Si les produits doivent être actualisés sans modification des attributs, par exemple après un changement du panier, appelez :
cdp.widgets({ force: true });
Votre propre code à la place d'un widget
Les développeurs peuvent afficher un bloc de recommandations depuis le code, sans configuration dans l'interface d'administration :
window.addEventListener('load', () => {
cdp.renderRecommendations('#recs', {
type: 'viewed_with', item: 'SKU-1', title: 'Vus ensemble', layout: 'carousel', columns: 4,
});
});
Le bloc a la même apparence qu'un widget, et les impressions et clics sont comptabilisés automatiquement. Vous pouvez l'appeler avant le chargement du traceur : l'appel attend dans la file. L'élément doit déjà être sur la page, c'est pourquoi l'exemple attend l'événement load. Un résultat vide vide l'élément. L'apparence se règle avec les mêmes options que les widgets de l'interface d'administration, par exemple imageRatio: '4:3', imageFit: 'cover', imageBackground: 'transparent', background: '#111827', textColor: '#f9fafb' ; imageBackground est une couleur ou transparent. Les règles d'affichage et les variantes ne sont disponibles que pour les widgets de l'interface d'administration.