Configurazione

Search include 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 le modifiche 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, potrai accedervi in Search > Configuration.

Pertinenza della ricerca attributi #

Questa sezione ti consente di personalizzare la tua ricerca in base alle tue esigenze. Hai due opzioni: Ordine di rilevanza degli attributi ricercabili e Attributi non ricercabili.

Ordine di rilevanza degli attributi ricercabili #

L’impostazione Attributi ricercabili raggruppati per ordine di rilevanza ti permette di creare gruppi di attributi con diversi livelli di importanza nei risultati di ricerca. Gli attributi nei gruppi di livello più alto hanno maggiore influenza sui risultati visualizzati.

Ad esempio, se il gruppo 1 contiene "brand" e _category_name, mentre il gruppo 2 contiene name e color, una ricerca per “blue Nike boots” darà priorità ai prodotti con il brand “Nike” nella categoria “Boots” rispetto agli articoli che presentano quelle parole nell’attributo name.

Questa priorità aiuta a enfatizzare dati significativi come generi, specifiche o altri attributi chiave.

Ad esempio, nelle librerie spesso è più rilevante dare priorità all’autore di un libro. Una ricerca per “Stephen” dovrebbe dare priorità ai libri di Stephen King rispetto a quelli che includono “Stephen” nei titoli.

Nota: Sii cauto nel modificare questi gruppi. Aggiungere troppi attributi potrebbe portare Clerk.io a dare meno priorità alla popolarità dei prodotti, focalizzandosi solo sulla rilevanza testuale.

Attributi non ricercabili #

Questa sezione ti permette di escludere attributi dall’indice di ricerca, rendendo il loro testo non ricercabile. È utile per elementi come ID interni, valori di margine o qualsiasi dato che vuoi usare per la visualizzazione o il filtraggio, ma che non vuoi che i clienti cerchino.

Di default, gli attributi price e stock sono inclusi nell’elenco per evitare che le ricerche contenenti numeri siano distorte da questi attributi. Puoi personalizzare questa lista secondo necessità.

Puoi aggiungere attributi non ricercabili in due modi:

• Manualmente dalla lista degli attributi disponibili.
• Utilizzando regole, se hai una serie di attributi con nomi simili.

Le regole sono particolarmente utili se vuoi escludere più attributi contemporaneamente. Basta usare il carattere jolly (*):

• *_url corrisponderà a tutti gli attributi che terminano con _url
• child_* corrisponderà a tutti gli attributi che iniziano con child_

Attributi filtrabili #

Gli attributi in questo elenco diventano disponibili come filtri/faccette per Search, Omnisearch e Merchandising. Se un attributo di prodotto non compare quando configuri le faccette o crei una regola Merchandising, aggiungilo qui e attendi il completamento dell’analisi di configurazione.

• Aggiungi attributi dalla lista degli attributi prodotto disponibili.
• Le modifiche possono richiedere fino a 15 minuti per essere applicate a seconda della dimensione del catalogo.

Comportamento di corrispondenza esatta #

Di default, Clerk.io restituisce tutti i risultati pertinenti per le ricerche effettuate sul tuo sito. Tuttavia, in casi specifici — come la ricerca di un numero SKU o EAN — potresti aspettarti solo una corrispondenza singola.

Search v3 richiesto: Questa funzionalità è disponibile solo per Store che utilizzano Search v3. Puoi controllarlo 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 quegli attributi. Questo disabilita anche l’auto-correzione per mostrare solo la corrispondenza esatta.

I più comuni sono sku e ean, ma è possibile utilizzare qualsiasi attributo sincronizzato.

Quando aggiungi un attributo hai due opzioni:

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

Fasce di prezzo #

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

Nel campo di testo puoi inserire una lista di valori di prezzo separati da virgole, es.: 0,50,100,150,200,…

Dizionario personalizzato #

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

Ad esempio, se il tuo catalogo include prodotti del marchio 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 identificativo univoco quando:

• È alfanumerica e comprende 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 immediatamente, sovrascrivendo qualsiasi regola personalizzata di ricerca o merchandising. Diversamente, la query viene trattata come una normale ricerca.

Override delle impostazioni #

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

Queste impostazioni controllano come Clerk.io legge, ordina, filtra, classifica e restituisce i risultati di ricerca. Sono impostazioni avanzate e dovrebbero essere cambiate solo quando sai esattamente quale comportamento Search desideri modificare.

Modificandole potresti influire su tutti i risultati Search dello Store. Un piccolo errore di battitura in JSON può impedire il salvataggio dell’override.

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

Attributi specifici dello Store #

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

Questo significa che displayedAttributes, filterableAttributes, searchableAttributes e sortableAttributes possono variare da Store a Store.

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

Esempio #

L’esempio sotto mostra la struttura di un override delle impostazioni. Probabilmente il tuo Store utilizzerà 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.

Usalo se vuoi che i risultati Search includano solo i campi necessari ai tuoi design, alle risposte API o alla logica frontend.

searchableAttributes controlla quali attributi vengono ricercati quando un visitatore inserisce una query.

L’ordine è importante. Gli attributi più in alto nella lista sono considerati più rilevanti ai fini testuali.

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

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

sortableAttributes controlla in base a quali attributi si possono ordinare i risultati Search.

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

rankingRules controlla l’ordine delle regole di pertinenza utilizzate per ordinare i risultati corrispondenti.

Le regole più in alto hanno maggiore influenza. Le regole personalizzate come clerk.popularity:desc possono essere utilizzate per far risaltare i prodotti popolari dopo i controlli di pertinenza precedenti.

stopWords elenca le parole che dovrebbero essere ignorate nelle query.

Utile per parole molto comuni che non aiutano i clienti a trovare i prodotti, come “il” o “e”.

nonSeparatorTokens elenca i caratteri che non dovrebbero separare una parola.

Ad esempio, aggiungendo @ Clerk.io tratterà un termine contenente quel carattere come un unico valore connesso.

separatorTokens elenca i caratteri che devono dividere le parole.

Usalo se i tuoi dati prodotto contengono caratteri che dovrebbero chiaramente separare un termine da un altro.

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

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

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

Usa i sinonimi quando gli utenti cercano spesso con termini diversi che significano la stessa cosa nel tuo catalogo.

distinctAttribute raggruppa risultati per lo stesso attributo e restituisce un solo risultato per ogni valore univoco.

Utile quando le varianti sono indicizzate come prodotti separati ma vuoi un solo risultato per prodotto “genitore” 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 di battitura.

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

faceting controlla come vengono restituite le faccette.

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

pagination controlla il numero massimo di risultati che Search può restituire per una query.

maxTotalHits è il limite massimo disponibile per i risultati paginati.

embedders è riservato a configurazioni avanzate di ricerca semantica.

Lascialo vuoto a meno che il supporto Clerk.io non ti abbia consigliato di configurarlo.

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

Usa null per mantenere il comportamento predefinito.

localizedAttributes può definire una gestione specifica della lingua per la corrispondenza di attributi.

Lascialo come null a meno che il tuo Store non abbia una configurazione di indicizzazione multilingue specifica.

facetSearch controlla se è possibile cercare tra i valori delle faccette.

Se abilitato, gli utenti e le integrazioni possono ricercare tra i valori delle faccette, ad esempio trovando un brand specifico in un lungo filtro brand.

prefixSearch controlla se le corrispondenze su parole parziali sono possibili mentre l’utente digita.

indexingTime abilita la corrispondenza su prefisso per una ricerca rapida mentre si digita. disabled disattiva la ricerca su prefisso.