Torna alla Dashboard

Documentazione

Scopri come usare Asyntai

Barra di ricerca IA

Una barra di ricerca per il tuo sito web che capisce il significato - i visitatori trovano subito prodotti e pagine dalla tua Knowledge Base

Apri la barra di ricerca IA
Standard, Pro ed Enterprise

Panoramica

La barra di ricerca IA è un widget di ricerca autonomo per il tuo sito web. I visitatori scrivono con le loro parole e i risultati corrispondenti appaiono sotto la barra quando fanno una pausa: i prodotti dal tuo feed dati in tempo reale come schede con immagine e prezzo, e le pagine dalla tua Knowledge Base con un titolo, una breve anteprima e un link. Poiché cerca per significato e non solo per parole chiave esatte, un visitatore che scrive una descrizione trova comunque l'articolo giusto.

Usa la stessa Knowledge Base del tuo chatbot, quindi non c'è niente altro da indicizzare o mantenere. I due widget sono indipendenti: usa la barra di ricerca da sola, il widget chat da solo, o entrambi insieme sulle stesse pagine.

Ricerca...

Aggiungerla al tuo sito web

La barra di ricerca AI richiede il piano Standard o superiore. Con un piano inferiore la barra compare sul tuo sito ma non restituisce mai risultati, quindi controlla prima il piano se non succede nulla.

Il tuo ID widget è indicato nella pagina Barra di ricerca AI della dashboard.

Il modo più semplice: sostituisci il campo di ricerca che hai già

Se il tuo sito ha già una ricerca - quella del tema Shopify, un modulo WordPress o la tua - non devi posizionare nulla né modificare il tema. Aggiungi data-replace al tag script: il widget trova il modulo esistente, lo nasconde e compare esattamente al suo posto:

<script src="https://widget.asyntai.com/static/js/search-widget.js" data-asyntai-id="YOUR_WIDGET_ID" data-replace="auto" async></script>

Questo script può stare ovunque nella pagina, quindi va bene qualsiasi plugin che aggiunge codice all intestazione o al piè di pagina. Premere Invio senza scegliere un risultato apre ancora la tua vecchia pagina dei risultati, così nulla di ciò che i visitatori conoscono smette di funzionare. Se il rilevamento automatico sceglie l elemento sbagliato su un tema insolito, passa un selettore CSS invece di auto, ad esempio data-replace=".header-search". Quando non corrisponde nulla, il widget lascia la pagina intatta.

Posizionarla da te

Se non hai ancora una barra di ricerca, o la vuoi in un punto preciso, incolla entrambe le righe dove deve comparire - per esempio nell intestazione accanto al logo. La barra riempie la larghezza dell elemento in cui la inserisci, il che di solito significa modificare un file del tema.

<div data-asyntai-search></div>
<script src="https://widget.asyntai.com/static/js/search-widget.js" data-asyntai-id="YOUR_WIDGET_ID" async></script>

Se qualcosa non funziona

  • Non compare nessuna barra. Controlla che l ID widget nello script corrisponda a quello della pagina Barra di ricerca AI e che il codice sia davvero sulla pagina pubblicata, non solo in una bozza o in un anteprima.
  • La barra compare ma non restituisce mai risultati. Quasi sempre è il piano: la ricerca funziona da Standard in su. È anche ciò che vedi quando il limite mensile di risposte AI è esaurito.
  • Ottieni pagine ma nessun prodotto. I prodotti arrivano da un Real-Time Data Feed. Collegane uno nella pagina Barra di ricerca AI e controlla che la casella di quella fonte sia spuntata.
  • Non ottieni nulla, con nessuna ricerca. La tua base di conoscenza potrebbe essere ancora vuota. Scansiona il sito o aggiungi contenuti nella dashboard e riprova.
  • data-replace non ha trovato il tuo campo di ricerca. Alcuni temi nascondono la ricerca dietro un pulsante o un pop-up. Passa un selettore CSS dell elemento che vuoi al posto di auto e controlla la pagina in una normale finestra del browser, non nell editor del tema.

Fonti di ricerca

Due caselle di controllo nella pagina Barra di ricerca IA della tua dashboard controllano cosa può usare la ricerca: le pagine del sito web (pagine scansionate e URL aggiunti) e il tuo feed dati in tempo reale. Entrambe sono attive per impostazione predefinita. Il feed non è limitato ai prodotti - qualsiasi cosa tu indicizzi lì, come articoli o annunci, può apparire come risultato. Una modifica si applica subito sul tuo sito.

I risultati dei prodotti richiedono un feed dati collegato. Funzionano entrambi i tipi: il Feed Dati in Tempo Reale dal piano Standard in su e Feed Dati in Tempo Reale Max su Pro. Senza feed la ricerca funziona comunque, restituisce soltanto le pagine del tuo sito web, e la pagina della dashboard segnala il feed come non collegato, così sai perché non compaiono prodotti.

Analisi delle ricerche

La pagina Barra di ricerca IA nella tua dashboard mostra le ricerche degli ultimi 30 giorni: quante ne sono state fatte, quante non hanno trovato nulla e quanto spesso un visitatore ha aperto un risultato. Due tabelle elencano le tue ricerche più frequenti e le ricerche senza risultati. La seconda tabella è quella utile, perché ti dice esattamente cosa i visitatori si aspettano e non riescono a trovare.

La registrazione è attiva per impostazione predefinita e puoi disattivarla con una casella nella stessa pagina. Con la registrazione disattivata non viene memorizzato alcun testo di ricerca e le tabelle smettono di aggiornarsi, mentre la ricerca stessa continua a funzionare esattamente come prima.

Le ricerche che fai dalla pagina della dashboard non vengono mai conteggiate. I siti web che usano la Modalità zero conservazione non registrano alcun testo di ricerca e, se imposti una politica di conservazione, i dati delle ricerche vengono eliminati con la stessa pianificazione delle tue conversazioni.

Come appaiono i risultati

Due impostazioni nella pagina AI Search Bar della tua dashboard cambiano l'aspetto della barra e dei suoi risultati. Entrambe si salvano appena le scegli e nessuna richiede modifiche al codice.

Dettaglio dei risultati prodotto

Sotto il nome di ogni prodotto la barra può mostrare una riga della descrizione presa dal tuo feed di dati. Se questo aiuti dipende interamente da cosa contiene il feed. Un feed di viaggi che indica la durata del viaggio e i posti rimasti vale la pena mostrarlo. Un feed che contiene invece un elenco di attributi si legge come un dump di database.

La scelta è quindi tua: solo il nome, una riga o due righe. Una riga è l'impostazione predefinita e va bene per quasi tutti i feed, perché basta a distinguere due prodotti simili senza affollare l'elenco. Riguarda solo i risultati prodotto: un risultato di pagina mostra sempre il testo che corrispondeva alla ricerca del visitatore.

Dimensione della barra

La barra è disponibile in tre altezze: compatta a 38 pixel per un'intestazione stretta, la predefinita a 44 pixel e grande a 52 pixel per una pagina costruita attorno alla ricerca. La dimensione del testo cambia di conseguenza.

La larghezza non la impostiamo mai noi. La barra riempie sempre l'elemento in cui la inserisci, quindi la larghezza la decidi con il tuo layout. Il pannello dei risultati si adatta alla barra automaticamente.

Dopo aver cambiato la dimensione, ricopia il codice di incorporamento. Il nuovo codice contiene la dimensione, così la barra è corretta fin dal caricamento della pagina. Se non lo ricopi, la barra si ridimensiona comunque, ma solo dopo la prima ricerca.

Quando una ricerca non trova nulla

Se il widget della chat si trova sulla stessa pagina, la barra di ricerca propone di passare la domanda al tuo assistente ogni volta che una ricerca non dà risultati. Il visitatore mantiene la sua domanda e arriva nella chat con la domanda già scritta, così un vicolo cieco diventa una conversazione. Questa opzione appare solo quando il widget della chat è presente.

Opzioni

La barra di ricerca usa automaticamente la lingua del browser del tuo visitatore per il segnaposto, i titoli dei risultati e il testo di caricamento. Impostali solo se vuoi usare un testo tuo.

Le due intestazioni si possono rinominare anche dalla pagina Barra di ricerca AI della dashboard, senza toccare il codice. È il modo più semplice se il tuo feed contiene articoli o annunci invece di prodotti. Un attributo sul tag script ha comunque la precedenza sull impostazione della dashboard.

Tutti gli attributi sono opzionali e vanno sul tag script:

  • data-placeholder="Search products..." - testo mostrato nella barra di ricerca vuota
  • data-accent="#0a7d4f" - colore di focus ed evidenziazione, da abbinare al tuo brand
  • data-max-results="8" - quanti risultati mostrare, da 1 a 20
  • data-new-tab="true" - apri i risultati in una nuova scheda del browser
  • data-size="sm" - altezza della barra: sm, md o lg. Prevale sulla dimensione impostata nella dashboard
  • data-label-products="Products" - intestazione sopra i risultati del feed, nella tua lingua - ad esempio Articoli se il tuo feed contiene articoli
  • data-label-pages="Pages" - intestazione sopra i risultati delle pagine, nella tua lingua
  • data-label-empty="No results found" - messaggio quando non c'è nessuna corrispondenza
  • data-label-searching="Searching..." - testo mostrato mentre i risultati si caricano
  • data-label-ask-ai="Ask our assistant" - formulazione dell'opzione che passa al tuo chatbot una ricerca senza risultati
  • data-target=".my-container" - mostra la barra dentro questo elemento invece del contenitore predefinito
  • data-replace="auto" - sostituisce la barra di ricerca che il tuo tema ha già, descritta sopra

Utilizzo e fatturazione

Ogni ricerca eseguita da un visitatore usa 1 risposta dell'IA dal limite mensile del tuo piano - lo stesso limite usato dalle risposte del tuo chatbot. Una ricerca parte quando il visitatore fa una pausa mentre scrive, non a ogni lettera. Le ricerche che esegui nella pagina Barra di ricerca IA della tua dashboard non contano. Quando il limite mensile è raggiunto, la barra di ricerca semplicemente non mostra risultati finché il limite non si azzera.

Buono a sapersi

  • I visitatori possono cercare in qualsiasi lingua, anche quando i tuoi contenuti sono scritti in un'altra.
  • Refusi e parole scritte a metà trovano comunque la cosa giusta, quindi una ricerca di jaket trova le tue giacche.
  • I prezzi dei prodotti sono mostrati con il tuo simbolo di valuta, preso dalla valuta indicata nel feed.
  • La stessa pagina in più lingue appare una sola volta - vince la versione che corrisponde alla lingua di ricerca.
  • I risultati aprono pagine reali del tuo sito, quindi la barra di ricerca funziona anche come navigazione.
  • Il widget è un unico piccolo script senza dipendenze e non rallenta la tua pagina.
  • I controlli da tastiera funzionano subito: frecce per spostarsi, Invio per aprire, Escape per chiudere.