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 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 migration 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, tilpasser Setup Guides for Store til at matche, hvordan Clerk er opsat 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 dashboards for Store og har ingen indvirkning 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 ved at bruge samme opsætning som din eksisterende ved blot at kopiere det indhold, design og andre opsætningsaspekter, du vil genbruge.

Dette er meget praktisk, 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 ønsker at duplikere, i 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 blot 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 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 på Delete Store nederst på siden. Bekræft i næste prompt, og derefter er din Store slettet.

API-nøgler #

Hvis du har brug for dine Store-nøgler til ethvert formål efter den første 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 til at lave basale kald til Clerk og kan deles hvor som helst, da den ikke giver adgang til følsomme data.

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

Af sikkerhedshensyn 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 ugyldiggør straks den gamle nøgle – enhver integration, der bruger den, vil stoppe med at virke øjeblikkeligt. Sørg for at du er klar til at udskifte den alle steder, hvor den bruges, før eller straks efter rotationen.

Efter rotationen skal du måske også logge ud af Clerk.io backend og logge ind igen, da den gamle nøgle kan være aktiv i din nuværende session.

For en mere overskuelig opsætning skal 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-statistik #

Åbn Developers > API Stats for et overblik over API-kald i den valgte periode.

Kald uden resultater er ikke nødvendigvis HTTP-fejl. For eksempel kan et gyldigt søgeforespørgsel returnere ingen matchende produkter.

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 featureoversigt her: /platform/company/developer-logs/.

API Debug #

Brug API Debug til at opbygge API-forespørgsler og inspicere resultaterne. Åbn Developers > API Debug for den store, du arbejder på. Parametre er arrangeret i form-grupper.

Simpel vs Avanceret #

• Simpel: Hver API-parameter konfigureres i sit eget felt. Kun de krævede felter vises i starten, og du kan udvide Additional fields for at få adgang til valgfrie parametre.
• Avanceret: Opret en fuld GET API-forespørgsel manuelt (f.eks. ved at indsætte den fulde URL). Dette er nyttigt, hvis du allerede har et API-kald fra kode eller browserens netværksfane, som du vil gengive.

Kør en forespørgsel #

1. Vælg et Endpoint (fx Search Products eller Complementary Products).
2. Udfyld de krævede felter.
3. Valgfrit: Udvid Additional fields og tilføj eventuelle ekstra parametre, du ønsker at teste.
4. Klik Run Request (eller Make full API call i Avanceret tilstand).

Debug Output #

Efter at have kørt en forespørgsel viser siden både results og diagnostics, der forklarer hvad, der påvirkede dem. Afhængigt af endpoint og konfiguration kan dette inkludere:

• Customized search rules: Forespørgsels-specifik konfiguration, der har påvirket resultaterne.
• Merchandising: Kampagner, der blev anvendt, og hvad de ændrede.
• Backfill: Produkter, der blev tilføjet til resultaterne for at opfylde grænsen.
• Metadata: Yderligere beregnede oplysninger for kaldet.

Features #

Stores har et antal knapper, der kan bruges til at styre, hvilke funktioner der er aktiveret på den.

Tilpasningsindstillinger #

Standardfunktioner, der kan slås til og fra. Anvendes primært til at identificere problemer, der skyldes modifikation af Clerks standardadfærd. Når en funktion er deaktiveret, vil al funktionalitet inden for den funktion ophøre 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, der stadig er under udvikling. De kan aktiveres manuelt for at tillade test af nye funktioner, før de udgives offentligt.

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 live-siden.

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 Introduktion-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 virker med din eksisterende opsætning.

Semantic Fallback (Beta) #

En banebrydende måde at håndtere hele sætningssøgninger på.

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

Recommendations 3.0 (Beta) #

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

Virker aktuelt for følgende 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 vores nyeste version af Search (3.0) håndterer dette meget bedre.

Spell Fix (Legacy) #

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

Autocomplete Improvement (Legacy) #

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

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 meget bedre.

Farveskema #

Stores vil arve det foretrukne farveskema fra dit operativsystem. Det understøtter både lys og mørk tilstand.