Ricerca dei prodotti sul sito

La ricerca dei prodotti è una barra di ricerca del sito con suggerimenti durante la digitazione e una pagina dei risultati che OneTrace.pro riempie con i prodotti del Suo catalogo. La ricerca comprende errori di battitura, forme delle parole, query digitate con il layout di tastiera sbagliato, prezzo e brand nel testo della query e il significato delle query descrittive, e ordina i primi risultati in base agli interessi del visitatore e a ciò che scelgono gli altri clienti. Il widget di ricerca pronto disegna da solo i suggerimenti e la pagina dei risultati, senza codice sul sito.

Per funzionare servono il tracker installato (Collegamento del sito) e un catalogo prodotti (Raccomandazioni e catalogo prodotti). La ricerca non è inclusa in tutti i piani: se il Suo non la prevede, nel menu non c'è la voce Ricerca dei prodotti, il blocco con il codice nella scheda di installazione non viene mostrato e le richieste di ricerca ricevono l'errore «funzione non disponibile».

Come vengono cercati i prodotti

• Le parole della query vengono cercate nel nome, nel brand, nelle categorie e nelle caratteristiche del prodotto; il codice articolo solo per corrispondenza esatta.
• Si tiene conto delle forme delle parole nelle lingue del progetto: «куртки» trova «Куртка зимняя». Le lingue si impostano nelle impostazioni del progetto, veda Impostazioni del progetto, piano e registro attività.
• Gli errori di battitura vengono corretti: «крутка» trova «куртку», «dres» trova «dress».
• Funziona anche una query digitata con il layout di tastiera sbagliato: «ghbdtn» viene cercato come «привет».
• Se nessun prodotto contiene tutte le parole, la ricerca mostra i prodotti che ne contengono almeno una.
• I prodotti popolari e disponibili compaiono più in alto. La popolarità deriva dalle raccomandazioni e si aggiorna una volta al giorno.
• I primi risultati vengono riordinati in base agli interessi del visitatore: salgono i prodotti delle categorie e dei brand che ha visto e acquistato.
• Misure e parametri nella query, come «205/55 r16», «5x112», «invernali», diventano filtri se il settore del negozio li prevede.
• Prezzo, brand e valori delle caratteristiche nel testo diventano filtri, veda Comprensione della query.
• Una query descrittiva trova i prodotti anche per significato, veda Ricerca per significato.
• I prodotti scelti e acquistati più spesso per questa query compaiono più in alto, veda Apprendimento dal comportamento.

I prodotti nuovi e modificati del catalogo entrano nella ricerca entro un minuto dal caricamento del feed o da una richiesta API.

Correzione degli errori di battitura

Se la query non trova nulla o trova prodotti solo per una parte delle parole, la ricerca corregge le parole in base al dizionario del Suo catalogo (nomi dei prodotti in tutte le lingue del catalogo, brand, categorie e ricerche popolari del sito) e cerca di nuovo. I risultati della query corretta vengono mostrati con la nota «Sono mostrati i risultati per «…».» e il link «Cerca invece «…»», per trovare esattamente ciò che è stato digitato. Se i prodotti sono stati trovati solo con una parte delle parole, la correzione viene proposta con il suggerimento «Forse cercava «…»?». I risultati trovati con tutte le parole o per significato non ricevono il suggerimento: una parola assente dal catalogo non è necessariamente un errore di battitura.

Il dizionario si aggiorna da solo dopo le modifiche al catalogo. Anche nei suggerimenti durante la digitazione la query corretta compare come riga, se per quella digitata non ci sono prodotti.

Comprensione della query

La ricerca riconosce nel testo della query ciò che di solito il visitatore sceglie con i filtri e lo applica subito:

Un numero con un'unità di misura, come «fino a 3 anni», «fino a 5 kg», non viene considerato un prezzo. Ciò che è stato riconosciuto compare nei risultati come filtri selezionati: il visitatore vede perché i risultati sono filtrati e può rimuovere il filtro; da quel momento quell'elemento del testo non viene più riconosciuto. Se con i filtri riconosciuti non si trova nulla, la ricerca viene ripetuta sul testo normale.

Ricerca per significato

Una query descrittiva, come «scarpe per correre in montagna», «cosa regalare alla mamma», «per la pioggia», può non contenere nessuna parola dei nomi dei prodotti. Per queste query la ricerca cerca in più i prodotti vicini per significato: OneTrace.pro conserva per ogni prodotto una descrizione semantica ricavata dai nomi del prodotto e delle categorie in tutte le lingue del catalogo, dal brand e dalle caratteristiche.

• Il significato si attiva per le query di tre parole o più, e per le query le cui parole non trovano nulla o trovano solo in parte. Le query brevi che trovano risultati per parole vengono cercate come prima.
• I prodotti trovati sia per parole sia per significato compaiono più in alto.
• Una query in un'altra lingua trova i prodotti per significato se il catalogo contiene le traduzioni dei nomi.
• Una query che non riguarda i prodotti del negozio, come «assicurazione auto» in un negozio di abbigliamento, di solito non ottiene nulla per significato.
• Il significato funziona con l'ordinamento per pertinenza.

Le descrizioni semantiche vengono ricalcolate solo per i prodotti modificati, di solito entro un minuto dal caricamento del catalogo.

Apprendimento dal comportamento

Una volta al giorno la ricerca impara dagli eventi del sito degli ultimi 90 giorni: per ogni query cercata da almeno 5 visitatori diversi trova i prodotti cliccati nei risultati da almeno due di loro, e l'acquisto del prodotto dopo il clic vale come tre clic. Questi prodotti salgono in cima ai risultati di quella query, solo tra quelli trovati e solo con l'ordinamento per pertinenza.

Nel report della pagina Sito → Ricerca dei prodotti l'indicatore Ricerche apprese dice per quante query l'ordine tiene già conto del comportamento; nella tabella queste query hanno l'etichetta «appresa».

Widget di ricerca

Il widget di ricerca è un insieme di suggerimenti e pagina dei risultati pronti, disegnati dal tracker. Si attiva nella pagina Sito → Ricerca dei prodotti, nel blocco Widget di ricerca: selezioni Mostra il livello di ricerca sul sito e salvi.

Livello di ricerca. Al clic nel campo di ricerca, sotto di esso si apre un livello: le ricerche recenti del visitatore, le tendenze del momento e i prodotti per il visitatore. Durante la digitazione: suggerimenti di query, categorie, brand, pagine del sito dalla base di conoscenza e prodotti con immagine e prezzo. Sullo smartphone il livello si apre a schermo intero. Il livello si collega ai campi con l'attributo data-cdp-search e ai campi indicati in Altri campi di ricerca del sito (selettore CSS), ad esempio al campo di ricerca del Suo tema senza modificarne il codice.

Il blocco Anteprima mostra il livello e i risultati reali sui prodotti del Suo catalogo.

Pagina dei risultati. Inserisca nella pagina di ricerca del sito un contenitore: il tracker disegnerà i risultati con filtri, ordinamento e caricamento durante lo scorrimento:

<div data-cdp-search-results data-query-param="q"></div>

La query e i filtri sono salvati nell'indirizzo della pagina: un link con i risultati si può condividere e «Indietro» ripristina la scelta precedente. data-query-param è il parametro della query nell'indirizzo (per impostazione predefinita q), data-per-page il numero di prodotti per pagina (fino a 48), data-cart-url l'indirizzo del carrello, se diverso da quello delle impostazioni. Se il sito non ha né una pagina dei risultati né un modulo di ricerca, i risultati si aprono in una finestra sopra la pagina.

Pulsante «Aggiungi al carrello». Il pulsante invia una POST all'indirizzo del carrello del Suo sito con la quantità quantity e attende una risposta JSON: {"ok": true} significa che il prodotto è stato aggiunto e il pulsante mostra «Aggiunto»; {"ok": false, "redirect": "…"} significa che occorre scegliere una variante del prodotto e si apre la pagina indicata. Dopo l'aggiunta il tracker lo comunica al sito con l'evento cdp:add-to-cart, con cui il tema aggiorna il mini-carrello. L'indirizzo del carrello deve trovarsi sul dominio del sito: il carrello di un altro sito non vede il cliente.

Plugin per i negozi. Nei plugin per WooCommerce e Magento 2 e nel modulo per 1C-Bitrix attivi l'impostazione del widget di ricerca: la pagina di ricerca del negozio mostrerà i risultati del widget e il pulsante «Aggiungi al carrello» aggiungerà i prodotti al carrello del negozio. Finché il widget è disattivato qui, il negozio mostra la propria pagina di ricerca.

Barra di ricerca

Senza il widget, i suggerimenti si possono collegare al campo di ricerca del Suo sito con l'attributo data-cdp-search:

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

Durante la digitazione, sotto il campo compaiono i suggerimenti: le ricerche popolari del sito, le categorie pertinenti e i prodotti con immagine e prezzo. Si possono scorrere con le frecce, Invio apre la riga selezionata, Esc chiude i suggerimenti. Invio senza una riga selezionata invia il modulo del sito come di consueto.

I suggerimenti usano il font del sito e non contengono testi dell'interfaccia, quindi si adattano a un sito in qualsiasi lingua.

Pagina dei risultati

I plugin pronti per i negozi online inseriscono da soli i risultati nella pagina di ricerca del negozio. Sul Suo sito, ottenga i prodotti dal tracker:

window.addEventListener('load', async () => {
  const q = new URLSearchParams(location.search).get('q');
  const result = await cdp.search(q, { perPage: 24 });
  // result.items — prodotti, result.total — quanti ne sono stati trovati, result.facets — categorie, brand, prezzi e caratteristiche per i filtri
});

Parametri: category, brand, priceMin, priceMax, sort (relevance, popular, price_asc, price_desc), page, perPage, attributes. Al clic su un prodotto chiami cdp.searchResultClicked(prodotto).

Filtri delle caratteristiche. result.facets.attributes contiene le caratteristiche del settore del negozio con le etichette nella lingua del visitatore e il numero di prodotti per ogni valore, ad esempio «Diametro, pollici»: 16, 17, 18. Passi i valori scelti in attributes: cdp.search(q, { attributes: { rim_diameter: [17, 18], season: 'winter' } }). Più valori della stessa caratteristica si combinano con «o», caratteristiche diverse con «e». result.filters contiene le misure e i parametri riconosciuti nel testo della query: li mostri al visitatore, così si capisce perché i risultati sono filtrati. Serve il tracker 1.15.0.

Se per la ricerca è impostato un reindirizzamento (vedere Regole per le ricerche), result.redirect contiene l’indirizzo della pagina: lo apra al posto dei risultati.

Nella risposta ci sono anche: result.corrected — i risultati sono mostrati per la query corretta, result.suggestion — «Forse cercava», result.filters — anche il prezzo (price_min, price_max) e il brand riconosciuti nel testo, result.learned — l'ordine tiene conto del comportamento dei visitatori, result.semantic — ci sono prodotti trovati per significato. Opzioni: correct: false — cercare esattamente ciò che è stato digitato, ignore: ['price'] — non riconoscere nel testo il prezzo, il brand (brand) o una caratteristica.

I server possono effettuare le stesse richieste con una chiave di scrittura: https://cdp.onetrace.pro/api/v1/search e https://cdp.onetrace.pro/api/v1/search/suggest. L'elenco completo dei parametri è nel riferimento dell'API: https://cdp.onetrace.pro/api/v1/openapi.json.

Report delle ricerche

La pagina Sito → Ricerca dei prodotti mostra che cosa cercano i visitatori sul Suo sito negli ultimi 7, 30 o 90 giorni:

• Ricerche e visitatori: quante volte si è cercato e quante persone diverse.
• Senza risultati: la quota di ricerche che non hanno trovato nulla.
• CTR: la quota di visitatori che hanno cliccato un prodotto nei risultati della propria ricerca.
• Acquisti e ricavi: un prodotto cliccato nei risultati e acquistato dallo stesso cliente entro 7 giorni. I ricavi sono calcolati al prezzo del prodotto nel catalogo. Compaiono se nelle impostazioni delle raccomandazioni è definito un evento di acquisto, vedere Raccomandazioni e catalogo prodotti.
• Ricerche apprese: per quante query l'ordine dei risultati tiene conto di clic e acquisti, vedere Apprendimento dal comportamento.

Tabelle sotto il grafico:

Le ricerche vengono confrontate senza considerare maiuscole e spazi in più. Da una riga della tabella può aggiungere subito un sinonimo o una regola per la ricerca.

Sinonimi

I sinonimi sono parole e frasi cercate insieme: una ricerca con qualsiasi parola del gruppo trova anche i prodotti delle altre. Ad esempio, con il gruppo «sneakers, scarpe da ginnastica, tennis», la ricerca «tennis bianche» trova anche le sneakers bianche.

• Gruppo bidirezionale: ogni parola viene cercata come le altre.
• Gruppo unidirezionale: solo la prima parola viene cercata come le altre: «cellulare → smartphone» trova gli smartphone cercando «cellulare», ma «smartphone» non viene cercato come «cellulare».

Una parola o frase del gruppo viene sostituita nella ricerca solo se compare per intero. I sinonimi valgono subito dopo il salvataggio, nei risultati e nei suggerimenti. Un progetto può avere fino a 500 gruppi, un gruppo fino a 20 parole.

Regole per le ricerche

Una regola si applica quando un visitatore cerca esattamente questa ricerca (senza considerare maiuscole, spazi in più e punteggiatura alle estremità) ed esegue una o entrambe le azioni:

• Prodotti fissati: fino a 24 prodotti, nell’ordine scelto, compaiono in cima ai risultati anche se la ricerca non li trova. Gli altri risultati seguono senza ripetizioni. Il fissaggio vale con l’ordinamento per pertinenza e senza filtri; i prodotti non disponibili non vengono mostrati.
• Reindirizzamento: al posto dei risultati si apre una pagina del Suo sito, ad esempio «spedizione» → la pagina delle condizioni di spedizione.

I reindirizzamenti vengono eseguiti dalla casella di ricerca del tracker (Invio su una ricerca con regola), da cdp.search() sulla Sua pagina dei risultati (campo redirect) e dai plugin per WooCommerce e Magento 2. Un progetto può avere fino a 1000 regole.

Limite delle richieste

Le richieste di ricerca, sia le pagine dei risultati sia i suggerimenti durante la digitazione, rientrano nel limite mensile del piano. Il limite cresce con il volume di profili del piano: «Crescita» 20 richieste per profilo del volume al mese, «Enterprise» 40; nel periodo di prova 50.000 richieste. Il consumo è visibile nella sezione «Piano e fatturazione», veda Piano e fatturazione.

Il proprietario del progetto riceve email al 90% e al 100% del limite. Per un ulteriore 10% oltre il limite la ricerca continua a funzionare, poi non è disponibile fino all'inizio del mese successivo: il widget smette di intercettare il campo di ricerca del sito e nei risultati indica che la ricerca non è disponibile, mentre i plugin dei negozi mostrano subito la ricerca integrata del negozio. Una pagina dei risultati propria riceve in cdp.search() l'indicatore unavailable: mostri la ricerca del Suo sito.

Statistiche

Il tracker registra due eventi:

Dagli eventi search degli ultimi 30 giorni si ricavano le ricerche popolari nei suggerimenti. Gli eventi sono visibili nella scheda del profilo del cliente e disponibili nei segmenti, ad esempio «ha cercato ma non ha acquistato», veda Segmenti.