Konfiguration

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

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

Denne proces kan tage op til 15 minutter, men kan være 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.

Søgbare attributter #

Vælg hvilke produktattributter, kunder kan søge på, og hvor meget hver attribut påvirker matchning.

Find en attribut i Searchable attributes og vælg dens Search relevance:

For eksempel, sæt brand og _category_name til High, når disse er vigtige for dit katalog. Brug lavere relevans for understøttende tekst. Undgå at gøre alle attributter til High, så produktpopularitet stadig kan hjælpe med at rangere resultater.

Brug Not searchable for felter som interne ID’er eller marginværdier, som du har brug for til visning eller filtrering, men som du ikke ønsker, at kunderne skal kunne søge i.

Jokertegnsregler #

Jokertegnsregler kan holde grupper af attributter ude af søgningen. Vælg Create a rule for et mønster som *url eller child*. Rækker markeret Rule viser disse mønstre. Brug Edit på en regel for at ændre den.

For mere specifikke mønstre matcher *_url attributter, der ender på _url, og child_* matcher attributter, der starter med child_.

Sorterbare attributter #

Tilføj de produktattributter, du vil gøre tilgængelige for sortering af resultater. Dette afsnit følger Searchable attributes.

Filtrerbare attributter #

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 bliver færdig.

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

Exact Match Behaviour #

Som standard returnerer Clerk.io alle relevante resultater for søgninger på dit site. Men i specifikke tilfælde — som når der søges efter et SKU- eller EAN-nummer — forventes kun et enkelt match.

Search v3 påkrævet: Denne funktion er kun tilgængelig for Stores, der bruger Search v3. Du kan tjekke 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 søgeordet matcher en værdi i disse attributter. Dette deaktiverer også autokorrektion for kun at vise det nøjagtige match.

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 nøjagtigt match. Bedst til unikke identifikatorer som SKU’er eller produkt-ID’er, hvor du vil returnere et specifikt produkt.
• Returnér flere nøjagtige match. Ideelt til attributter som kategori-ID’er, hvor mange produkter deler samme værdi.

Facet Price Buckets #

Her kan du definere det prisspænd, som bruges i Search-filtrene. Hvis det lades være tomt, beregner Clerk.io dem dynamisk baseret på prisspændet i dine produktdata.

Indtast kommaseparerede priser i Add buckets, for eksempel 0,50,100,150,200. Lad feltet være tomt for at beregne intervaller dynamisk fra produktdata.

Brugerdefineret ordbog #

Den brugerdefinerede ordbog gør det muligt at definere søgetermer, som ellers ville blive behandlet som separate ord i stedet for som ét begreb.

Indtast en term i Add term og klik på Add. Du kan indtaste flere termer adskilt med komma.

For eksempel, hvis dit katalog indeholder produkter fra sneakerbrandet D.A.T.E., kan du tilføje “D.A.T.E.” og “D. A. T. E.” til den brugerdefinerede ordbog.

Kriterier #

Clerk.io registrerer en søgning som en unik identifikator, når:

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

Hvis Clerk.io finder et enkelt nøjagtigt match i nogen af de unikke identifikator-attributter, returneres det produkt straks. Dette tilsidesætter alle tilpassede søge- eller merchandising-regler. Ellers behandles søgningen 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 og bør kun ændres, hvis du ved præcist, hvilken Search-adfærd du vil tilpasse.

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

Avanceret indstilling: Brug Settings override med forsigtighed. Hvis du er usikker på, om der er behov for override, så kontakt Clerk.io support, før du ændrer det.

Store-specifikke attributter #

Attributter 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 forskellige ud fra Store til Store.

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

Eksempel #

Eksemplet nedenfor viser strukturen for et 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"
}

Tilgængelige indstillinger #

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

Brug det, hvis du kun vil have relevante felter med i Search-resultater, som dit design, dine API-svar eller frontend-logik kræver.

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

Rækkefølgen betyder noget. Attributter tidligere i listen anses for at være vigtigere for tekstrelevans.

filterableAttributes styrer, hvilke attributter der kan bruges til filtre, facetter og regler, som begrænser resultater.

Tilføj en attribut her, hvis den skal kunne vælges som facet eller bruges i filtreringslogik. Store-specifikke produktattributter skal findes i dine 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ærkest indflydelse. Tilpassede regler som clerk.popularity:desc kan bruges til at fremhæve populære produkter efter de forudgående relevanskontroller.

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

Dette er nyttigt for meget almindelige ord, som ikke hjælper kunder med at finde produkter, f.eks. “the” eller “and”.

nonSeparatorTokens angiver tegn, der ikke skal opdele et ord.

For eksempel, hvis du tilføjer @, kan Clerk.io behandle en term, der indeholder dette tegn, som én samlet værdi.

separatorTokens angiver tegn, der skal opdele ord.

Brug dette, hvis dine produktdata indeholder tegn, der tydeligt skal adskille én term fra en anden.

dictionary angiver termer, der bør behandles som ét ord eller begreb.

Dette er nyttigt for brandnavne, forkortelser eller produkttermer, der normalt splittes i flere dele.

synonyms knytter én søgeterm til ækvivalente ord eller sætninger.

Brug synonymer, når besøgende ofte søger efter 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 er indekseret som separate produkter, men du kun ønsker ét resultat per forældreprodukt eller gruppe.

proximityPrecision styrer, hvor strengt ordnærhed vurderes.

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

typoTolerance styrer, hvordan Search håndterer stavefejl.

Du kan aktivere eller deaktivere stavefejltolerance, sætte minimumsordlængde for én eller to stavefejl og deaktivere stavefejltolerance for bestemte ord, attributter eller tal.

faceting styrer, hvordan facetværdier returneres.

maxValuesPerFacet fastsætter, 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 kan returnere for en søgning.

maxTotalHits er øvre grænse for paginerede resultater.

embedders er reserveret til avanceret semantisk søgeopsætning.

Lad det være tomt, medmindre Clerk.io support har bedt dig konfigurere det.

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

Brug null for at bevare standardadfærden.

localizedAttributes kan definere sprog-specifik bekæmpelse for matchende attributmønstre.

Lad den være null, medmindre din Store har en særlig opsætning til flersproget indeksering.

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

Når det er aktiveret, kan kunder og integrationer søge blandt facetværdier, f.eks. finde et bestemt brand i et langt brandfilter.

prefixSearch styrer, om delvise ord kan matches, mens en besøgende indtaster tekst.

indexingTime aktiverer prefix matching for hurtigere søgning mens du skriver. disabled slår prefix matching fra.