Visitantes

Visión general #

El Registro de Visitantes te permite consultar todo lo que Clerk registró para un visitante y es útil para depurar búsquedas, recomendaciones y vistas de página. Cada entrada muestra qué se llamó, qué entradas se usaron, qué devolvió la API y el contexto utilizado para tomar la decisión.

Dónde encontrarlo #

• Ve a Data > Visitors en my.clerk.io.
• Pega un Visitor ID y elige Search Visitor.

Obtener un Visitor ID #

Utiliza el endpoint de Visitor ID para recuperar el ID del navegador que deseas inspeccionar:

• Abre la tienda en el mismo navegador donde Clerk está activo.
• Visita https://api.clerk.io/v3/misc/visitor_id o llama al Visitor ID endpoint. Devuelve un ID de 8 caracteres como SBWLDWSi.
• Pega ese ID en Data > Visitors.

El Visitor ID refleja una sesión anónima como se describe en Data > Cookieless. Si cambias de dispositivo, navegador o red, el Visitor ID puede ser diferente.

Qué muestra el registro #

Para cada acción registrada, verás una fila con estas columnas:

• API: El endpoint que fue llamado (por ejemplo search/omni).
• Labels: Cualquier etiqueta adjunta a la llamada (por ejemplo, la superficie de la interfaz como “Omnisearch”).
• Input: Parámetros enviados al endpoint. Ejemplos incluyen la consulta de búsqueda, un product ID en el que se basan las recomendaciones, o un identificador de categoría/página.
• Output: IDs devueltos por endpoints que generan resultados (por ejemplo Recommendations como Popular, Category o Alternatives). Las llamadas que no devuelvan una lista de resultados tendrán esto vacío.
• Metadata: Contexto usado para la llamada como el idioma, URL, filtros, template IDs, elementos fijados/excluidos y configuraciones de sinónimos.
• Time: Cuándo sucedió el evento, el más reciente primero.

Usos típicos #

• Depurar Search: Inspecciona las llamadas recientes a search/omni para ver la consulta, los filtros y el idioma utilizados, y si se devolvieron resultados.
• Verificar Recommendations: Confirma qué entrada (producto/categoría/página) produjo qué result IDs, y revisa cualquier filtro o elemento fijado.
• Validar vistas de página: Revisa los metadatos relacionados con la página o plantilla para asegurarte de que se envía el contexto correcto.

Consejos #

• Si Output está vacío, revisa en Metadata los filtros, idioma u otras configuraciones que puedan explicar por qué no hubo coincidencias.
• Usa exactamente el mismo Visitor ID de la sesión/navegador donde observaste el comportamiento; diferentes sesiones mostrarán diferentes registros.
• Asegúrate de que Clerk.js esté instalado en la página que estás probando; sin llamadas, no aparecerá nada en el registro.