Visitatori

Panoramica #

Il Registro dei Visitatori consente di cercare tutto ciò che Clerk ha registrato per un visitatore ed è utile per il debug di ricerche, recommendations e visualizzazioni di pagina. Ogni voce mostra cosa è stato chiamato, quali input sono stati utilizzati, cosa ha restituito l’API e il contesto usato per prendere la decisione.

Dove trovarlo #

• Vai su Data > Visitors in my.clerk.io.
• Incolla un Visitor ID e scegli Search Visitor.

Ottenere un Visitor ID #

Usa l’endpoint Visitor ID per recuperare l’ID del browser che vuoi ispezionare:

• Apri il negozio nello stesso browser in cui Clerk è attivo.
• Visita https://api.clerk.io/v3/misc/visitor_id o chiama l’ endpoint Visitor ID. Restituisce un ID di 8 caratteri come SBWLDWSi.
• Incolla quell’ID su Data > Visitors.

Il Visitor ID riflette una sessione anonima come descritto in Data > Cookieless. Se cambi dispositivo, browser o rete, il Visitor ID potrebbe essere diverso.

Cosa mostra il registro #

Per ogni azione registrata, vedrai una riga con queste colonne:

• API: L’endpoint che è stato chiamato (ad esempio search/omni).
• Labels: Eventuali etichette associate alla chiamata (ad esempio la superficie UI come “Omnisearch”).
• Input: Parametri inviati all’endpoint. Gli esempi includono la query di ricerca, un product ID su cui si basano le recommendations, o un identificativo di categoria/pagina.
• Output: Gli ID restituiti dagli endpoint che producono risultati (ad esempio Recommendations come Popular, Category o Alternatives). Le chiamate che non restituiscono una lista di risultati avranno questo campo vuoto.
• Metadata: Contesto utilizzato per la chiamata come lingua, URL, filtri, template IDs, elementi fissati/esclusi e impostazioni dei sinonimi.
• Time: Quando si è verificato l’evento, più recente per primo.

Usi tipici #

• Debug Search: Ispeziona le chiamate recenti a search/omni per vedere query, filtri e lingua usati e verificare se sono stati restituiti risultati.
• Verify Recommendations: Conferma quale input (product/category/page) ha prodotto quali result ID e rivedi eventuali filtri o elementi fissati.
• Validate Page Views: Controlla i metadata relativi a pagina o template per assicurarti che venga inviato il contesto corretto.

Suggerimenti #

• Se Output è vuoto, guarda in Metadata per filtri, lingua, o altre impostazioni che potrebbero spiegare perché nessun risultato corrisponde.
• Usa l’esatto Visitor ID dal browser/sessione in cui hai osservato il comportamento; sessioni diverse mostreranno registri diversi.
• Assicurati che Clerk.js sia installato sulla pagina che stai testando: nessuna chiamata significa che nulla apparirà nel registro.