Stores

Grundlæggende #

En Store er en separat enhed i Clerk.io, der indeholder alle data og indstillinger for et specifikt domæne. Dette kan være en unik webshop, platform, sprogversion eller noget andet, der skal fungere som en separat enhed.

De fungerer helt adskilt og deler ikke data med hinanden. Den eneste undtagelse er, at nogle funktioner som Merchandising og Synonyms kan tilføjes på tværs af flere Stores på én gang, når det er nødvendigt.

Hver Store har sit eget sæt af API-nøgler til at kommunikere med sig gennem Clerk’s API, uanset hvilken type opsætning du bruger.

Stores kan konfigureres til et af vores 54 understøttede sprog. Search og indeksering fungerer på alle understøttede sprog. Ingen migrering er nødvendig; ændringerne er tilgængelige med det samme. Se den fulde liste over understøttede sprog.

Administration af Stores #

En Company kan have valgfrit antal Stores tilknyttet, og de kan oprettes, kopieres og slettes efter behov.

Tilføj ny #

Nye Stores tilføjes i my.clerk.io ved at klikke på det aktuelle Store-navn i øverste venstre hjørne og derefter + Add New Store.

Udfyld detaljerne for din store og klik på Add New Store.

Den Platform, du vælger, skræddersyr Setup Guides for Store, så de matcher, hvordan Clerk er sat op på platformen, så det er vigtigt at vælge den rigtige.

Valutaen (currency) bruges kun til at afspejle den rigtige valuta i Store’s dashboards og har ingen indflydelse på tracking.

Kopiér fra eksisterende #

Når du opretter en ny store i my.clerk.io, kan du spare dig selv for meget arbejde, hvis du bruger den samme opsætning som din eksisterende ved blot at kopiere det indhold, design og andre opsætningsaspekter, du vil genbruge.

Dette er meget nyttigt, hvis du opretter en ny Store til et andet sprog eller et nyt domæne for din oprindelige Store.

Under Copy Content From Existing Store vælger du den Store, du vil duplikere, fra dropdown-menuen. Du kan vælge, hvilke specifikke elementer du vil kopiere:

• Content
• Designs
• Synonyms
• Accessories
• Audiences
• Rules
• Merchandising
• Modifiers
• Chat settings
• AI integrations

Nu skal du bare foretage mindre ændringer i Designs (såsom ændring af valutasymboler og knaptekster, for eksempel).

Den nye Store skal stadig synkroniseres med dit katalog og vil have sit eget sæt af API-nøgler.

Slet en Store #

Når du sletter en Store, bliver dens indstillinger og data fjernet permanent og kan ikke gendannes.

Du kan slette dem ved at gå til Settings > Store settings og derefter klikke Delete Store nederst på siden. Bekræft i næste prompt, og efter dette er din Store slettet.

API-nøgler #

Hvis du har brug for Store’s nøgler til et formål efter den indledende integration, kan de findes under Developers > API Keys.

Hver Store har en fast Public API key og et antal Private API keys.

Public API key bruges, når der foretages almindelige kald til Clerk og kan deles hvor som helst, da den ikke giver adgang til følsomme data i sig selv.

Kombineret med en Private API key kan du få adgang til følsomme data som e-mailadresser og foretage ændringer i data på en Store.

Af sikkerhedsmæssige årsager for Clerk genereres Private API Key ved oprettelse af store og sendes til ejeren af MyClerk-kontoen.

Key Rotation #

Hvis din Store har en Legacy Private Key, kan den roteres direkte fra Developers > API Keys ved at klikke på rotate-knappen ved siden af.

Rotation invaliderer straks den gamle nøgle — enhver integration, der bruger den, stopper straks med at virke. Sørg for at du er klar til at udskifte den overalt inden eller lige efter rotationen.

Efter rotation kan det også være nødvendigt at logge ud af Clerk.io backend og logge ind igen, da den gamle nøgle kan forblive aktiv i din nuværende session.

For en mere håndterbar opsætning bør du i stedet bruge standard Private API Keys. Du kan oprette så mange, du har brug for, og hver kan tilbagekaldes individuelt uden at påvirke de andre.

API-status #

Dette indeholder et overblik over alle API-kald foretaget i en defineret periode. Det indeholder en række informationspunkter:

API: Det API-endpoint, der kaldes. F.eks. recommendations/popular

Labels: Identifikation brugt af Clerk til at spore resultater. F.eks. Homepage / Popular

Hits: Det totale antal resultater fundet af endpointet.

Results: Det totale antal resultater, der faktisk vises til kunderne. Dette kan afvige fra hits, hvis du bruger filtre eller lavere begrænsninger ved visning af resultater.

Avg. Response Time: Gennemsnitlige millisekunder det tager for API-endpointet at svare.

Success Rate: Procentdel af API-kald der faktisk returnerede resultater.

Developer Logs #

Brug Developer Logs til at inspicere anmodninger, fejl og advarsler for din Store i realtid. Gå til Developers > Logs.

Se hele funktionsoversigten her: /platform/company/developer-logs/.

Debug Dashboard #

Brug Debug til at opbygge API-anmodninger og inspicere, hvorfor et specifikt resultat returneres.

Find det under Developers > Debug for den Store, du arbejder på.

Simpel vs Avanceret #

• Simpel: Hver API-parameter konfigureres i sit eget felt. Kun de nødvendige felter vises i starten, og du kan udvide Additional fields for at tilgå valgfrie parametre.
• Avanceret: Opret en fuld GET API-anmodning manuelt (for eksempel ved at indsætte hele URL’en). Dette er nyttigt, når du allerede har et API-kald fra kode eller fra browserens netværksfane, som du vil genskabe.

Kør en anmodning #

1. Vælg et Endpoint (for eksempel Search Products eller Complementary Products).
2. Udfyld de nødvendige felter.
3. Valgfrit: Udvid Additional fields og tilføj eventuelle ekstra parametre, du vil teste.
4. Klik på Run Request (eller Make full API call i Avanceret tilstand).

Debug Output #

Efter at have kørt en anmodning viser siden både results og diagnostics der forklarer, hvad der har påvirket dem. Afhængig af endpoint og opsætning kan dette inkludere:

• Tilpassede search-regler: Forespørgsels-specifik konfiguration der påvirkede resultaterne.
• Merchandising: Kampagner der blev anvendt og hvad de ændrede.
• Backfill: Produkter, der blev tilføjet resultaterne for at opfylde grænsen.
• Metadata: Yderligere beregnede detaljer for kaldet.

Funktioner #

Stores har en række slå-til/fra-muligheder, der kan bruges til at styre, hvilke funktioner der er aktiveret.

Tilpasningsindstillinger #

Standardfunktioner, der kan slåes til og fra. Bruges primært til at identificere problemer forårsaget af ændringer i Clerk’s standardadfærd. Når en funktion er deaktiveret, holder enhver funktionalitet indenfor den funktion op med at virke.

Nuværende funktioner, der kan slås til/fra:

• Rules
• Redirects
• Synonyms
• Merchandising
• AI Campaigns
• Fullname Categories

Early Access #

Dette er funktioner, der stadig er under aktiv udvikling. De kan aktiveres manuelt for at teste nye funktioner, før de frigives alle steder.

De fleste kan aktiveres af enhver bruger på en Store, og nogle kan kun aktiveres af Clerk-medarbejdere, hvis de stadig er i Beta, hvilket er stadiet før de bliver offentlige Early Access.

Hvis nogle af nedenstående ikke er synlige for dig, er det fordi de stadig er i Beta. Kontakt en Clerk-medarbejder, hvis du er interesseret i at teste Beta-funktioner.

Search 3.0 i Demo Store #

Den nyeste version af vores Search-motor kan aktiveres specifikt i Demo Store, for at teste forskellen ift. live-sitet.

Search 3.0 er en stor forbedring i, hvordan den forstår enhver type forespørgsel og rangerer søgeresultater.

AI Demo Shop Assistant #

Aktiverer Chat i Demo Store, så den kan testes. Virker kun, hvis du også har aktiveret Search 3.0. Mere info på Chat Introduction-siden.

Search 3.0 #

Aktiverer den nyeste version af vores Search-motor på dit live-site. Search 3.0 er en stor forbedring i, hvordan den forstår enhver type forespørgsel og rangerer søgeresultater.

Du behøver ikke geninstallere Search på dit site, da ændringen sker på API-niveau. Det vil fungere med din eksisterende opsætning.

Semantic Fallback (Beta) #

En banebrydende måde at håndtere fuldsætninger på.

Hvis der ikke kan findes et direkte match, vil Clerk analysere forespørgslen og semantisk forstå, hvad besøgende leder efter. F.eks. vil en søgning på “noget til at køle min mad med” returnere køleskabe.

Recommendations 3.0 (Beta) #

En meget hurtigere måde at vise Recommendations-resultater, baseret på samme framework som Search 3.0.

Virker aktuelt til disse logikker:

• Bestsellers (recommendations/popular)
• Bestsellers in Category (recommendations/category/popular)

Dette kræver ikke geninstallation af Recommendations, da ændringen sker på API-niveau.

Order Scoring (Legacy) #

En anden måde at score produkter på baseret på deres ordredata i søgeresultater i ældre versioner af Search. Dette udfases, da den nyeste version af Search (3.0) håndterer dette langt bedre.

Spell Fix (Legacy) #

En anden måde at håndtere stavefejl på i ældre versioner af Search. Dette udfases, da den nyeste version af Search (3.0) håndterer dette langt bedre.

SKU Search Optimization (Legacy) #

En anden måde at håndtere SKU-søgninger på i ældre versioner af Search. Dette udfases, da den nyeste version af Search (3.0) håndterer dette langt bedre.

Autocomplete Improvement (Legacy) #

En anden måde at autoudfylde søgninger på i ældre versioner af Search. Dette udfases, da den nyeste version af Search (3.0) håndterer dette langt bedre.

Improved Category Search (Legacy) #

En anden måde at søge efter kategorier i ældre versioner af Search. Dette udfases, da den nyeste version af Search (3.0) håndterer dette langt bedre.

Farveskema #

Stores arver det foretrukne farveskema fra dit operativsystem. Den understøtter både lys og mørk tilstand.