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 searches, recommendations og sidevisninger. Hver post viser, hvad der blev kaldt, hvilke input der blev brugt, hvad API’en returnerede, og hvilken kontekst der blev brugt til at træffe beslutningen.

Hvor finder du det #

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

Sådan får du et Visitor ID #

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

• Åbn butikken i samme browser, hvor Clerk er aktiv.
• Besøg https://api.clerk.io/v3/misc/visitor_id eller kald Visitor ID endpoint. Det returnerer et 8-tegns ID såsom SBWLDWSi.
• Indsæt dette 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 anderledes.

Hvad loggen viser #

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

• API: Endpointet der blev kaldt (for eksempel search/omni).
• Labels: Eventuelle labels tilknyttet kaldet (for eksempel UI-overfladen som “Omnisearch”).
• Input: Parametre sendt til endpointet. Eksempler inkluderer søgeforespørgslen, et produkt-ID som recommendations er baseret på, eller et kategori-/side-id.
• Output: ID’er returneret af endpoints, der giver resultater (for eksempel Recommendations som Popular, Category eller Alternatives). Kald uden resultatliste har dette felt tomt.
• Metadata: Kontekst brugt til kaldet såsom sprog, URL, filtre, template ID’er, pinned/udelukkede varer og synonym-indstillinger.
• Time: Hvornår hændelsen skete, nyeste først.

Typiske anvendelser #

• Debug Search: Inspicer nylige search/omni-kald for at se forespørgsel, filtre og sprog brugt, samt om der blev returneret resultater.
• Verify Recommendations: Bekræft hvilket input (produkt/kategori/side) der gav hvilke resultat-ID’er, og gennemgå eventuelle filtre eller pins.
• Validate Page Views: Tjek metadata relateret til side eller template for at sikre, at den korrekte kontekst sendes.

Tips #

• Hvis Output er tom, så 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 viser forskellige logs.
• Sørg for at Clerk.js er installeret på siden, du tester—ingen kald betyder intet vises i loggen.