Si llevas tiempo trabajando con HubSpot, probablemente ya hayas explotado al máximo las métricas estándar: aperturas de email, envíos de formulario, visitas a páginas. Son útiles, pero tienen un techo. No te dicen qué hizo exactamente un usuario antes de convertir, ni qué funcionalidad de tu SaaS retiene más clientes, ni qué vídeo de producto convierte mejor a los leads en oportunidades reales.
Ahí es donde entran los eventos personalizados de HubSpot (custom events). En esta guía los diseccionaremos desde cero: qué son, cómo configurarlos, cómo enviar datos y, sobre todo, para qué casos concretos usarlos para generar informes que realmente muevan la aguja del negocio.
Qué son los Custom Events (y en qué se diferencian de los eventos estándar)
HubSpot ya rastrea por defecto una serie de interacciones: visitas a páginas, clics en emails, envíos de formularios, conversaciones en chat. Estos son los eventos estándar: predefinidos, listos para usar, pero genéricos por naturaleza.
Los custom events son interacciones que tú defines y rastreas según las necesidades de tu modelo de negocio. Representan acciones de alto valor en tu web o aplicación que señalan intención, engagement o progreso en el journey del cliente.
La diferencia clave es el control. Con los eventos personalizados puedes capturar exactamente lo que importa para tu negocio, enriquecerlo con propiedades a medida y cruzarlo con objetos CRM como contactos o deals para obtener una imagen completa del comportamiento del usuario.
Importante: Esta funcionalidad está disponible en los planes Enterprise de Marketing Hub, Sales Hub, Service Hub y Operations Hub.
Cómo crear un Custom Event paso a paso
El proceso de configuración es más sencillo de lo que parece:
- En tu cuenta de HubSpot, ve a Informes > Gestión de datos > Eventos.
- Haz clic en Crear evento (arriba a la derecha).
- Define el nombre del evento. Usa siempre el formato
Objeto-Acciónen minúsculas con guiones. Ejemplos válidos:video-reproducido,calculadora-precio-usada,demo-solicitada. Esto evita duplicados y hace que los eventos sean fácilmente identificables en el constructor de informes. - Crea propiedades personalizadas. Aquí está la verdadera potencia. Cada propiedad añade contexto al evento:
video_titulo(Texto): Nombre del vídeo reproducido.duracion_reproduccion_segundos(Número): Tiempo visionado.categoria_video(Enumeración): «Demo de producto», «Caso de éxito», «Tutorial».
Al definir propiedades específicas desde el principio, te dás los materiales necesarios para construir informes segmentados y accionables.
Cómo enviar datos a tus Custom Event
Una vez definido el evento en HubSpot, necesitas «dispararlos» cuando ocurran. Hay tres métodos principales:
1. Código de seguimiento JavaScript (para interacciones en web)
Es el método más común para rastrear acciones que el usuario realiza en el navegador: clic en un botón, reproducción de un vídeo, interacción con un widget. Se añade un pequeño snippet de código al sitio web:
var _hsq = window._hsq = window._hsq || [];
_hsq.push(["trackCustomBehavioralEvent", {
name: "pe23985_video_reproducido", // Nombre interno del evento en HubSpot
properties: {
video_titulo: "Cómo empezar con nuestro producto",
duracion_reproduccion_segundos: 120,
categoria_video: "Tutorial"
}
}]);
2. Events API de HubSpot (para acciones en servidor)
Algunas acciones importantes no ocurren en el navegador del usuario. Piensa en una actualización de suscripción en un SaaS, en la activación de una integración o en el procesamiento de un pago. La Events API permite que tu servidor envíe estos datos directamente a HubSpot, completando el cuadro del customer journey para empresas con modelos product-led.
3. Workflows de HubSpot (para desencadenantes internos)
Puedes usar el motor de automatización de HubSpot para disparar un evento personalizado basado en cambios de datos internos. Por ejemplo, cuando el lifecycle stage de un contacto cambia a «Oportunidad», puedes lanzar un evento deal-creado para usarlo en informes de embudo. Es especialmente útil para conectar comportamientos de marketing con resultados de ventas sin tocar código.
Buenas prácticas de diseño de eventos
La calidad de tus informes depende directamente de la calidad de los datos que entren. Sigue estas reglas:
Convención de nombres consistente. Adopta siempre el formato objeto-acción (ej. funcionalidad-activada, ebook-descargado, integracion-conectada). Evita nombres genéricos como «click» o «accion_usuario» que no dicen nada.
Propiedades específicas, no genéricas. En vez de una propiedad llamada nombre, usa titulo_ebook o nombre_funcionalidad. Tus datos deben ser autoexplicativos al revisarlos seis meses después.
Planifica antes de implementar. Antes de añadir una sola línea de código, mapea las acciones clave que quieres rastrear y las preguntas que quieres responder. Un plan claro evita eventos duplicados, propiedades huérfanas y deuda técnica en tu tracking.
Cómo construir informes potentes con los datos de Custom Events
Aquí es donde se materializa el trabajo de configuración. Una vez que los datos fluyen, puedes usar el constructor de informes personalizados de HubSpot para visualizar insights que antes estaban ocultos.
Informes de embudo
Rastrea cuántos usuarios completan una secuencia de eventos. Por ejemplo:
página-precios-vista → demo-solicitada → deal-creado
Esto te permite identificar exactamente dónde se pierden los usuarios en el camino a la conversión.
Segmentación por propiedades
Filtra tus informes usando las propiedades que definiste. Puedes analizar el comportamiento de usuarios que vieron vídeos de «Demo de producto» frente a los que vieron «Casos de éxito», o comparar la tasa de conversión según la funcionalidad que activaron primero.
Cruce con objetos CRM
Combina eventos de comportamiento con datos de negocio. ¿Los contactos que usan la calculadora de precios generan deals de mayor valor? ¿Los usuarios que completan el onboarding en los primeros 7 días tienen menor tasa de churn? Estas son las preguntas que solo puedes responder cruzando eventos personalizados con objetos CRM.
Dashboards en tiempo real
Añade tus informes de eventos a dashboards de marketing o ventas para dar a los stakeholders visibilidad en tiempo real del rendimiento frente a acciones de negocio clave.
Casos de uso prácticos con ejemplos concretos
1. SaaS: Adopción de funcionalidades y prevención de churn
Escenario: Una empresa de software B2B quiere saber qué funcionalidades están correlacionadas con la retención de clientes.
Implementación: Se lanza un evento funcionalidad-activada cada vez que un usuario habilita una característica en la app, con propiedades como nombre_funcionalidad, plan_usuario y dias_desde_registro.
Informes resultantes:
- ¿Qué funcionalidades activan más los usuarios en su primera semana?
- ¿Existe correlación entre activar la funcionalidad X en los primeros 14 días y la renovación al año?
- ¿Qué segmento de plan tiene menor adopción de funcionalidades clave?
Acción resultante: Identificar que los usuarios que no activan la integración con Slack en los primeros 10 días tienen el doble de probabilidad de churnar, lo que justifica un workflow automatizado de onboarding específico para esa funcionalidad.
2. Ecommerce: Comportamiento pre-compra y recuperación de carritos
Escenario: Una tienda online quiere entender el recorrido completo antes de la compra, no solo el carrito abandonado.
Implementación: Se configuran eventos para producto-visto, categoria-explorada, producto-en-lista-deseos, añadir-al-carrito, inicio-checkout y compra-completada. Propiedades como categoria_producto, precio_unitario, source_trafico y dispositivo enriquecen cada evento.
Informes resultantes:
- Embudo completo desde la primera visita a un producto hasta la compra.
- Categorías con mayor tasa de «vista» pero menor conversión a carrito (potencial señal de problema de precio o descripción).
- Comportamiento diferenciado por dispositivo: ¿los usuarios móviles añaden al carrito pero compran desde escritorio?
Acción resultante: Descubrir que el 60% de los usuarios que añaden a lista de deseos convierten en los 7 días siguientes si reciben un email específico, permitiendo diseñar una secuencia de nurturing mucho más precisa que un genérico «carrito abandonado».
3. Marketing de contenidos: Engagement profundo y calificación de leads
Escenario: Una empresa B2B quiere entender qué contenido de su web convierte mejor a leads cualificados, más allá de cuántas visitas recibe cada página.
Implementación: Se rastrean eventos como pdf-descargado (con titulo_pdf, categoria_contenido, fase_funnel), calculadora-usada (con resultado_calculado, sector_usuario), video-completado (con propiedades de porcentaje de reproducción), y comparador-productos-interactuado.
Informes resultantes:
- ¿Qué lead magnets tienen mayor tasa de descarga-a-oportunidad?
- ¿Los usuarios que usan la calculadora de ROI generan deals de mayor tamaño?
- ¿Hay diferencia en el tiempo de cierre entre leads que vieron el vídeo de demo completo frente a los que no?
Acción resultante: Detectar que los contactos que usan la calculadora de ahorro y descargan el caso de éxito del mismo sector tienen una tasa de cierre 3 veces superior, lo que justifica priorizar esos recursos en campañas de nurturing para los segmentos de mayor valor.
4. Educación online / Plataformas de aprendizaje
Escenario: Una plataforma e-learning quiere rastrear el progreso de los estudiantes para mejorar la finalización de cursos.
Implementación: Eventos como leccion-iniciada, leccion-completada, ejercicio-enviado, certificado-descargado, con propiedades como nombre_curso, numero_leccion, tiempo_invertido_minutos y puntuacion_ejercicio.
Informes resultantes:
- ¿En qué lección exacta abandonan más estudiantes?
- ¿Hay correlación entre el tiempo invertido en las primeras lecciones y la finalización del curso?
- ¿Los estudiantes que descargan el certificado tienen mayor tasa de renovación de suscripción?
Acción resultante: Identificar que el abandono se concentra en la lección 3 de todos los cursos, que resulta ser la más larga y teórica, lo que lleva a rediseñarla con más ejercicios interactivos, reduciendo el abandono un 30%.
5. Servicios profesionales: Cualificación y señales de intención de compra
Escenario: Una consultora quiere identificar qué comportamientos en su web predicen mejor una solicitud de propuesta.
Implementación: Eventos como caso-exito-leido (con sector, tamaño_empresa_mencionada), pagina-precios-explorada (con tiempo_en_pagina_segundos, plan_consultado), webinar-registrado (con tema_webinar) y herramienta-diagnostico-completada (con resultado del diagnóstico).
Informes resultantes:
- ¿Qué combinación de comportamientos precede más a menudo a una solicitud de propuesta?
- ¿Los leads que asisten a webinars de un tema específico tienen mayor tasa de conversión en ciertos servicios?
- ¿Existe un umbral de tiempo en la página de precios que correlacione con la conversión?
Acción resultante: Crear un scoring de lead más sofisticado basado en señales de intención específicas (ej. +15 puntos si usa la herramienta de diagnóstico, +10 si lee 2 o más casos de éxito del mismo sector), mejorando la calidad de los leads que llegan a ventas.
6. Vídeo marketing: Prueba de ROI de contenido audiovisual
Escenario: Un equipo de marketing invierte significativamente en producción de vídeo y necesita demostrar su impacto en el pipeline.
Implementación: Se rastrean eventos con hitos de reproducción: video-25-porciento, video-50-porciento, video-75-porciento, video-completado, cta-video-clicado. Propiedades: titulo_video, tipo_video (demo, testimonial, explicativo, caso de éxito), pagina_donde_se_reproduce.
Informes resultantes:
- ¿Qué tipo de vídeo tiene mayor tasa de finalización?
- ¿Los contactos que ven los vídeos de demo tienen mayor tasa de solicitud de demo real?
- ¿Qué vídeos generan más clics en el CTA interno?
- Correlación entre ver un vídeo de testimonial y velocidad del ciclo de ventas.
Acción resultante: Demostrar que los leads que completan el vídeo de demo de producto tienen un ciclo de ventas 40% más corto, justificando mayor inversión en distribución de ese contenido.
Limitaciones a tener en cuenta
Como cualquier herramienta, los custom events tienen restricciones que conviene conocer para diseñar una estrategia sostenible:
Volumen de eventos: HubSpot establece límites sobre el número de eventos que se pueden enviar por segundo y en total. Son generosos, pero si tu sitio tiene mucho tráfico o lanzas eventos con mucha frecuencia, conviene revisarlos.
Límite de propiedades: Cada custom event puede tener un máximo de 50 propiedades. Más que suficiente para la mayoría de casos, pero es un incentivo para ser estratégico y no crear propiedades innecesarias.
Retención de datos: Los datos de completado de eventos se almacenan indefinidamente, pero los datos granulares de propiedades de eventos tienen políticas de retención según tu plan de suscripción.
Preguntas frecuentes
¿Cuántos custom events puedo crear? El número de eventos personalizados disponibles depende del plan y el hub. Revisa los límites específicos en la documentación de HubSpot para tu suscripción actual.
¿Puedo usar custom events en workflows de automatización? Sí. Puedes usar un custom event como desencadenante de un workflow o como criterio de enrolamiento. Por ejemplo, enviar un email de seguimiento específico cuando un contacto completa el 75% de un vídeo de demo.
¿Se puede cruzar un custom event con un deal en los informes? Sí. En el constructor de informes personalizados puedes combinar eventos con objetos CRM como contactos y deals, lo que permite responder preguntas como «¿los contactos que hicieron X acción generaron deals de mayor valor?».
¿Es necesario tener un desarrollador para implementar custom events? Para los métodos via JavaScript o API, sí es recomendable contar con apoyo técnico. Para los eventos disparados por workflows, no se necesita conocimiento técnico.