Konfiguration

Search leveres med flere indstillinger, der giver dig mulighed for at justere dens adfærd.

Når du ændrer en indstilling, udløser det en analyse af dine data, som skal afsluttes, før ændringerne træder i kraft.

Denne proces kan tage op til 15 minutter, men kan gå hurtigere afhængigt af størrelsen på dit katalog. Du kan overvåge status i Data > Configuration.

Indstillingerne kræver, at Search 3.0 er aktiveret. Derefter kan du få adgang til dem i Search > Configuration.

Attribute Search Relevance #

Denne sektion giver dig mulighed for at personalisere din søgning baseret på dine behov. Her har du to muligheder: Searchable Attribute Ranking og Non-Searchable Attributes.

Searchable Attribute Ranking #

Indstillingen Searchable attributes grouped by ranking order giver dig mulighed for at oprette grupper af attributter med forskellige niveauer af betydning for søgeresultaterne. Attributter i højererangerede grupper har større indflydelse på de viste resultater.

F.eks. hvis gruppe 1 indeholder "brand" og _category_name, mens gruppe 2 indeholder name og color, vil en søgning på “blue Nike boots” prioritere produkter med mærket “Nike” i “Boots” kategorien over produkter med disse ord i deres name attribut.

Denne prioritering hjælper med at fremhæve vigtige data såsom genrer, specifikationer eller andre nøgleværdier.

For eksempel er det ofte mere relevant at prioritere forfatteren af en bog i boghandler. En søgning på “Stephen” bør prioritere bøger af Stephen King over bøger, der blot indeholder “Stephen” i titlen.

Bemærk: Vær forsigtig, når du ændrer disse grupper. Hvis du tilføjer for mange attributter, kan Clerk.io nedprioritere produktpopularitet og kun fokusere på tekstrelevans.

Non-searchable attributes #

Denne sektion lader dig udelukke attributter fra søgeindekset, hvilket betyder, at deres tekst ikke kan søges. Dette er nyttigt for ting som interne ID’er, marginværdier eller anden data, du ønsker at bruge til visning eller filtrering, men ikke vil lade kunderne søge efter.

Som standard er attributterne price og stock på listen for at forhindre, at søgninger med tal bliver påvirket af disse attributter. Du kan tilpasse denne liste efter behov.

Du kan tilføje ikke-søgbare attributter på to måder:

• Manuelt fra listen over tilgængelige attributter.
• Ved at bruge regler, hvis du har et mønster af attributter med lignende navne.

Regler er særligt nyttige, hvis du vil udelukke flere attributter på én gang. Brug blot (*) wildcardet:

• *_url vil matche alle attributter, der slutter på _url
• child_* vil matche alle attributter, der starter med child_

Filterable attributes #

Attributter på denne liste bliver tilgængelige som filtre/facetter på tværs af Search, Omnisearch og Merchandising. Hvis en produktattribut ikke vises, når du konfigurerer facetter eller opretter en Merchandisingregel, skal du tilføje den her og vente på, at konfigurationsanalysen afsluttes.

• Tilføj attributter fra listen over tilgængelige produktattributter.
• Ændringer kan tage op til 15 minutter at træde i kraft afhængigt af katalogets størrelse.

Exact Match Behaviour #

Som standard returnerer Clerk.io alle relevante resultater for søgninger på dit site. Dog kan du i specifikke tilfælde – som ved søgning efter et SKU eller EAN-nummer – forvente kun et enkelt match.

Search v3 required: Denne funktion er kun tilgængelig for Stores, der anvender Search v3. Du kan tjekke dette i Settings > Features > Early access features.

Ved at inkludere attributter på denne liste konfigurerer du Clerk.io til kun at returnere ét resultat, når forespørgslen matcher en værdi i disse attributter. Dette deaktiverer også auto-korrektion for at sikre, at kun det nøjagtige match vises.

De mest almindelige er sku og ean, men alle synkroniserede attributter kan bruges.

Når du tilføjer en attribut, har du to muligheder:

• Returnér enkelt præcist match, bedst til unikke identifikatorer såsom SKUs eller produkt-ID’er, hvor du kun ønsker at vise et specifikt produkt.
• Returnér flere præcise matches, ideelt for attributter som kategori-ID’er, hvor mange produkter deler samme værdi.

Facet Price Buckets #

Her kan du definere det prisinterval, der skal bruges i Search-filtre. Hvis feltet er tomt, beregner Clerk.io dem dynamisk ud fra prisintervallet på dine produktdata.

I tekstfeltet kan du indtaste en kommasepareret liste over prisværdier, fx: 0,50,100,150,200,…

Custom dictionary #

Ordbogen giver dig mulighed for at definere søgetermer, der typisk ville blive behandlet som separate ord i stedet for ét enkelt begreb.

For eksempel, hvis dit katalog indeholder produkter fra sneaker-mærket D.A.T.E., bør du tilføje “D.A.T.E.” og “D. A. T. E.” til ordbogen.

Kriterier #

Clerk.io registrerer en forespørgsel som en unik identifikator, når:

• Forespørgslen er alfanumerisk og indeholder mindst ét af følgende tegn: “-+/&_.0123456789”.
• Den har mindst 4 tegn.
• Den ikke indeholder mellemrum eller anførselstegn.

Hvis Clerk.io finder et enkelt præcist match i en af de unikke identifikator-attributter, returneres det produkt straks og tilsidesætter alle tilpassede søge- eller merchandisingregler. Ellers behandles forespørgslen som en almindelig søgning.

Settings override #

Settings override giver dig mulighed for at justere avancerede Search-indeksindstillinger ved at tilføje et JSON-objekt i Search > Configuration.

Disse indstillinger styrer, hvordan Clerk.io læser, rangerer, filtrerer, sorterer og returnerer søgeresultater. De er avancerede indstillinger og bør som udgangspunkt kun ændres, hvis du ved præcist, hvilken Search-adfærd du vil justere.

Ændringer kan påvirke alle Search-resultater for Store. En lille tastefejl i JSON kan også forhindre, at override’en gemmes.

Avanceret indstilling: Brug Settings override med omtanke. Hvis du er i tvivl om, hvorvidt en override er nødvendig, bør du kontakte Clerk.io support, før du foretager ændringer.

Store-specific attributes #

Attributter såsom brand, color, size, sku, price eller brugerdefinerede kategorifelter afhænger af de data, der synkroniseres til hver Store.

Det betyder, at displayedAttributes, filterableAttributes, searchableAttributes og sortableAttributes kan se forskelligt ud fra Store til Store.

Attributter, der starter med en understregning, såsom _all_categories, _category_name eller _price_range, genereres af Clerk.io og er tilgængelige for alle Stores.

Example #

Eksemplet nedenfor viser strukturen af en Settings override. Din Store vil sandsynligvis bruge andre attributter.

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

Available settings #

displayedAttributes styrer, hvilke attributter Clerk.io kan returnere i Search-resultater.

Brug det, hvis du kun ønsker, at Search-resultater indeholder de felter, dit design, dine API-svar eller frontend-logik har brug for.

searchableAttributes styrer, hvilke attributter der søges i, når en besøgende indtaster en forespørgsel.

Rækkefølgen har betydning. Attributter tidligere i listen betragtes som vigtigere for tekst-relevans.

filterableAttributes styrer, hvilke attributter der kan bruges i filtre, facetter og regler til at indsnævre resultater.

Tilføj en attribut her, hvis den skal kunne vælges som en facet eller bruges i filterlogik. Butiksspecifikke produktattributter skal eksistere i dine synkroniserede data, før de kan anvendes.

sortableAttributes styrer, hvilke attributter Search-resultater kan sorteres efter.

Tilføj felter såsom price, created_at eller name, hvis du vil bruge dem til sortering.

rankingRules styrer rækkefølgen af relevansregler, der bruges til at rangere matchende resultater.

Regler øverst har den stærkeste indflydelse. Tilpassede regler som clerk.popularity:desc kan bruges til at fremhæve populære produkter efter de forudgående relevanstjek.

stopWords viser de ord, der skal ignoreres i søgeforespørgsler.

Det kan være nyttigt for meget almindelige ord, der ikke hjælper kunden med at finde produkter, som “the” eller “and”.

nonSeparatorTokens lister tegn, der ikke skal opdele et ord.

For eksempel kan tilføjelse af @ hjælpe Clerk.io med at opfatte et begreb, som indeholder dette tegn, som en samlet værdi.

separatorTokens lister tegn, der skal opdele ord.

Brug dette, hvis dine produktdata indeholder tegn, der tydeligt skal adskille ét udtryk fra et andet.

dictionary lister termer, der skal behandles som ét ord eller begreb.

Dette er nyttigt for mærkenavne, forkortelser eller produktspecifikke termer, der normalt opdeles i flere dele.

synonyms kortlægger én forespørgselsterm til tilsvarende ord eller udtryk.

Brug synonymer, når kunder ofte søger med forskellige ord, der betyder det samme i dit katalog.

distinctAttribute grupperer resultater efter en delt attribut og returnerer ét resultat pr. unik værdi.

Det er nyttigt, når varianter er indekseret som separate produkter, men du kun ønsker ét resultat pr. hovedprodukt eller gruppe.

proximityPrecision styrer, hvor strengt ordnærhed vurderes.

byWord sammenligner den præcise afstand mellem matchende ord. byAttribute kontrollerer, om matchende ord vises i samme attribut.

typoTolerance bestemmer, hvordan Search håndterer stavefejl.

Du kan slå stavekontrol til eller fra, indstille minimumsordlængde for én eller to fejl, og deaktivere stavekontrol for specifikke ord, attributter eller tal.

faceting styrer, hvordan facetværdier returneres.

maxValuesPerFacet bestemmer, hvor mange værdier hver facet kan returnere. sortFacetValuesBy styrer, om facetværdier sorteres alfabetisk eller efter antal resultater.

pagination styrer, hvor mange resultater Search maksimalt kan returnere for en forespørgsel.

maxTotalHits er den øvre grænse for sideopdelte resultater.

embedders er forbeholdt avancerede semantiske søgeopsætninger.

Lad det stå tomt, medmindre du er blevet rådet til opsætning af Clerk.io support.

searchCutoffMs angiver en maksimal tid, i millisekunder, som Search må bruge på en forespørgsel, før de bedste fundne resultater returneres.

Brug null for standardadfærden.

localizedAttributes kan definere sprog-specifik håndtering for matchende attributmønstre.

Lad den stå som null, medmindre din Store har en specifik flersproget indekseringsopsætning.

facetSearch bestemmer, om facetværdier kan søges.

Når det er slået til, kan kunder og integrationer søge i facetværdier, som f.eks. at finde et bestemt mærke i et langt mærkefilter.

prefixSearch styrer, om delvise ord kan matche, mens en kunde taster.

indexingTime aktiverer prefix matching for hurtigere search-as-you-type. disabled slår prefix matching fra.