Configurazione

Search offre diverse impostazioni che ti permettono di regolare il suo comportamento.

Quando modifichi un’impostazione, viene avviata un’analisi dei tuoi dati che deve essere completata prima che i cambiamenti abbiano effetto.

Questo processo può richiedere fino a 15 minuti, ma potrebbe essere più veloce a seconda delle dimensioni del tuo catalogo. Puoi monitorare lo stato in Data > Configuration.

Le impostazioni richiedono che Search 3.0 sia abilitato. Successivamente, puoi accedervi in Search > Configuration.

Attributi ricercabili #

Scegli quali attributi di prodotto sono ricercabili dagli utenti e quanto ogni attributo influenza la corrispondenza.

Trova un attributo in Searchable attributes e scegli la sua Search relevance:

Ad esempio, imposta brand e _category_name su High quando sono importanti per il tuo catalogo. Usa una rilevanza più bassa per i testi di supporto. Evita di impostare ogni attributo su High, così la popolarità dei prodotti può comunque influenzare l’ordine dei risultati.

Usa Not searchable per campi come ID interni o valori di margine che ti servono per la visualizzazione o il filtraggio ma che non vuoi siano ricercabili dagli utenti.

Regole wildcard #

Le regole wildcard permettono di escludere gruppi di attributi dalla ricerca. Scegli Create a rule per un pattern come *url o child*. Le righe contrassegnate Rule mostrano questi pattern. Usa Edit su una regola per modificarla.

Per pattern più specifici, *_url corrisponde agli attributi che terminano con _url, e child_* corrisponde a quelli che iniziano con child_.

Attributi ordinabili #

Aggiungi gli attributi di prodotto che vuoi rendere disponibili per l’ordinamento dei risultati. Questa sezione segue Searchable attributes.

Attributi filtrabili #

Gli attributi in questo elenco diventano disponibili come filtri/facet sia in Search, che in Omnisearch e Merchandising. Se un attributo di prodotto non appare quando configuri i facet o crei una regola Merchandising, aggiungilo qui e attendi che l’analisi della configurazione sia completata.

• Aggiungi attributi dall’elenco degli attributi di prodotto disponibili.
• Le modifiche possono richiedere fino a 15 minuti per essere applicate, a seconda delle dimensioni del catalogo.

Esatta corrispondenza #

Per impostazione predefinita, Clerk.io restituisce tutti i risultati rilevanti per le ricerche sul tuo sito. Tuttavia, in casi specifici — come la ricerca di uno SKU o un numero EAN — potresti aspettarti solo una singola corrispondenza.

Search v3 richiesta: Questa funzionalità è disponibile solo per gli Store che utilizzano Search v3. Puoi controllare questa opzione in Settings > Features > Early access features.

Includendo attributi in questo elenco, configuri Clerk.io per restituire un solo risultato quando la query corrisponde a un valore in questi attributi. Questo disabilita anche la correzione automatica, per assicurare che venga mostrata solo la corrispondenza esatta.

I casi più comuni sono sku e ean, ma si possono utilizzare tutti gli attributi sincronizzati.

Quando aggiungi un attributo, hai due opzioni:

• Restituire una singola corrispondenza esatta, ideale per identificativi unici come SKU o ID di prodotto quando vuoi mostrare un prodotto specifico.
• Restituire più corrispondenze esatte, ideale per attributi come ID di categoria, dove molti prodotti condividono lo stesso valore.

Fasce di prezzo (Facet Price Buckets) #

Qui puoi definire l’intervallo di prezzi che verrà utilizzato nei filtri Search. Se lasciato vuoto, Clerk.io li calcolerà automaticamente in base al range dei prezzi dei tuoi prodotti.

Inserisci i prezzi separati da virgola in Add buckets, ad esempio 0,50,100,150,200. Lascia vuoto per calcolare gli intervalli dinamicamente dai dati dei prodotti.

Dizionario personalizzato #

Il dizionario personalizzato ti consente di definire termini di ricerca che altrimenti verrebbero trattati come parole separate invece che come un unico concetto.

Inserisci un termine in Add term e clicca su Add. Puoi inserire più termini separati da virgola.

Ad esempio, se il tuo catalogo include prodotti del brand di sneaker D.A.T.E., potresti voler aggiungere “D.A.T.E.” e “D. A. T. E.” al dizionario personalizzato.

Criteri #

Clerk.io rileva una query come identificatore univoco quando:

• È alfanumerica e contiene almeno uno dei seguenti caratteri: “-+/&_.0123456789”.
• Ha almeno 4 caratteri.
• Non contiene spazi o virgolette.

Se Clerk.io trova una sola corrispondenza esatta in uno degli attributi identificativi unici, quel prodotto viene restituito subito, sovrascrivendo qualsiasi regola di ricerca o merchandising personalizzata. Altrimenti, la query viene trattata come una normale ricerca.

Override impostazioni #

L’override delle impostazioni ti permette di regolare le impostazioni avanzate dell’indice Search aggiungendo un oggetto JSON in Search > Configuration.

Queste impostazioni controllano come Clerk.io legge, classifica, filtra, ordina e restituisce i risultati di ricerca. Sono impostazioni avanzate e normalmente dovrebbero essere modificate solo se sai esattamente quale comportamento Search vuoi regolare.

Modificandole puoi influenzare tutti i risultati Search dello Store. Anche un piccolo errore di battitura nel JSON può impedire il salvataggio dell’override.

Impostazione avanzata: Usa con cautela l’override delle impostazioni. Se non sei sicuro che sia necessario, contatta il supporto Clerk.io prima di modificarlo.

Attributi specifici dello Store #

Attributi come brand, color, size, sku, price o campi di categoria personalizzati dipendono dai dati sincronizzati in ogni Store.

Questo significa che displayedAttributes, filterableAttributes, searchableAttributes e sortableAttributes possono variare tra uno Store e l’altro.

Gli attributi che iniziano con un underscore, come _all_categories, _category_name o _price_range, vengono generati da Clerk.io e sono disponibili per tutti gli Store.

Esempio #

L’esempio seguente mostra la struttura di un override di impostazioni. È probabile che il tuo Store utilizzi attributi diversi.

{
  "displayedAttributes": [
    "_all_categories",
    "_category_name",
    "_price_range",
    "brand",
    "categories",
    "description",
    "id",
    "image",
    "name",
    "price",
    "stock",
    "url"
  ],
  "searchableAttributes": [
    "high_relevance",
    "medium_relevance",
    "low_relevance"
  ],
  "filterableAttributes": [
    "_all_categories",
    "_category_name",
    "_price_range",
    "brand",
    "categories",
    "price",
    "stock"
  ],
  "sortableAttributes": [
    "created_at",
    "name",
    "price"
  ],
  "rankingRules": [
    "sort",
    "words",
    "typo",
    "attribute",
    "proximity",
    "clerk.popularity:desc"
  ],
  "stopWords": [],
  "nonSeparatorTokens": [],
  "separatorTokens": [],
  "dictionary": [],
  "synonyms": {},
  "distinctAttribute": null,
  "proximityPrecision": "byAttribute",
  "typoTolerance": {
    "enabled": true,
    "minWordSizeForTypos": {
      "oneTypo": 3,
      "twoTypos": 8
    },
    "disableOnWords": [],
    "disableOnAttributes": [
      "high_relevance.id",
      "high_relevance.sku"
    ],
    "disableOnNumbers": false
  },
  "faceting": {
    "maxValuesPerFacet": 100,
    "sortFacetValuesBy": {
      "*": "alpha"
    }
  },
  "pagination": {
    "maxTotalHits": 1000000
  },
  "embedders": {},
  "searchCutoffMs": null,
  "localizedAttributes": null,
  "facetSearch": true,
  "prefixSearch": "indexingTime"
}

Impostazioni disponibili #

displayedAttributes controlla quali attributi Clerk.io può restituire nei risultati Search.

Usala quando vuoi che i risultati Search includano solo i campi necessari per i tuoi design, le risposte API o la logica frontend.

searchableAttributes controlla quali attributi sono ricercati quando un visitatore scrive una query.

L’ordine è importante. Gli attributi all’inizio dell’elenco sono considerati più importanti per la rilevanza del testo.

filterableAttributes controlla quali attributi possono essere usati per filtri, facet e regole che restringono i risultati.

Aggiungi un attributo qui se deve essere selezionabile come facet o utilizzabile nella logica di filtro. Gli attributi di prodotto specifici dello Store devono esistere nei dati sincronizzati prima di poter essere utilizzati.

sortableAttributes controlla quali attributi i risultati Search possono essere ordinati.

Aggiungi campi come price, created_at o name se vuoi usarli per l’ordinamento.

rankingRules controlla l’ordine delle regole di rilevanza usate per classificare i risultati corrispondenti.

Le regole in cima hanno l’influenza maggiore. Regole personalizzate come clerk.popularity:desc possono essere usate per posizionare più in alto i prodotti popolari dopo i controlli di rilevanza precedenti.

stopWords elenca parole che dovrebbero essere ignorate nelle query di ricerca.

Utile per parole molto comuni che non aiutano l’utente a trovare prodotti, come “il” o “e”.

nonSeparatorTokens elenca caratteri che non devono dividere una parola.

Ad esempio, aggiungere @ può aiutare Clerk.io a trattare un termine contenente quel carattere come un unico valore collegato.

separatorTokens elenca caratteri che devono dividere le parole.

Usa questa opzione quando i dati dei tuoi prodotti contengono caratteri che dovrebbero chiaramente separare un termine da un altro.

dictionary elenca i termini che dovrebbero essere trattati come una sola parola o concetto.

Utile per nomi di brand, abbreviazioni o termini di prodotto che normalmente verrebbero suddivisi in più parti.

synonyms associa un termine di query a parole o frasi equivalenti.

Utilizza i sinonimi quando i clienti cercano spesso termini diversi che hanno lo stesso significato nel tuo catalogo.

distinctAttribute raggruppa i risultati per un attributo condiviso e restituisce un risultato per ogni valore unico.

Utile quando le varianti sono indicizzate come prodotti separati, ma vuoi un solo risultato per ogni prodotto padre o gruppo.

proximityPrecision controlla quanto rigorosamente viene valutata la vicinanza tra le parole.

byWord confronta la distanza esatta tra le parole corrispondenti. byAttribute verifica se le parole corrispondenti appaiono nello stesso attributo.

typoTolerance controlla come Search gestisce gli errori ortografici.

Puoi abilitare o disabilitare la tolleranza agli errori, impostare la lunghezza minima della parola per uno o due errori, e disabilitarla per parole, attributi o numeri specifici.

faceting controlla come vengono restituiti i valori dei facet.

maxValuesPerFacet imposta quanti valori può restituire ogni facet. sortFacetValuesBy controlla se i valori dei facet sono ordinati alfabeticamente o per conteggio risultati.

pagination controlla il numero massimo di risultati Search che possono essere restituiti per una query.

maxTotalHits è il limite superiore disponibile per i risultati impaginati.

embedders è riservato per configurazioni avanzate di ricerca semantica.

Lascialo vuoto salvo consiglio del supporto Clerk.io.

searchCutoffMs imposta il tempo massimo, in millisecondi, che Search può dedicare a una query prima di restituire i migliori risultati trovati fino a quel momento.

Usa null per mantenere il comportamento predefinito.

localizedAttributes può definire una gestione specifica per lingua per la corrispondenza dei pattern attributo.

Lascialo su null a meno che lo Store non abbia una configurazione di indicizzazione multilingue specifica.

facetSearch controlla se sia possibile cercare tra i valori dei facet.

Se abilitato, utenti e integrazioni possono cercare all’interno dei valori di facet, come per esempio trovare uno specifico brand dentro un filtro brand molto lungo.

prefixSearch controlla se le parole parziali possono essere corrisposte mentre l’utente sta scrivendo.

indexingTime abilita la corrispondenza dei prefissi per una ricerca-as-you-type più veloce. disabled disattiva la corrispondenza dei prefissi.