Configurazione

Search offre diverse impostazioni che ti permettono di regolarne il comportamento.

Quando modifichi un’impostazione, viene avviata un’analisi dei tuoi dati che deve concludersi 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 sia attivato Search 3.0. Successivamente, puoi accedervi in Search > Configuration.

Attributi rilevanti per la ricerca #

Questa sezione ti consente di personalizzare la 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 livello di rilevanza ti consente di creare gruppi di attributi con diversi livelli di importanza per i risultati di ricerca. Gli attributi nei gruppi con priorità più alta hanno maggiore influenza sui risultati mostrati.

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 brand “Nike” nella categoria “Boots” rispetto agli articoli che hanno quelle parole nell’attributo name.

Questa priorità aiuta a sottolineare 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: Fai attenzione quando modifichi questi gruppi. Aggiungere troppi attributi può causare a Clerk.io di dare meno importanza alla popolarità dei prodotti, concentrandosi solo sulla rilevanza testuale.

Attributi non ricercabili #

Questa sezione ti permette di escludere attributi dall’indice di ricerca, il che significa che il loro testo non sarà ricercabile. È utile per elementi come ID interni, margini o qualsiasi dato che vuoi utilizzare per la visualizzazione o il filtraggio, ma che non vuoi che i clienti possano cercare.

Per impostazione predefinita, 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.
• Usando regole se hai un modello 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/facciate in Search, Omnisearch e Merchandising. Se un attributo prodotto non appare quando configuri facciate o crei una regola di Merchandising, aggiungilo qui e attendi il completamento dell’analisi della configurazione.

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

Comportamento corrispondenza esatta #

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

Search v3 richiesta: Questa funzione è disponibile solo per Store che usano Search v3. Puoi verificare 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 disattiva anche la correzione automatica per garantire che venga mostrata solo la corrispondenza esatta.

I più comuni sono sku e ean, ma possono essere usati tutti gli attributi sincronizzati.

Quando aggiungi un attributo hai due opzioni:

• Restituire una singola corrispondenza esatta, utilizzato al meglio per identificatori unici come SKU o ID prodotto in cui vuoi restituire un prodotto specifico.
• Restituire più corrispondenze esatte, ideale per attributi come ID categoria dove molti prodotti condividono lo stesso valore.

Intervalli prezzo per facciate #

Qui puoi definire l’intervallo di prezzo che sarà utilizzato nei filtri Search. Se lasciato vuoto, Clerk.io li calcolerà dinamicamente in base agli intervalli di prezzo dei tuoi dati prodotto.

Nel campo di testo puoi inserire una lista di valori prezzo separati da virgola, ad esempio: 0,50,100,150,200,…

Dizionario personalizzato #

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

Ad esempio, se il tuo catalogo include prodotti del marchio di sneakers 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 include 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 identificatori unici, quel prodotto viene restituito immediatamente, annullando qualsiasi regola di ricerca o merchandising personalizzata. Altrimenti, la query viene trattata come una ricerca normale.

Sovrascrittura delle impostazioni #

La sovrascrittura delle impostazioni consente di regolare le 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 modificate solo se si sa esattamente quale comportamento Search si vuole modificare.

Le modifiche possono influenzare tutti i risultati Search per lo Store. Anche un piccolo errore di sintassi nel JSON può impedire il salvataggio della sovrascrittura.

Impostazione avanzata: Usa la sovrascrittura delle impostazioni con cautela. Se non sei sicuro che sia necessaria una sovrascrittura, contatta il supporto Clerk.io prima di modificarla.

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 essere diversi da uno Store all’altro.

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

Esempio #

L’esempio seguente mostra la struttura di una sovrascrittura delle impostazioni. Il tuo Store probabilmente 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 di Search.

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

searchableAttributes controlla quali attributi vengono cercati quando un visitatore digita una query.

L’ordine è importante. Gli attributi che compaiono prima nell’elenco sono considerati più importanti per la rilevanza testuale.

filterableAttributes controlla quali attributi possono essere utilizzati come filtri, facciate e regole per restringere i risultati.

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

sortableAttributes controlla quali attributi possono essere usati per 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 rilevanza usate per classificare i risultati corrispondenti.

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

stopWords elenca le parole che devono essere ignorate nelle query di ricerca.

Può essere utile per termini molto comuni che non aiutano i clienti a trovare prodotti, ad esempio “il” o “e”.

nonSeparatorTokens elenca i caratteri che non dovrebbero separare una parola.

Ad esempio, aggiungendo @ puoi aiutare Clerk.io a trattare un termine con quel carattere come un unico valore collegato.

separatorTokens elenca i caratteri che dovrebbero dividere le parole.

Usalo quando i tuoi dati prodotto contengono caratteri che dovrebbero chiaramente separare un termine dall’altro.

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

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

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

Usa i sinonimi quando i clienti cercano frequentemente termini diversi con lo stesso significato nel tuo catalogo.

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

È utile quando le varianti sono indicizzate come prodotti separati, ma vuoi mostrare un solo risultato per prodotto o gruppo principale.

proximityPrecision controlla quanto rigorosamente viene valutata la vicinanza delle parole.

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

typoTolerance controlla come Search gestisce i refusi.

Puoi abilitare o disabilitare la tolleranza refusi, impostare la lunghezza minima delle parole per uno o due refusi e disabilitare la tolleranza refusi per specifiche parole, attributi o numeri.

faceting controlla come vengono restituiti i valori delle facciate.

maxValuesPerFacet imposta quanti valori ogni facciata può restituire. sortFacetValuesBy controlla se i valori delle facciate vengono ordinati alfabeticamente o per conteggio risultati.

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

maxTotalHits è il limite superiore disponibile per i risultati paginati.

embedders è riservato per configurazioni avanzate di ricerca semantica.

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

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

Usa null per mantenere il comportamento predefinito.

localizedAttributes può definire la gestione specifica della lingua per gli attributi che corrispondono a determinati pattern.

Lascialo a null a meno che il tuo Store non abbia una configurazione specifica per l’indicizzazione multilingue.

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

Quando è attivo, clienti e integrazioni possono cercare tra i valori delle facciate, ad esempio trovando un determinato brand all’interno di un lungo filtro brand.

prefixSearch controlla se le parole parziali possono corrispondere mentre il cliente sta scrivendo.

indexingTime abilita la corrispondenza per prefisso per un’esperienza di ricerca in tempo reale più veloce. disabled disattiva la corrispondenza per prefisso.