Seguimiento de eventos personalizados

¿Qué son los eventos personalizados?

Las páginas vistas se registran solas, pero muchas acciones importantes no implican cargar una página nueva: hacer clic en un botón, enviar un formulario, reproducir un vídeo o descargar un archivo. Los eventos personalizados te permiten medir estas interacciones.

Registrar eventos con JavaScript

Usa la función umami.track() en cualquier parte del JavaScript de tu web:

// Basic event — just a name
umami.track('signup-click');

// Event with custom data
umami.track('download', {
  fileName: 'whitepaper-2026.pdf',
  category: 'resources'
});

// Event with multiple properties
umami.track('video-play', {
  title: 'Product Demo',
  duration: 120,
  autoplay: false
});

Registrar eventos con atributos HTML

Para medir clics sencillos no hace falta escribir JavaScript. Basta con añadir el atributo data-umami-event a cualquier elemento HTML:

<!-- Basic click event -->
<button data-umami-event="signup-click">Sign Up</button>

<!-- Event with extra data -->
<a href="/pricing"
   data-umami-event="cta-click"
   data-umami-event-location="header">
  View Pricing
</a>

<!-- Download tracking -->
<a href="/files/report.pdf"
   data-umami-event="download"
   data-umami-event-file="report.pdf">
  Download Report
</a>

Todos los atributos data-umami-event-* se convierten en propiedades personalizadas del evento.

Ver los datos de eventos

Ve a Events en la barra lateral, dentro de Traffic.

Verás:

• Cronología de eventos: un gráfico con los eventos a lo largo del tiempo
• Lista de eventos: todos los eventos registrados con su recuento
• Propiedades del evento: haz clic en un evento para ver el desglose de sus datos personalizados

Identificación de usuarios

También puedes identificar a los visitantes con propiedades personalizadas mediante umami.identify():

umami.identify({
  userId: 'user-123',
  plan: 'pro',
  company: 'Acme Corp'
});

Esto asocia datos personalizados a la sesión del visitante, que luego puedes usar para filtrar y segmentar.

Patrones habituales de seguimiento de eventos

Buenas prácticas

• Usa nombres descriptivos y coherentes. add-to-cart es mejor que click1.
• Mantén limpios los valores de las propiedades. Evita valores dinámicos que generen demasiadas entradas únicas (por ejemplo, marcas de tiempo).
• Mide el resultado, no el clic. Registra form-submit, no submit-button-click.
• No midas de más. Céntrate en los eventos que te dan información útil para actuar.

¿Qué sigue?

• → Seguimiento de objetivos de conversión: usa eventos como objetivos de conversión
• → Configurar embudos de conversión: crea embudos a partir de eventos
• → Seguimiento de ingresos: añade datos de ingresos a los eventos

¿Necesitas ayuda? Escríbenos a support@eurometrics.eu.