Eventos personalizados

Ademas de las vistas de pagina automaticas, MetriXs rastrea eventos personalizados, cualquier cosa que quieras medir: clics de botones, envios de formularios, reproducciones de video, registros, compras. Los eventos personalizados tienen sus propias propiedades que puedes adjuntar, y el panel las desglosa por ti.

Envio de eventos personalizados

Dispara un evento personalizado desde tu sitio con la funcion global metrixs() (disponible una vez que el script del tracker se ha cargado):

// Un evento personalizado con propiedades
metrixs('Signup', { props: { plan: 'pro', location: 'hero' } })

Opcion	Tipo	Por defecto	Descripcion
`name`	`string`	—	El nombre del evento. Usa `'pageview'` para una vista de pagina manual.
`props`	`object`	`{}`	Propiedades personalizadas para adjuntar al evento.
`url`	`string`	`location.href`	Sobrescribe la URL de pagina registrada para este evento (util para cambios de ruta SPA).
`interactive`	`boolean`	`true`	Establecer en `false` para senales pasivas que no deben contar como una interaccion real (para no bajar la tasa de rebote). Los eventos integrados de profundidad de desplazamiento/engagement usan esto.
`callback`	`function`	—	Llamado despues de enviar el evento.

// Senal no interactiva, extiende la duracion de la visita sin afectar la tasa de rebote
metrixs('scroll_to_bottom', { props: { article: 'gdpr' }, interactive: false })

Los eventos personalizados que se disparan durante una visita tambien extienden su duracion medida, porque la duracion se calcula como el tiempo entre la primera vista de pagina y el ultimo evento. Consulta Duracion de visita para ver por que importa.

Eventos rastreados automaticamente

El tracker captura automaticamente tres tipos de eventos, sin configuracion necesaria:

Nombre del evento	Cuando se dispara	Propiedad
`Outbound Link: Click`	Un visitante hace clic en un enlace a un dominio externo	`url`
`File Download`	Un visitante hace clic en un enlace a un archivo (pdf, zip, mp4, docx, …)	`url`
`404`	Una pagina 404, solo si la pagina define `<meta name="metrixs:404" content="true">`	`path`

Estos aparecen en el panel en su propia tarjeta de Eventos rastreados automaticamente, separados de tus eventos personalizados, para que tus eventos personalizados permanezcan limpios.

El tracker lite (tracker.lite.js) omite el rastreo automatico, solo vistas de pagina. Usa el tracker.js completo si quieres capturar enlaces salientes, descargas y 404s.

Ver eventos personalizados en el panel

El panel muestra dos tarjetas (solo cuando el sitio tiene eventos personalizados, se ocultan si no, para que no haya desorden en sitios que no los usan):

Eventos personalizados, tus eventos definidos por el usuario.
Eventos rastreados automaticamente, enlaces salientes, descargas de archivos y 404s.

Cada fila muestra el nombre del evento y cuantas veces se disparo, con una barra escalada al evento principal. Haz clic en una fila para expandirla y ver su desglose de propiedades, cada clave de propiedad con sus valores principales y recuentos.

Hacer clic en un valor de propiedad (por ejemplo plan = pro) filtra todo el panel a ese segmento, igual que hacer clic en una pagina o un pais. Elimina el filtro desde la barra de filtros superior.

Como se almacenan las propiedades

Las propiedades de eventos personalizados se almacenan en ClickHouse como arrays paralelos meta.key / meta.value (una fila por evento). El panel descubre las claves de propiedades por evento con un endpoint dedicado POST /api/v2/event-props (el constructor de consultas principal no puede enumerar claves desconocidas), luego lee cada valor via la dimension event:props:<key>. Las claves de propiedades estan restringidas a ^[a-zA-Z0-9_-]+$, limitate a letras, numeros, guiones y guiones bajos.