Search

Configurazione

Modifiche e impostazioni per adattare Search alla tua attività.
Searchable attributes with a relevance selector for each attribute

Search offre diverse impostazioni che ti permettono di regolarne il 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ù rapido a seconda delle dimensioni del tuo catalogo. Puoi monitorare lo stato in Data > Configuration.

Puoi accedere alle impostazioni in Search > Configuration.

Attributi ricercabili #

Scegli quali attributi di prodotto i clienti possono cercare e quanto ciascun attributo influisce sulla corrispondenza.

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

RilevanzaEffetto
HighLe corrispondenze in questo attributo avranno una rilevanza più alta.
MediumUtilizza la rilevanza normale.
LowLe corrispondenze in questo attributo avranno una rilevanza più bassa.
Not searchableEsclude il testo dall’abbinamento di ricerca.

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 rendere ogni attributo High, così la popolarità del prodotto può comunque aiutare a ordinare i 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 soggetti a ricerca.

Regole wildcard #

Le regole wildcard possono 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_* 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 saranno disponibili come filtri/faccette in Search, Omnisearch e Merchandising. Se un attributo di prodotto non viene visualizzato quando configuri le faccette o crei una regola di Merchandising, aggiungilo qui e attendi il completamento dell’analisi di configurazione.

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

Comportamento di 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 numero SKU o EAN — puoi aspettarti una sola corrispondenza.

Richiesto Search v3: Questa funzione è disponibile solo per Store con Search v3. Puoi verificarlo 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. Ciò disabilita anche la correzione automatica affinché venga mostrata solo la corrispondenza esatta.

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

Quando aggiungi un attributo hai due opzioni:

  • Restituisci singola corrispondenza esatta: ideale per identificatori unici come SKU o ID prodotto quando vuoi restituire un prodotto specifico.
  • Restituisci più corrispondenze esatte: ideale per attributi come ID categoria, quando molti prodotti condividono lo stesso valore.

Fasce di prezzo delle faccette #

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

Inserisci prezzi separati da virgole in Add buckets, ad esempio 0,50,100,150,200. Lascia vuoto per calcolare automaticamente gli intervalli 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 virgole.

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 identificatore univoco quando:

  • È alfanumerico 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 tutte le regole di ricerca o merchandising personalizzate. In caso contrario, la query viene trattata come una ricerca normale.

Sovrascrittura impostazioni #

Settings override ti consente di modificare le impostazioni avanzate dell’indice Search aggiungendo un oggetto JSON in Search > Configuration.

Queste impostazioni controllano come Clerk.io legge, ordina, filtra, ordina e restituisce i risultati di ricerca. Sono impostazioni avanzate e andrebbero modificate solo se sai esattamente quale comportamento di Search desideri modificare.

La modifica può influire su tutti i risultati Search dello Store. Un piccolo errore di battitura nel JSON può impedire il salvataggio della sovrascrittura.

Impostazione avanzata: Usa Settings override con cautela. Se non sei sicuro che sia necessario utilizzare un override, contatta l’assistenza Clerk.io prima di procedere.

Attributi specifici dello store #

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

Per questo motivo displayedAttributes, filterableAttributes, searchableAttributes e sortableAttributes possono variare da Store a Store.

Gli attributi che iniziano con un trattino basso, 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 una Settings override. Il tuo Store utilizzerà probabilmente attributi differenti.

{
  "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.

Utilizzalo quando vuoi che i risultati Search includano solo i campi necessari per i tuoi design, risposte API o logiche frontend.

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

L’ordine è importante: gli attributi più in alto nella lista sono trattati come più importanti per la rilevanza testuale.

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

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

sortableAttributes controlla in base a quali attributi possono essere ordinati i risultati Search.

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

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

Le regole in cima hanno la maggiore influenza. Regole personalizzate come clerk.popularity:desc possono essere utilizzate per spingere in alto i prodotti popolari dopo i controlli precedenti di rilevanza.

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

Questo può essere utile per parole molto comuni che non aiutano i clienti a trovare prodotti, come “il” o “e”.

nonSeparatorTokens elenca i caratteri che non dovrebbero separare una parola.

Ad esempio, aggiungendo @ aiuta Clerk.io a trattare una stringa con quel carattere come un unico valore collegato.

separatorTokens elenca i caratteri che dovrebbero separare le parole.

Usalo quando i dati dei tuoi prodotti contengono caratteri che devono dividere chiaramente 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 di prodotto che normalmente verrebbero separati in più parti.

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

Usa i sinonimi quando i clienti spesso cercano con parole diverse che hanno lo stesso significato nel tuo catalogo.

distinctAttribute raggruppa i risultati in base a un attributo comune e restituisce un risultato per ogni valore univoco.

Utile quando le varianti sono indicizzate come prodotti separati, ma vuoi 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 che le parole corrispondenti compaiano nello stesso attributo.

typoTolerance controlla come Search gestisce gli errori ortografici.

Puoi abilitare o disabilitare la tolleranza agli errori di battitura, 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 restituiti i valori delle faccette.

maxValuesPerFacet imposta quanti valori ogni faccetta può restituire. sortFacetValuesBy controlla se i valori delle faccette sono ordinati alfabeticamente o per conteggio dei 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 a configurazioni avanzate di ricerca semantica.

Lascialo vuoto a meno che l’assistenza Clerk.io non ti abbia avvisato di configurarlo.

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

Utilizza null per mantenere il comportamento predefinito.

localizedAttributes può definire una gestione specifica per lingua in base a pattern di attributo.

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

facetSearch controlla se sia possibile cercare nei valori delle faccette.

Se abilitato, i clienti e le integrazioni possono cercare all’interno dei valori delle faccette, ad esempio per trovare un brand specifico fra tanti.

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

indexingTime abilita il matching per prefisso per una ricerca istantanea man mano che si digita. disabled disattiva il matching per prefisso.

Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.