Recherche de produits sur le site

La recherche de produits, c'est un champ de recherche sur votre site avec des suggestions pendant la saisie et une page de résultats que OneTrace.ru remplit avec les produits de votre catalogue. La recherche comprend les fautes de frappe, les formes des mots et les requêtes saisies avec la mauvaise disposition de clavier, et elle classe les premiers résultats selon les centres d'intérêt du visiteur : ce qu'il a consulté et acheté.

Il faut pour cela que le traceur soit installé (Connexion du site) et que vous disposiez d'un catalogue de produits (Recommandations et catalogue de produits). La recherche n'est pas incluse dans tous les forfaits : si votre forfait ne la comprend pas, le bloc de code n'apparaît pas dans l'onglet d'installation et les requêtes de recherche reçoivent l'erreur « fonction non disponible ».

Comment les produits sont recherchés

• Les mots de la requête sont recherchés dans le nom, la marque, les catégories et les caractéristiques du produit ; la référence, par correspondance exacte.
• Les formes des mots sont prises en compte dans les langues du projet : « куртки » trouve « Куртка зимняя ». Les langues se définissent dans les paramètres du projet, voir Paramètres du projet, forfait et audit.
• Les fautes de frappe sont corrigées : « крутка » trouve « куртку », « dres » trouve « dress ».
• Une requête saisie avec la mauvaise disposition de clavier fonctionne aussi : « ghbdtn » est recherché comme « привет ».
• Si rien ne correspond à tous les mots, la recherche affiche les produits qui contiennent au moins l'un d'eux.
• Les produits populaires et en stock sont placés plus haut. La popularité provient des recommandations et est mise à jour une fois par jour.
• Les premiers résultats sont réordonnés selon les centres d'intérêt du visiteur : les produits des catégories et des marques qu'il a consultées et achetées remontent.
• Les dimensions et paramètres de la requête (« 205/55 r16 », « 5x112 », « hiver ») deviennent des filtres s'ils sont connus du secteur de la boutique.

Les produits nouveaux ou modifiés du catalogue apparaissent dans la recherche moins d'une minute après le chargement du flux ou une requête API.

Champ de recherche

Ajoutez l'attribut data-cdp-search au champ de recherche de votre site :

<form action="/search">
  <input name="q" data-cdp-search data-category-url="/catalog/{id}">
</form>

Pendant la saisie, des suggestions apparaissent sous le champ : recherches populaires du site, catégories correspondantes et produits avec image et prix. Vous pouvez les parcourir avec les flèches ; Entrée ouvre la ligne sélectionnée, Échap ferme les suggestions. Entrée sans ligne sélectionnée envoie le formulaire du site comme d'habitude.

Les suggestions reprennent la police du site et ne contiennent aucun texte d'interface : elles conviennent donc à un site dans n'importe quelle langue.

Page de résultats

Les plugins prêts à l'emploi pour boutiques en ligne insèrent eux-mêmes les résultats dans la page de recherche de la boutique. Sur votre propre site, récupérez les produits via le traceur :

window.addEventListener('load', async () => {
  const q = new URLSearchParams(location.search).get('q');
  const result = await cdp.search(q, { perPage: 24 });
  // result.items — produits, result.total — nombre de résultats, result.facets — catégories, marques, prix et caractéristiques pour les filtres
});

Paramètres : category, brand, priceMin, priceMax, sort (relevance, popular, price_asc, price_desc), page, perPage, attributes. Lors d'un clic sur un produit, appelez cdp.searchResultClicked(produit).

Filtres de caractéristiques. result.facets.attributes contient les caractéristiques du secteur de la boutique, avec leurs libellés dans la langue du visiteur et le nombre de produits pour chaque valeur, par exemple « Diamètre, pouces » : 16, 17, 18. Transmettez les valeurs choisies dans attributes : cdp.search(q, { attributes: { rim_diameter: [17, 18], season: 'winter' } }). Plusieurs valeurs d'une même caractéristique sont combinées par « ou », des caractéristiques différentes par « et ». result.filters contient les dimensions et paramètres reconnus dans le texte de la requête : affichez-les au visiteur pour qu'il comprenne pourquoi les résultats sont filtrés. Nécessite le traceur 1.15.0.

Si la requête a une règle de redirection (voir Règles de requêtes), result.redirect contient l’adresse de la page : ouvrez-la à la place des résultats.

Les serveurs peuvent effectuer les mêmes requêtes avec une clé d'écriture : https://cdp.onetrace.ru/api/v1/search et https://cdp.onetrace.ru/api/v1/search/suggest. La liste complète des paramètres figure dans la référence de l'API : https://cdp.onetrace.ru/api/v1/openapi.json.

Rapport des requêtes

L’onglet Recherche de la section « Site » montre ce que les visiteurs recherchent sur votre site sur 7, 30 ou 90 jours :

• Recherches et visiteurs : combien de fois on a cherché et combien de personnes différentes.
• Sans résultat : la part des recherches qui n’ont rien trouvé.
• CTR : la part des visiteurs qui ont cliqué sur un produit dans les résultats de leur requête.
• Achats et chiffre d’affaires : un produit cliqué dans les résultats et acheté par le même client dans les 7 jours. Le chiffre d’affaires est calculé au prix du produit dans le catalogue. Affichés si un événement d’achat est défini dans les paramètres des recommandations, voir Recommandations et catalogue produits.

Tableaux sous le graphique :

Les requêtes sont comparées sans tenir compte de la casse ni des espaces superflus. Depuis une ligne du tableau, vous pouvez ajouter directement un synonyme ou une règle pour la requête.

Synonymes

Les synonymes sont des mots et expressions recherchés ensemble : une requête avec n’importe quel mot du groupe trouve aussi les produits correspondant aux autres. Par exemple, avec le groupe « baskets, tennis, sneakers », la requête « tennis blanches » trouve aussi les baskets blanches.

• Groupe dans les deux sens : chaque mot est recherché comme les autres.
• Groupe dans un seul sens : seul le premier mot est recherché comme les autres : « portable → smartphone » trouve des smartphones pour « portable », mais « smartphone » n’est pas recherché comme « portable ».

Un mot ou une expression du groupe n’est remplacé dans la requête que s’il apparaît en entier. Les synonymes s’appliquent dès l’enregistrement, dans les résultats et les suggestions. Un projet peut avoir jusqu’à 500 groupes, un groupe jusqu’à 20 mots.

Règles de requêtes

Une règle s’applique quand un visiteur recherche exactement cette requête (sans tenir compte de la casse, des espaces superflus ni de la ponctuation aux extrémités) et effectue une action ou les deux :

• Produits épinglés : jusqu’à 24 produits, dans l’ordre choisi, s’affichent en tête des résultats même si la recherche ne les trouve pas. Les autres résultats suivent sans répétition. L’épinglage s’applique avec le tri par pertinence et sans filtre ; les produits en rupture de stock ne sont pas affichés.
• Redirection : une page de votre site s’ouvre à la place des résultats, par exemple « livraison » → la page des conditions de livraison.

Les redirections sont suivies par le champ de recherche du traceur (Entrée sur une requête avec règle), cdp.search() sur votre propre page de résultats (champ redirect) et les plugins WooCommerce et Magento 2. Un projet peut avoir jusqu’à 1000 règles.

Statistiques

Le traceur enregistre deux événements :

Les recherches populaires des suggestions sont établies à partir des événements search des 30 derniers jours. Les événements sont visibles dans la fiche du profil du client et disponibles dans les segments, par exemple « a cherché mais n'a pas acheté », voir Segments.