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 den via Clerk’s API, uanset hvilken type opsætning du bruger.

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

Håndtering af Stores #

En Company kan have et vilkårligt 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 nuværende 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, vil tilpasse Setup Guides for Store, så de matcher måden, Clerk er sat op på platformen, så det er vigtigt at vælge den rigtige.

Den valuta, du vælger, bruges kun til at vise den korrekte valuta i Store’s dashboards og har ingen indflydelse på sporing.

Kopiér fra eksisterende #

Når du opretter en ny store i my.clerk.io, kan du spare meget arbejde ved at bruge den samme opsætning som din eksisterende ved simpelthen at kopiere det indhold, design og andre opsætningsaspekter, du ønsker at genbruge.

Dette er meget nyttigt, hvis du opretter en ny Store for 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

Nu skal du bare foretage mindre ændringer i Designs (f.eks. ændre valutasymboler og knaptekster).

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 for altid og kan ikke gendannes.

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

API-nøgler #

Hvis du har brug for dine Store-nøgler til noget 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.

Den Public API key bruges, når du laver grundlæggende kald til Clerk og kan deles hvor som helst, da den ikke giver adgang til følsomme data i sig selv.

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

Af hensyn til sikkerheden for Clerk, genereres Private API Key ved oprettelse af Store og sendes til ejeren af MyClerk-kontoen.

Nøglerotation #

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

Rotation gør den gamle nøgle ugyldig med det samme — enhver integration, der bruger den, stopper straks med at virke. Sørg for, at du er klar til at udskifte den overalt, hvor den bruges, før eller lige efter, du roterer.

Efter rotation skal du muligvis også 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 de standard Private API Keys. Du kan oprette så mange, du har brug for til forskellige formål, og hver kan tilbagekaldes individuelt uden at påvirke de andre.

API-status #

Dette indeholder et overblik over alle API-kald, der er foretaget i en defineret periode. Der er en række informationer:

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 samlede antal resultater, der findes af endpointet.

Results: Det samlede antal resultater, der faktisk vises for kunderne. Dette kan afvige fra hits, hvis du bruger filtre eller lavere grænser, når du viser resultater.

Avg. Response Time: Gennemsnitligt antal 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 forespørgsler, fejl og advarsler for din Store i realtid. Gå til Developers > Logs.

Se den fulde funktionalitetsoversigt her: /platform/company/developer-logs/.

Debug Dashboard #

Brug Debug til at bygge API-forespørgsler og inspicere, hvorfor et bestemt resultat sæt vises.

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

Simpel vs Avanceret #

• Simpel: Hvert API-parameter konfigureres i sit eget felt. Kun påkrævede felter vises til at begynde med, og du kan udvide Additional fields for at få adgang til valgfrie parametre.
• Avanceret: Opret en fuld GET API-forespørgsel manuelt (for eksempel ved at indsætte den fulde URL). 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 forespørgsel #

1. Vælg et Endpoint (f.eks. Search Products eller Complementary Products).
2. Udfyld de påkrævede 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 forespørgsel viser siden både resultater og diagnostics, der forklarer, hvad der har påvirket dem. Afhængigt af endpoint og konfiguration kan dette inkludere:

• Customized search rules: Forespørgselsspecifik konfiguration, der påvirkede resultaterne.
• Merchandising: Kampagner, der blev anvendt, og hvad de ændrede.
• Backfill: Produkter, der blev tilføjet til resultaterne for at udfylde grænsen.
• Metadata: Yderligere beregnede detaljer for kaldet.

Funktioner #

Stores har en række indstillinger, der bruges til at tænde og slukke for bestemte funktioner.

Tilpasningsindstillinger #

Standardfunktioner, der kan slås til og fra. Bruges primært til at identificere problemer forårsaget af ændring af Clerk’s standardadfærd. Når en funktion er deaktiveret, vil al funktionalitet inden for denne funktion stoppe med at virke.

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

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

Early Access #

Dette er funktioner, som stadig er under udvikling. De kan aktiveres manuelt, så du kan teste nye funktioner, før de frigives til alle.

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 offentlig Early Access.

Hvis nogle af nedenstående ikke er synlige for dig, skyldes det, at 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 tjekke forskellen sammenlignet med den live side.

Search 3.0 er en stor forbedring i, hvordan den forstår alle typer forespørgsler og rangerer søgeresultater.

AI Demo Shop Assistant #

Aktiverer Chat i Demo Store, så det kan testes. Fungerer kun, hvis du også har aktiveret Search 3.0. Mere info på Chat Introduction page.

Search 3.0 #

Aktiverer den nyeste version af vores Search-motor på din live-side. Search 3.0 er en stor forbedring i, hvordan den forstår alle typer forespørgsler og rangerer søgeresultater.

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

Semantic Fallback (Beta) #

En banebrydende måde at håndtere fuldfrasesøgninger 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 at køle min mad med” returnere køleskabe.

Recommendations 3.0 (Beta) #

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

Virker i øjeblikket for 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 alternativ måde at score produkter på baseret på deres ordredata i søgeresultater i ældre versioner af Search. Dette udfases, da vores nyeste version af Search (3.0) håndterer dette på en langt bedre måde.

Spell Fix (Legacy) #

En anden måde at håndtere stavefejl i ældre versioner af Search. Dette udfases, da vores nyeste version af Search (3.0) håndterer det 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 vores nyeste version af Search (3.0) klarer dette langt bedre.

Autocomplete Improvement (Legacy) #

En anden måde at autoudfylde søgninger på i ældre versioner af Search. Dette udfases, da vores nyeste version af Search (3.0) gør dette mere effektivt.

Improved Category Search (Legacy) #

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

Farveskema #

Stores arver det foretrukne farveskema fra dit operativsystem. Det understøtter både lyst og mørkt tema.