Konfiguration

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

Når du ændrer en indstilling, udløser det en analyse af dine data, som skal fuldføres, 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 #

Dette afsnit giver dig mulighed for at personalisere din søgning efter 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øjest rangerede 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 efter “blue Nike boots” prioritere produkter med brandet “Nike” i “Boots”-kategorien over produkter med disse ord i attributten name.

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

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

Bemærk: Vær forsigtig ved ændring af disse grupper. Hvis du tilføjer for mange attributter, kan Clerk.io nedprioritere produktpopularitet og i stedet kun fokusere på tekstmatch.

Non-searchable attributes #

Dette afsnit giver dig mulighed for at udelukke attributter fra søgeindekset, hvilket betyder, at deres tekst ikke er søgbar. Det er nyttigt til ting som interne ID’er, marginværdier eller data, du vil bruge til visning eller filtrering, men ikke ønsker, at kunderne skal kunne søge i.

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

Du kan tilføje non-searchable attributes på to måder:

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

Regler er især nyttige, hvis du ønsker at udelukke flere attributter på én gang. Brug blot (*) wildcard:

• *_url matcher alle attributter, der ender med _url
• child_* matcher alle attributter, der starter med child_

Filterable attributes #

Attributter på denne liste bliver tilgængelige som filtre/facetter i Search, Omnisearch og Merchandising. Hvis en produktattribut ikke vises, når du konfigurerer facetter eller opretter en Merchandising regel, skal du tilføje den her og vente på, at konfigurationsanalysen er gennemført.

• 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 ved søgninger på dit site. Dog i specifikke tilfælde — som søgning efter SKU- eller EAN-nummer — kan du forvente kun ét match.

Search v3 påkrævet: Denne funktion er kun tilgængelig for Stores, der bruger Search v3. Du kan kontrollere dette i Settings > Features > Early access features.

Ved at inkludere attributter på denne liste, konfigurerer du Clerk.io til at returnere ét enkelt resultat, når forespørgslen matcher en værdi i disse attributter. Dette deaktiverer også autokorrektion, så kun det eksakte 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 eksakt match, bedst brugt til unikke identifikatorer som SKU’er eller produkt-ID’er, hvor du ønsker at returnere et specifikt produkt.
• Returnér flere eksakte match, ideelt til attributter som kategori-ID’er, hvor mange produkter deler den samme værdi.

Facet Price Buckets #

Her kan du definere den prisklasse, der skal bruges i Search-filtrene. Hvis dette felt stå tomt, beregner Clerk.io dem dynamisk baseret på din produktdatas prisspænd.

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

Custom dictionary #

Custom dictionary gør det muligt at definere søgetermer, der typisk ville blive behandlet som separate ord i stedet for et enkelt begreb.

Hvis dit katalog f.eks. inkluderer produkter fra sneakerbrandet D.A.T.E., kan du vælge at tilføje “D.A.T.E.” og “D. A. T. E.” til custom dictionary.

Criteria #

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

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

Hvis Clerk.io finder et enkelt eksakt match i nogen af de unikke identifikator-attributter, returneres produktet straks, og tilsidesætter eventuelle brugerdefinerede søge- eller merchandising-regler. 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. Det er avancerede indstillinger, som normalt kun bør ændres, hvis du præcis ved, hvilken Search-adfærd du ønsker at tilpasse.

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

Avanceret indstilling: Brug Settings override med forsigtighed. Er du usikker på behovet for en override, så kontakt Clerk.io support, før du ændrer den.

Store-specific attributes #

Attributter som brand, color, size, sku, price eller brugerdefinerede kategorifelter afhænger af de data, der er synkroniseret til den enkelte Store.

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

Attributter, der starter med en underscore, 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 for 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, når du ønsker, at Search-resultater kun skal indeholde de felter, der er nødvendige til dit design, API-respons eller frontend-logik.

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

Rækkefølgen har betydning – attributter tidligere på listen anses for mere vigtige for tekstmatch.

filterableAttributes styrer, hvilke attributter der kan bruges til filtre, facetter og regler, som indsnævrer resultaterne.

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

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

Tilføj felter 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 størst indflydelse. Specialregler som clerk.popularity:desc kan bruges til at fremhæve populære produkter efter de foregående relevanstjek.

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

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

nonSeparatorTokens angiver tegn, der ikke skal adskille ord.

F.eks. kan tilføjelse af @ hjælpe Clerk.io med at opfatte et udtryk med dette tegn som én samlet værdi.

separatorTokens angiver tegn, der skal opdele ord.

Brug dette, hvis dine produktdata indeholder tegn, der bør adskille ét udtryk fra et andet.

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

Det er nyttigt til brandnavne, forkortelser eller produktbetegnelser, der normalt opdeles i flere dele.

synonyms tilknytter ét søgeord til tilsvarende ord eller udtryk.

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

distinctAttribute grupperer resultater efter en fælles attribut og returnerer ét resultat per unik værdi.

Dette er nyttigt, når varianter indekseres som separate produkter, men du kun ønsker ét resultat per hovedprodukt eller gruppe.

proximityPrecision styrer, hvor strengt ordnærhed vurderes.

byWord sammenligner den nøjagtige afstand mellem matchende ord. byAttribute tjekker, om matchende ord optræder i samme attribut.

typoTolerance styrer, hvordan Search håndterer stavefejl.

Du kan aktivere eller deaktivere tolerance for stavefejl, sætte minimumslængde for ét eller to stavefejl og deaktivere stavefejls-tolerance for specifikke ord, attributter eller tal.

faceting styrer, hvordan facet-værdier returneres.

maxValuesPerFacet fastsætter, hvor mange værdier hver facet kan returnere. sortFacetValuesBy kontrollerer, om facet-værdier sorteres alfabetisk eller efter antal resultater.

pagination styrer det maksimale antal resultater, Search kan returnere for en forespørgsel.

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

embedders er forbeholdt avancerede semantiske søgeopsætninger.

Lad feltet stå tomt, medmindre Clerk.io support har bedt dig konfigurere det.

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

Brug null for at bevare standardadfærd.

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

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

facetSearch styrer, om facetværdier kan søges i.

Når det er aktiveret, kan brugere og integrationer søge efter værdier inden for facetter som fx at finde et bestemt brand i et langt brandfilter.

prefixSearch styrer, om delvise ord kan matches, mens brugeren skriver.

indexingTime aktiverer prefixmatching for hurtigere “search-as-you-type”-adfærd. disabled slår prefixmatching fra.