Visitantes

Visión general #

El Registro de Visitantes le permite buscar 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.
• Pegue un Visitor ID y elija Search Visitor.

Obtenga un Visitor ID #

Utilice el endpoint de Visitor ID para obtener el ID del navegador que desea inspeccionar:

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

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

Qué muestra el registro #

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

• API: El endpoint que se llamó (por ejemplo search/omni).
• Etiquetas: Cualquier etiqueta asociada a la llamada (por ejemplo, la superficie de la interfaz de usuario, como “Omnisearch”).
• Entrada: Parámetros enviados al endpoint. Los ejemplos incluyen la consulta de búsqueda, un ID de producto en el que se basan las recomendaciones, o un identificador de categoría/página.
• Salida: IDs devueltos por los endpoints que generan resultados (por ejemplo, Recommendations como Popular, Category o Alternatives). Las llamadas que no devuelven una lista de resultados dejarán esto vacío.
• Metadatos: Contexto utilizado para la llamada, como idioma, URL, filtros, IDs de plantilla, elementos fijados/excluidos y configuraciones de sinónimos.
• Hora: Cuándo ocurrió el evento, los más nuevos primero.

Usos típicos #

• Debug Search: Inspeccione las llamadas recientes search/omni para ver la consulta, los filtros y el idioma utilizados, y si se devolvieron resultados.
• Verify Recommendations: Confirme qué entrada (producto/categoría/página) produjo qué IDs de resultado, y revise cualquier filtro o fijación.
• Validate Page Views: Verifique los metadatos relacionados con la página o la plantilla para asegurar que se envíe el contexto correcto.

Consejos #

• Si Salida está vacía, consulte en Metadatos los filtros, el idioma u otros ajustes que puedan explicar por qué no coincidió nada.
• Use el Visitor ID exacto desde el navegador/sesión donde observó el comportamiento; diferentes sesiones mostrarán registros diferentes.
• Asegúrese de que Clerk.js esté instalado en la página que está probando; si no hay llamadas, no aparecerá nada en el registro.