Barre de recherche IA

Aperçu

La barre de recherche IA est un widget de recherche autonome pour votre site web. Les visiteurs tapent avec leurs propres mots et les résultats correspondants apparaissent sous la barre dès qu'ils font une pause : les produits de votre flux de données en temps réel sous forme de cartes avec image et prix, et les pages de votre base de connaissances avec un titre, un court aperçu et un lien. Comme elle cherche par le sens et pas seulement par mots-clés exacts, un visiteur qui tape une description trouve quand même le bon article.

Elle utilise la même base de connaissances que votre chatbot, il n'y a donc rien de plus à indexer ni à maintenir. Les deux widgets sont indépendants : utilisez la barre de recherche seule, le widget de chat seul, ou les deux ensemble sur les mêmes pages.

L'ajouter à votre site web

La barre de recherche IA nécessite le forfait Standard ou supérieur. Avec un forfait inférieur, la barre apparaît sur votre site mais ne renvoie jamais de résultats. Vérifiez donc d abord votre forfait si rien ne se passe.

Votre identifiant de widget est indiqué sur la page Barre de recherche IA de votre tableau de bord.

Le plus simple : remplacez le champ de recherche existant

Si votre site a déjà une recherche - celle du thème Shopify, un formulaire WordPress ou la vôtre - vous n avez rien à placer ni à modifier dans le thème. Ajoutez data-replace à la balise script : le widget trouve votre formulaire actuel, le masque et apparaît exactement à sa place :

Ce script peut se trouver n importe où sur la page : n importe quelle extension qui ajoute du code à l en-tête ou au pied de page fera l affaire. Appuyer sur Entrée sans choisir de résultat ouvre toujours votre ancienne page de résultats, donc rien de ce que connaissent vos visiteurs ne cesse de fonctionner. Si la détection automatique choisit le mauvais élément sur un thème inhabituel, passez un sélecteur CSS au lieu de auto, par exemple data-replace=".header-search". Si rien ne correspond, le widget laisse votre page intacte.

Le placer vous-même

Si vous n avez pas encore de barre de recherche, ou si vous la voulez à un endroit précis, collez les deux lignes là où la barre doit apparaître - par exemple dans l en-tête, à côté de votre logo. La barre occupe toute la largeur de l élément dans lequel vous la placez, ce qui implique en général de modifier un fichier du thème.

Si quelque chose ne fonctionne pas

• Aucune barre n apparaît. Vérifiez que l identifiant de widget dans le script correspond à celui de la page Barre de recherche IA et que le code se trouve bien sur la page publiée, et pas seulement dans un brouillon ou un aperçu.
• La barre apparaît mais ne renvoie jamais de résultats. C est presque toujours le forfait : la recherche fonctionne à partir de Standard. C est aussi ce que vous voyez une fois votre limite mensuelle de réponses IA atteinte.
• Vous obtenez des pages mais pas de produits. Les produits viennent d un Real-Time Data Feed. Connectez-en un sur la page Barre de recherche IA et vérifiez que la case de cette source est cochée.
• Vous n obtenez rien du tout, quelle que soit la recherche. Votre base de connaissances est peut-être encore vide. Explorez d abord votre site ou ajoutez du contenu dans le tableau de bord, puis réessayez.
• data-replace n a pas trouvé votre champ de recherche. Certains thèmes cachent la recherche derrière un bouton ou une fenêtre. Passez un sélecteur CSS de l élément voulu au lieu de auto, et regardez la page dans une fenêtre de navigateur normale plutôt que dans l éditeur de thème.

Sources de recherche

Deux cases à cocher sur la page Barre de recherche IA de votre tableau de bord contrôlent ce que la recherche peut utiliser : les pages du site web (pages explorées et URL ajoutées) et votre flux de données en temps réel. Les deux sont activées par défaut. Le flux n'est pas limité aux produits - tout ce que vous y indexez, comme des articles ou des annonces, peut apparaître comme résultat. Un changement s'applique immédiatement sur votre site.

Les résultats produits nécessitent un flux de données connecté. Les deux types fonctionnent : le Flux de données en temps réel à partir du plan Standard, et Flux de données en temps réel Max sur Pro. Sans flux, la recherche fonctionne toujours, elle ne renvoie simplement que les pages de votre site web, et la page du tableau de bord indique le flux comme non connecté pour que vous sachiez pourquoi aucun produit n'apparaît.

Analyse des recherches

La page Barre de recherche IA de votre tableau de bord affiche les recherches des 30 derniers jours : combien ont été lancées, combien n'ont rien trouvé et combien de fois un visiteur a ouvert un résultat. Deux tableaux listent vos recherches les plus fréquentes et les recherches sans résultat. Le second tableau est le plus utile, car il vous dit exactement ce que les visiteurs attendent et ne trouvent pas.

L'enregistrement est activé par défaut et vous pouvez le désactiver avec une case à cocher sur la même page. Une fois désactivé, plus aucun texte de recherche n'est conservé et les tableaux cessent de se mettre à jour, tandis que la recherche elle-même continue de fonctionner exactement comme avant.

Les recherches que vous lancez depuis la page du tableau de bord ne sont jamais comptées. Les sites web qui utilisent le mode zéro conservation n'enregistrent aucun texte de recherche, et si vous définissez une politique de conservation, les données de recherche sont supprimées selon le même calendrier que vos conversations.

L'apparence des résultats

Deux réglages sur la page AI Search Bar de votre tableau de bord changent l'apparence de la barre et de ses résultats. Les deux sont enregistrés dès que vous les choisissez et aucun ne demande de modifier le code.

Détail des résultats produit

Sous chaque nom de produit, la barre peut afficher une ligne de la description issue de votre flux de données. L'utilité dépend entièrement de ce que contient votre flux. Un flux de voyages qui indique la durée du séjour et les places restantes mérite d'être affiché. Un flux qui contient une liste d'attributs se lit en revanche comme un export de base de données.

C'est donc vous qui choisissez : le nom seul, une ligne ou deux lignes. Une ligne est la valeur par défaut et convient à la plupart des flux, car elle suffit à distinguer deux produits proches sans surcharger la liste. Cela ne concerne que les résultats produit : un résultat de page affiche toujours le texte qui correspondait à la recherche du visiteur.

Taille de la barre

La barre existe en trois hauteurs : compacte à 38 pixels pour un en-tête étroit, la valeur par défaut à 44 pixels, et grande à 52 pixels pour une page construite autour de la recherche. La taille du texte suit.

La largeur n'est jamais fixée par nous. La barre remplit toujours l'élément dans lequel vous la placez : c'est donc votre mise en page qui décide de la largeur. Le panneau de résultats s'aligne automatiquement sur la barre.

Après avoir changé la taille, recopiez votre code d'intégration. Le nouveau code contient la taille, si bien que la barre est correcte dès le chargement de la page. Sans nouvelle copie, la barre se redimensionne quand même, mais seulement après la première recherche.

Quand une recherche ne trouve rien

Si votre widget de chat se trouve sur la même page, la barre de recherche propose de transmettre la question à votre assistant dès qu'une recherche ne donne aucun résultat. Le visiteur garde sa question et arrive dans le chat avec celle-ci déjà saisie : une impasse devient une conversation. Cette option apparaît uniquement lorsque le widget de chat est présent.

Options

La barre de recherche utilise automatiquement la langue du navigateur de votre visiteur pour l'espace réservé, les titres de résultats et le texte de chargement. Ne les définissez que si vous souhaitez votre propre formulation.

Les deux titres peuvent aussi être renommés sur la page Barre de recherche IA de votre tableau de bord, sans toucher au code. C est plus simple si votre flux contient des articles ou des annonces plutôt que des produits. Un attribut sur la balise script reste prioritaire sur le réglage du tableau de bord.

Tous les attributs sont optionnels et se placent sur la balise script :

• data-placeholder="Search products..." - texte affiché dans la barre de recherche vide
• data-accent="#0a7d4f" - couleur de focus et de surbrillance, pour correspondre à votre marque
• data-max-results="8" - combien de résultats afficher, de 1 à 20
• data-new-tab="true" - ouvrir les résultats dans un nouvel onglet du navigateur
• data-size="sm" - hauteur de la barre : sm, md ou lg. Prend le pas sur la taille définie dans votre tableau de bord
• data-label-products="Products" - titre au-dessus des résultats du flux, dans votre langue - par exemple Articles si votre flux contient des articles
• data-label-pages="Pages" - titre au-dessus des résultats de pages, dans votre langue
• data-label-empty="No results found" - message quand rien ne correspond
• data-label-searching="Searching..." - texte affiché pendant le chargement des résultats
• data-label-ask-ai="Ask our assistant" - formulation de l'option qui transmet une recherche sans résultat à votre chatbot
• data-target=".my-container" - affiche la barre dans cet élément au lieu du conteneur par défaut
• data-replace="auto" - remplace la barre de recherche que votre thème possède déjà, décrite ci-dessus

Utilisation et facturation

Chaque recherche lancée par un visiteur utilise 1 réponse de l'IA de la limite mensuelle de votre plan - la même limite que celle de vos réponses du chatbot. Une recherche se déclenche quand le visiteur fait une pause en tapant, pas à chaque lettre. Les recherches que vous lancez sur la page Barre de recherche IA de votre tableau de bord ne comptent pas. Quand votre limite mensuelle est atteinte, la barre de recherche n'affiche simplement plus de résultats jusqu'à la réinitialisation de la limite.

Bon à savoir

• Les visiteurs peuvent chercher dans n'importe quelle langue, même quand votre contenu est rédigé dans une autre.
• Les fautes de frappe et les mots à moitié tapés trouvent quand même la bonne chose : une recherche de jaket trouve vos vestes.
• Les prix des produits sont affichés avec votre symbole de devise, repris de la devise de votre flux.
• La même page en plusieurs langues n'apparaît qu'une fois - la version correspondant à la langue de recherche l'emporte.
• Les résultats ouvrent de vraies pages de votre site, la barre de recherche sert donc aussi de navigation.
• Le widget est un seul petit script sans dépendances et ne ralentit pas votre page.
• Les commandes clavier fonctionnent d'emblée : flèches pour se déplacer, Entrée pour ouvrir, Échap pour fermer.