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.ru riempie con i prodotti del Suo catalogo. La ricerca comprende errori di battitura, forme delle parole e query digitate con il layout di tastiera sbagliato, e ordina i primi risultati in base agli interessi del visitatore: cosa ha visto e acquistato.

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, 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.

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

Barra di ricerca

Aggiunga al campo di ricerca del Suo sito 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.

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

Report delle ricerche

La scheda Ricerca della sezione «Sito» 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.

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.

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.