Besøgende

Oversigt #

Besøgsloggen gør dig i stand til at slå alt op, som Clerk har registreret for én besøgende, og den er nyttig til fejlfinding af søgninger, anbefalinger og sidevisninger. Hver post viser, hvad der blev kaldt, hvilke input der blev anvendt, hvad API’en returnerede, og konteksten, der blev brugt til at træffe beslutningen.

Hvor man finder den #

• Gå til Data > Visitors i my.clerk.io.
• Indsæt en Besøgs-ID og vælg Search Visitor.

Få et Besøgs-ID #

Brug Visitor ID-endpointet til at hente ID’en til den browser, du vil inspicere:

• Åbn butikken i den samme browser, hvor Clerk er aktiv.
• Besøg https://api.clerk.io/v3/misc/visitor_id eller kald Besøgs-ID-endpoint. Det returnerer en 8-tegns ID såsom SBWLDWSi.
• Indsæt den ID i Data > Visitors.

Besøgs-ID’en afspejler en anonym session som beskrevet i Data > Cookieless. Hvis du ændrer enhed, browser eller netværk, kan Besøgs-ID’en være forskellig.

Hvad loggen viser #

For hver registreret handling vil du se en række med disse kolonner:

• API: Endepunktet der blev kaldt (for eksempel search/omni).
• Labels: Eventuelle labels tilknyttet kaldet (for eksempel UI-overfladen som “Omnisearch”).
• Input: Parametre sendt til endepunktet. Eksempler inkluderer søgeforespørgslen, et produkt-ID som Recommendations er baseret på, eller en kategori/side-identifikator.
• Output: ID’er returneret af endepunkter, der producerer resultater (for eksempel Recommendations som Popular, Category eller Alternatives). Kald, der ikke returnerer en resultatliste, vil have dette felt tomt.
• Metadata: Kontekst brugt til opkaldet såsom sprog, URL, filtre, skabelon-ID’er, fastgjorte/udelukkede elementer, og synonymindstillinger.
• Time: Hvornår begivenheden fandt sted, nyeste først.

Typiske anvendelser #

• Debug Search: Undersøg nylige search/omni-kald for at se forespørgslen, filtre og sprog, der blev brugt, og om der blev returneret resultater.
• Verify Recommendations: Bekræft hvilket input (produkt/kategori/side) der producerede hvilke resultat-ID’er, og gennemgå eventuelle filtre eller fastgørelser.
• Valider Page Views: Tjek side- eller skabelon-relateret metadata for at sikre, at den rette kontekst bliver sendt.

Tips #

• Hvis Output er tomt, kig i Metadata efter filtre, sprog eller andre indstillinger, der kan forklare, hvorfor intet matchede.
• Brug den nøjagtige Besøgs-ID fra browseren/sessionen, hvor du observerede adfærden; forskellige sessioner vil vise forskellige logfiler.
• Sørg for, at Clerk.js er installeret på den side, du tester—ingen kald betyder, at intet vil fremgå af loggen.