Ir a contenido principal
Nota: Este contenido se tradujo a través de un software y es posible que no haya sido revisado. La versión en inglés se considera, por tanto, la versión oficial y es posible que haya sido actualizada. Para acceder a la versión en inglés, haz clic aquí.

Cree eventos de comportamiento personalizados con el asistente de código

Última actualización: junio 21, 2023

Disponible con cualquiera de las siguientes suscripciones, a no ser que se indique lo contrario:

Marketing Hub Enterprise

Los eventos de comportamiento personalizados le permiten definir y realizar un seguimiento de los eventos exclusivos de su empresa. Los eventos personalizados de comportamiento pueden relacionarse con propiedades de evento, que puedes usar en las herramientas de HubSpot. Los eventos creados con el "fragmento de código Javascript añaden automáticamente los datos del evento al código de seguimiento de HubSpot de su sitio y requieren que alguien familiarizado con Javascript los configure. Los eventos de seguimiento manual utilizan la API de análisis , y requieren que un desarrollador los configure. 

Aprende a utilizar la herramienta de eventos de comportamiento personalizados para crear eventos de elemento pulsado y eventos de URL visitada.

Nota: la herramienta de eventos de comportamiento personalizados reemplaza la herramienta de eventos de comportamiento anterior. Cualquier evento creado en la herramienta preexistente seguirá funcionando, y aún puedes administrar y analizar esos eventos en la herramienta preexistente

El proceso de creación de eventos implica dos partes:

  • Definir el evento en HubSpot, incluyendo cualquier propiedad de evento personalizada.
  • Crear un fragmento de código Javascript o Definir la llamada a la API que activará el evento. 

Crear el evento en HubSpot

Para configurar un evento de comportamiento personalizado, primero crearás el evento y luego asocia las propiedades con el evento:

  • En tu cuenta de HubSpot, dirígete a Informes > Herramientas de analíticas.
  • Haz clic en Eventos de comportamiento personalizados.
  • En la parte superior derecha, haga clic en Crear evento personalizado.
  • Seleccione Asistente de códigos.

  • Introduzca un nombre para el evento y, si lo desea, una descripción
  • En el menú desplegable, seleccione su objeto asociado. Esto te permite asociar las finalizaciones de tus eventos con diferentes objetos en HubSpot, incluyendo Contactos, Empresas, Negocios y Tickets

nombre-evento-conductual-personalizado

  • Haga clic en Siguiente para continuar.

Añadir propiedades de eventos

Cuando se crea un evento, las propiedades predeterminadas del evento estarán disponibles. También puede crear sus propias propiedades personalizadas. Las propiedades de eventos se almacenan por separado de otras propiedades de CRM y son únicas para el evento (es decir, no puedes editar estas propiedades desde la configuración de tu cuenta). 

Para crear propiedades para un evento:

  • Selecciona el tipo de propiedad haciendo clic en el tipo de campo para tu propiedad. Las opciones incluyen: 
    • Propiedad de cadena personalizada: crea una propiedad que es una cadena de texto sin formato. 
    • Propiedad numérica personalizada: crea una propiedad que sea un valor numérico.
    • Propiedad timestamp personalizada: crea una propiedad que sea un valor de fecha. Debes enviar tus datos en forma de milisegundos de época o ISO8601. 
    • Propiedad de enumeración personalizada: crea una propiedad con un conjunto de valores predefinidos.

      create-property-custom-behavioral-event
    • Una vez seleccionada la propiedad, configúrela en el panel derecho:

    • Introduzca un nombre para la propiedad e introduzca una Descripción para la propiedad.
    • Para las propiedades de Enumeración, haga clic en Siguiente e introduzca las Etiquetas y Valoresde sus propiedades. Debe establecer sus valores y etiquetas antes de enviarles datos. Si este paso no se completa antes de enviar datos que no están en la lista, los datos no estarán disponibles para su uso. Para enviar varios valores, sepárelos con punto y coma.
    • Haz clic en Listo.
    • Una vez creada tu propiedad, aparecerá en la tabla bajo las propiedades de eventos por defecto deHubSpot. Puede editar o eliminar su propiedad seleccionando el desplegable Acciones y seleccionando Editar o Eliminar
  • Haz clic en Siguiente.
  • Después de configurar el evento y sus propiedades, puedes añadir este evento al código de seguimiento de tu sitio web seleccionando Fragmento de código Javascript, o enviar los datos a HubSpot a través de la API seleccionando Enviar datos a HubSpot

Crear un fragmento de código Javascript

Crear eventos con un fragmento de código Javascript te permite añadir Javascript a tu código de seguimiento de HubSpot automáticamente. Se puede utilizar para capturar datos de eventos más complejos que el código de seguimiento no captura por defecto. 

  • Seleccione el fragmento de código Javascript. Utilice el fragmento del panel derecho para realizar el seguimiento del evento en HubSpot. Las propiedades personalizadas creadas se predefinirán en el fragmento de código. 
  • Modifique el fragmento según sea necesario introduciendo texto en el panel derecho. Cualquier código que añadas se incluirá automáticamente como parte de tu código de seguimiento de HubSpot.
  • Cuando haya terminado, haga clic en Crear para finalizar su evento e iniciar automáticamente el seguimiento.
    example-code-snippet-custom-event

Enviar datos a HubSpot

Si está enviando datos a HubSpot, tendrá que definir la llamada a la API para activar el evento. Aprende a definir tu llamada a la API en La documentación para desarrolladores de HubSpot.

Necesitarás algunos datos para tu llamada de API, que puedes obtener desde HubSpot:

  • Nombre del evento: el nombre interno del evento. 
  • Nombre de la propiedad: los nombres internos de las propiedades que enviarás datos.

Para terminar de crear tu evento para enviar datos vía API:

  • Seleccione Enviar datos a Hub Spot y copie el ID de seguimiento.
  • Haga clic en Crear.

Para encontrar el nombre de evento interno de un evento existente y los nombres de las propiedades:

  • En tu cuenta de HubSpot, dirígete a Informes > Herramientas de analíticas.
  • Haz clic en Eventos de comportamiento personalizados.
  • Haga clic en el nombre del evento. Se te dirigirá a la página de detalles del evento.
  • En la parte superior, localice el nombre del evento en Nombre interno.
    internal-name-custom-event
  • Para encontrar los nombres internos de las propiedades que va a actualizar, haga clic en el nombre de una propiedad.
  • En el panel derecho, haga clic en el icono de código y, a continuación, visualice el nombre en Nombre interno.
Ten en cuenta:
Cuando envíes datos a tu evento, se aplicarán los límites que se indican a continuación:
  • Los nombres de las propiedades están limitados a 50 caracteres. 
  • Las propiedades de URL y referencia pueden recibir hasta 1024 caracteres, mientras que todas las demás propiedades pueden recibir hasta 256 caracteres.
  • Cada finalización de evento puede contener datos de hasta 50 propiedades.
  • Los nombres internos de las propiedades deben empezar por una letra y contener sólo letras minúsculas de la a a la z, números del 0 al 9 y guiones bajos. Las propiedades con el mismo nombre interno después de las minúsculas se consideran duplicadas, y sólo se utilizará una de las propiedades al finalizar.
Si se superan estos límites al realizar una solicitud de API HTTP, la solicitud fallará. Si se superan estos límites al realizar una solicitud de API JS, HubSpot truncará cualquier valor de nombre de propiedad hasta la longitud permitida y/o actualizará sólo 50 propiedades por finalización de evento.

Usa datos de eventos de comportamiento personalizados

Los datos de eventos de comportamiento personalizados se pueden ver y usar en las herramientas de HubSpot. A continuación, descubre dónde ver las finalizaciones de eventos y las maneras en que puedes incorporar esa información a otras herramientas.

Informar sobre eventos personalizados

Los eventos completados pueden ser analizados desde la herramienta de eventos personalizados de comportamiento y también estarán disponibles los datos de eventos en el generador de informes personalizados y los informes de atribución.

Más información sobre analizando tus eventos de comportamiento personalizados.

Ver las finalizaciones de eventos en la cronología del contacto

Los eventos completados aparecerán en la cronología del registro de contacto, junto con cualquier propiedad que se haya cargado.

Para ver los detalles del evento en la cronología del contacto:

  • Navega hasta un registro de contacto que haya completado un evento de comportamiento personalizado.
  • Para filtrar una cronología de contactos por eventos completados, haga clic en Filtrar actividad y, a continuación, seleccione Evento de comportamiento personalizado.
  • En la cronología de contactos, haga clic para expandir el evento y mostrar los detalles del mismo.

Usar eventos de comportamiento personalizados en workflows

En un workflow, puedes retrasar basándote en la finalización de eventos de comportamiento personalizados mediante una acción de Retrasar hasta que ocurra el evento:

  • En tu cuenta de HubSpot, dirígete a Automatización > Workflows.
  • Haz clic en el nombre de un workflow. O, aprende a crear un nuevo workflow.
  • En el editor de workflow, haga clic en el icono + más para añadir una acción de workflow.
  • En el panel derecho, seleccione Retraso hasta que se produzca el evento.
  • Configura el retraso:
    • Haz clic en el menú desplegable Evento y luego selecciona un evento de comportamiento personalizado.
    • Luego, selecciona la propiedad del evento que deseas retrasar.
    • Seleccione el filtro para la propiedad del evento.
    • Haz clic en Aplicar Filtro.
    • Selecciona la hora de espera máxima o selecciona la casilla de comprobación Retraso en la medida de lo posible.
  • Haz clic en Guardar.

El workflow se retrasará de los registros inscritos hasta que cumplan con los criterios de eventos personalizados especificados. 

¿Te resultó útil este artículo?
Este formulario se utiliza solo para recibir comentarios a la documentación. Cómo recibir ayuda con HubSpot.