> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Registro de Actividad
> Explore y filtre eventos de seguimiento en bruto — clics, envíos de formularios, triggers y eventos personalizados con payloads de datos completos
## Descripción General
La pestaña de Registro de Actividad muestra los 500 eventos de seguimiento más recientes capturados en su sitio web. Úsela para monitorear las interacciones de los visitantes, depurar el seguimiento de eventos, verificar las activaciones de triggers e inspeccionar los datos de formularios capturados — todo en un feed cronológico.
***
## Tabla de Eventos
Cada fila en el registro de actividad representa un único evento rastreado:
| Columna | Descripción |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hora** | Cuándo ocurrió el evento. Los eventos recientes muestran tiempo relativo (por ejemplo, "hace 5m"), los eventos más antiguos muestran fecha y hora. Pase el cursor para ver la marca de tiempo completa. |
| **Evento** | Icono y nombre del evento. El nombre proviene de la definición del evento (si está vinculado), nombre del trigger (si está relacionado con trigger) o el tipo de evento en bruto. |
| **Página** | La URL de la página donde se disparó el evento. Las URLs largas se truncan a 50 caracteres — pase el cursor para ver la ruta completa. |
| **Datos** | Vista previa del payload del evento — muestra los primeros 3 pares clave-valor. Si hay más, aparece una insignia "+N más". Los eventos sin datos muestran "—". |
| **Sesión** | ID de sesión que vincula el evento a una sesión de visitante específica. |
La tabla muestra **15 eventos por página** con paginación en la parte inferior.
***
## Tipos de Eventos
El registro de actividad captura varias categorías de eventos:
### Eventos de Interacción
| Tipo | Icono | Descripción |
| ---------------- | --------- | ---------------------------------------------------------------------------------------------- |
| **click** | Puntero | El visitante hizo clic en un elemento que coincide con un selector CSS definido en sus eventos |
| **scroll** | Flechas | El visitante se desplazó más allá de un elemento rastreado (IntersectionObserver) |
| **form\_submit** | Documento | El visitante envió un formulario que coincide con un selector CSS |
| **custom** | Código | Evento personalizado disparado vía `RevolTracker.track()` desde su código JavaScript |
### Eventos de Trigger
| Tipo | Icono | Descripción |
| -------------------------- | ------------ | --------------------------------------------------------------------- |
| **trigger\_shown** | Campana | Se mostró un trigger al visitante (modal, toast o redireccionamiento) |
| **trigger\_clicked** | Cursor | El visitante hizo clic en un botón dentro de un overlay de trigger |
| **trigger\_dismissed** | X | El visitante cerró o descartó un overlay de trigger |
| **trigger\_promo\_copied** | Portapapeles | El visitante copió un código promocional de un trigger |
### Eventos de Ciclo de Vida
| Tipo | Icono | Descripción |
| -------------- | ----- | ---------------------------------------------------- |
| **visibility** | Ojo | Un elemento rastreado se hizo visible en el viewport |
Los eventos de ciclo de vida (trigger\_shown, trigger\_dismissed, visibility) están **ocultos por defecto** para reducir el ruido. Use el filtro de Ciclo de Vida para mostrarlos.
***
## Filtros
El registro de actividad soporta un sistema de filtros flexible. Haga clic en el botón **+ Filtro** para agregar filtros. Los filtros activos aparecen como chips removibles sobre la tabla.
### Filtros Disponibles
| Filtro | Tipo | Descripción |
| ------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tipo de Evento** | Servidor | Mostrar solo eventos de un tipo específico: click, scroll, form\_submit, visibility, custom o trigger |
| **Campaña** | Servidor | Mostrar eventos solo de sesiones vinculadas a una campaña específica. El desplegable se llena dinámicamente con sus campañas existentes. |
| **Tiene Datos** | Híbrido | Filtrar por payload del evento: **Cualquier dato** (eventos con payload), **Sin datos** (eventos sin payload) o **Solo datos de formulario** (eventos que contienen campos de formulario como email, teléfono, nombre) |
| **Ciclo de Vida** | Cliente | Alternar la visibilidad de eventos de ciclo de vida (trigger\_shown, trigger\_dismissed, visibility). Ocultos por defecto. |
| **Buscar** | Cliente | Búsqueda de texto libre en tipo de evento y URL de página. Filtra en tiempo real con un debounce de 200ms. |
Los **filtros del servidor** (Tipo de Evento, Campaña, Cualquier dato) activan una recarga completa de datos desde el servidor. Los **filtros del cliente** (Ciclo de Vida, Sin datos, Datos de formulario, Buscar) filtran los datos ya cargados instantáneamente — sin necesidad de solicitud de red.
### Comportamiento de Filtros
* Los filtros ya aplicados se deshabilitan en el desplegable para prevenir duplicados
* Cada chip de filtro muestra el nombre del filtro y el valor seleccionado
* Haga clic en la **×** de un chip para eliminar el filtro
* Los filtros se pueden combinar — por ejemplo, mostrar solo eventos `form_submit` de una campaña específica que tengan datos de formulario
***
## Panel de Detalle del Evento
Haga clic en cualquier fila de evento que tenga datos (la columna **Datos** muestra pares clave-valor en lugar de "—") para expandir el panel de detalle debajo de la fila. El panel muestra el payload completo del evento como un **bloque JSON con resaltado de sintaxis**.
### Bloque de Código JSON
El panel expandido renderiza el objeto completo `event_data` con sintaxis codificada por colores:
| Elemento | Color | Ejemplo |
| ---------------------------- | ------- | --------------------- |
| **Claves** | Púrpura | `"fields"`, `"email"` |
| **Valores de cadena** | Verde | `"john@example.com"` |
| **Números, booleanos, nulo** | Naranja | `42`, `true`, `null` |
### Qué Contienen los Datos
El payload JSON varía según el tipo de evento:
```json theme={null}
{
"selector": "#cta-button",
"text": "Get Started",
"x": 452,
"y": 320
}
```
Contiene el selector CSS que coincidió, el contenido de texto del elemento y las coordenadas del clic.
```json theme={null}
{
"fields": {
"email": "visitor@example.com",
"Phone": "0961234567",
"name": "John"
}
}
```
Contiene los valores capturados de los campos del formulario. Los campos de contraseña y ocultos se excluyen automáticamente.
```json theme={null}
{
"product_id": "SKU-12345",
"product_name": "Running Shoes",
"price": 89.99,
"currency": "USD"
}
```
Contiene los datos que se pasaron a `RevolTracker.track()`. La estructura depende de su implementación.
```json theme={null}
{
"action_type": "modal"
}
```
Contiene el tipo de acción del trigger (modal, toast o redirect).
### Botón de Copiar
Cada bloque JSON tiene un botón **Copiar** en la esquina inferior derecha. Haga clic para copiar el JSON formateado al portapapeles — útil para depuración, compartir con compañeros de equipo o importar datos a otras herramientas.
***
## Casos de Uso
Después de configurar un nuevo evento de clic o formulario, abra el Registro de Actividad e interactúe con el elemento en su sitio web. El evento debería aparecer en el registro en segundos. Revise la columna Datos para verificar que el payload correcto se captura.
Habilite el filtro de **Ciclo de Vida** para mostrar eventos `trigger_shown`. Navegue su sitio con diferentes condiciones (parámetros UTM, tipos de dispositivo, profundidades de scroll) para confirmar que los triggers se disparan cuando se espera.
Use el filtro **Tiene Datos → Solo datos de formulario** para ver todos los envíos de formularios con valores de campos capturados. Expanda cada fila para inspeccionar el payload completo — verifique que los campos correctos se están capturando y que no se están filtrando datos sensibles.
Seleccione una campaña específica del filtro de **Campaña** para ver todos los eventos de visitantes que llegaron a través de esa campaña. Útil para verificar que la atribución de campaña funciona correctamente.
Encuentre el evento que necesita, expanda el panel de detalle y haga clic en **Copiar** para obtener el payload JSON. Péguelo en una hoja de cálculo, mensaje de Slack o ticket de soporte para referencia rápida.
***
## Límites
* El registro de actividad carga los **últimos 500 eventos** del servidor. Los eventos más antiguos están disponibles a través de las vistas de eventos a nivel de sesión.
* La **Búsqueda** coincide solo con el tipo de evento y la URL de página — no busca dentro de los payloads de datos de eventos.
* Los eventos sin `event_data` no se pueden expandir (la fila no es clicable).
* La navegación de página colapsa cualquier panel de detalle abierto.