Visitantes

Descripció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é fue llamado, 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 #

Usa el endpoint 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 retornados por endpoints que producen resultados (por ejemplo, Recommendations como Popular, Category o Alternatives). Las llamadas que no devuelven una lista de resultados tendrán esto vacío.
• Metadata: Contexto utilizado para la llamada, como idioma, URL, filtros, IDs de plantilla, artículos fijados/excluidos y configuración de sinónimos.
• Time: Cuándo ocurrió el evento, primero el más reciente.

Usos típicos #

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

Consejos #

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