Visitatori

Panoramica #

Il Registro dei visitatori ti permette di cercare tutto ciò che Clerk ha registrato per un visitatore ed è utile per il debug delle ricerche, delle Recommendations e delle visualizzazioni di pagina. Ogni voce mostra cosa è stato richiamato, quali input sono stati utilizzati, cosa ha restituito l’API e il contesto utilizzato per prendere la decisione.

Dove trovarlo #

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

Ottieni un ID visitatore #

Usa l’endpoint dell’ID visitatore per recuperare l’ID per il browser che vuoi ispezionare:

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

L’ID visitatore riflette una sessione anonima come descritto in Data > Cookieless. Se cambi dispositivo, browser o rete, l’ID visitatore potrebbe essere diverso.

Cosa mostra il log #

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

• API: L’endpoint invocato (per esempio search/omni).
• Etichette: Qualsiasi etichetta allegata alla chiamata (per esempio la superficie UI come “Omnisearch”).
• Input: Parametri inviati all’endpoint. Esempi includono la query di ricerca, un ID prodotto su cui si basano le Recommendations, o un identificatore di categoria/pagina.
• Output: ID restituiti dagli endpoint che producono risultati (per esempio le Recommendations come Popular, Category, o Alternatives).
• Metadati: Contesto usato per la chiamata come lingua, URL, filtri, ID dei template, elementi pinati/esclusi e impostazioni dei sinonimi.
• Tempo: Quando si è verificato l’evento, dal più recente al più vecchio.

Usi tipici #

• Debug di Search: ispeziona le recenti chiamate search/omni per vedere la query, i filtri e la lingua utilizzata, e se sono stati restituiti i risultati.
• Verifica Recommendations: conferma quale input (prodotto/categoria/pagina) ha prodotto quali ID di risultato, e rivedi eventuali filtri o pin.
• Valida le visualizzazioni di pagina: controlla i metadati relativi a pagina o template per assicurarsi che venga inviato il contesto corretto.

Suggerimenti #

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