Stores

Grundlæggende #

En Store er en separat enhed i Clerk.io, som 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 selvstændig enhed.

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

Hver Store har sit eget sæt af API-nøgler for at kommunikere med den gennem 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.

Administration 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 Store’s Setup Guides til at matche, hvordan Clerk er opsat på platformen, så det er vigtigt at vælge den rigtige.

Valutaen bruges kun til at vise 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 samme opsætning som din eksisterende ved blot at kopiere de indhold, designs og andre opsætningsaspekter, du ønsker at genbruge.

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

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

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

Nu behøver du kun at lave mindre ændringer i Designs (f.eks. ændre valutasymboler og knaptekster).

Den nye Store skal stadig synkroniseres med dit katalog og får sit eget sæt API-nøgler.

Slet en Store #

Når du sletter en Store, vil dens indstillinger og data blive fjernet for altid og kan ikke gendannes.

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

API-nøgler #

Hvis du har brug for din Store’s nøgler til et 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 ved basale kald til Clerk og kan deles hvor som helst, da den ikke giver adgang til følsomme data alene.

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

For sikkerhed for Clerk vil Private API Key blive genereret ved oprettelse af Store og sendt 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 den.

Rotationen ugyldiggør straks den gamle nøgle — enhver integration, der bruger den, stopper med at virke med det samme. Sørg for, at du er klar til at erstatte den alle steder, den bruges, før eller umiddelbart efter rotation.

Efter rotationen skal du muligvis 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 anbefales det at bruge de almindelige 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 øvrige.

API-status #

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

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

Label: Identifikation, der bruges af Clerk til at spore resultater. F.eks. Homepage / Popular

Hits: Det samlede antal resultater, der blev fundet 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 ved visning af resultater.

Avg. Response Time: Gennemsnitligt antal millisekunder, det tager API-endpointet at svare.

Success Rate: Procentdel af API-kald, som 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 det fulde featureoverblik her: /platform/company/developer-logs/.

Debug Dashboard #

Brug Debug til at bygge API-anmodninger og undersøge, hvorfor et specifikt resultatsæt returneres.

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

Simple vs Advanced #

• Simple: Hver API-parameter konfigureres i sit eget felt. Kun de påkrævede felter vises til at begynde med, og du kan udvide Additional fields for at få adgang til valgfrie parametre.
• Advanced: Opret manuelt et fuldt GET API-kald (f.eks. ved at indsætte hele URL’en). Dette er nyttigt, når du allerede har et API-kald fra kode eller fra browserens netværkstab, som du vil gengive.

Kør en anmodning #

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

Debug Output #

Efter at have kørt en anmodning 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 resultater for at udfylde grænsen.
• Metadata: Yderligere beregnede detaljer for kaldet.

Funktioner #

Stores har en række indstillinger, der kan bruges til at styre, hvilke funktioner der er aktiveret på den.

Tilpasningsindstillinger #

Standardfunktioner, der kan slås til og fra. Primært brugt til at identificere problemer forårsaget af ændringer 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, der stadig aktivt udvikles. De kan aktiveres manuelt for at muliggøre testning af nye funktioner, før de frigives overalt.

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, 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 i Demo Store specifikt for at tjekke forskellen det gør sammenlignet med livesitet.

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

AI Demo Shop Assistant #

Aktiverer Chat i Demo Store, så det 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 måden, den forstår alle typer forespørgsler og rangerer søgeresultater.

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

Semantic Fallback (Beta) #

En banebrydende måde at håndtere søgninger med hele sætninger.

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 på, baseret på samme framework som bruges i Search 3.0.

Fungerer i øjeblikket for disse logikker:

• Bestsellers (recommendations/popular)
• Bestsellers i kategori (recommendations/category/popular)

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

Order Scoring (Legacy) #

En anden måde at vurdere produkter ud fra 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 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 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 autofuldføre 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 på i ældre versioner af Search. Dette udfases, da den nyeste version af Search (3.0) håndterer dette langt bedre.

Farveskema #

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