Visitatori

Panoramica #

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

Dove trovarlo #

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

Come 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 oppure chiama il Visitor ID endpoint. Restituisce un ID di 8 caratteri come SBWLDWSi.
• Incolla quell’ID in 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 log #

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. Esempi includono la query di ricerca, un product ID su cui si basano le recommendations, o un identificatore di categoria/pagina.
• Output: 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 usato per la chiamata come lingua, URL, filtri, ID di template, elementi fissati/esclusi e impostazioni di sinonimi.
• Time: Quando è avvenuto l’evento, da più recente a meno recente.

Usi tipici #

• Debug Search: Esamina le chiamate recenti a search/omni per vedere la query, i filtri e la lingua utilizzati, e se sono stati restituiti risultati.
• Verify Recommendations: Conferma quale input (product/category/page) ha prodotto quali ID di risultato e controlla eventuali filtri o pin.
• Validate Page Views: Verifica 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 possono spiegare perché non c’è corrispondenza.
• Usa l’esatto Visitor ID del browser/sessione in cui hai osservato il comportamento; sessioni diverse mostreranno log diversi.
• Assicurati che Clerk.js sia installato sulla pagina che stai testando—nessuna chiamata significa che nulla apparirà nel log.