Besøgende

Oversigt #

Visitor Log giver dig mulighed for at slå alt op, som Clerk har registreret for én besøgende, og er nyttig til fejlfinding af søgninger, anbefalinger og sidevisninger. Hver post viser, hvad der blev kaldt, hvilke input der blev brugt, hvad API’en returnerede, og den kontekst, der blev brugt til at træffe beslutningen.

Hvor finder jeg den #

• Gå til Data > Visitors i my.clerk.io.
• Indsæt et Visitor ID og vælg Search Visitor.

Hent et Visitor ID #

Brug Visitor ID endpointet til at hente ID’et for den browser, du ønsker at inspicere:

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

Visitor ID afspejler en anonym session, som beskrevet i Data > Cookieless. Hvis du skifter enhed, browser eller netværk, kan Visitor ID være forskelligt.

Hvad loggen viser #

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

• API: Det endpoint, der blev kaldt (for eksempel search/omni).
• Labels: Eventuelle labels tilknyttet kaldet (for eksempel UI-fladen som “Omnisearch”).
• Input: Parametre sendt til endpointet. Eksempler omfatter søgeforespørgslen, et produkt-ID som anbefalingerne er baseret på, eller et kategori-/side-ID.
• Output: ID’er returneret af endpoints, der leverer resultater (for eksempel Recommendations som Popular, Category eller Alternatives). Kald, der ikke returnerer en resultatliste, vil have dette tomt.
• Metadata: Kontekst brugt til kaldet som sprog, URL, filtre, template-ID’er, fastgjorte/udelukkede varer og synonymindstillinger.
• Time: Hvornår hændelsen fandt sted, nyeste først.

Typiske anvendelser #

• Debug Search: Inspicer nylige search/omni kald for at se forespørgslen, filtre og sprog 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 pins.
• Validate Page Views: Tjek side- eller template-relateret metadata for at sikre, at den rette kontekst sendes.

Tips #

• Hvis Output er tom, kig i Metadata efter filtre, sprog eller andre indstillinger, der kan forklare, hvorfor intet matchede.
• Brug det nøjagtige Visitor ID fra den browser/session, hvor du observerede adfærden; forskellige sessioner vil vise forskellige logs.
• Sørg for at Clerk.js er installeret på den side, du tester—ingen kald betyder, at intet vil dukke op i loggen.