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í.

Crear eventos personalizados

Última actualización: octubre 15, 2024

Disponible con cualquiera de las siguientes suscripciones, a no ser que se indique de otro modo:

Marketing Hub   Enterprise
Sales Hub   Enterprise
Service Hub   Enterprise
Operations Hub   Enterprise
Content Hub   Enterprise

Los eventos personalizados te permiten definir y hacer un seguimiento de los eventos exclusivos de tu empresa. Los eventos personalizados pueden vincularse a propiedades de eventos, que luego puedes utilizar en todas las herramientas de HubSpot. 

Hay tres formas diferentes de crear eventos personalizados: 

  • Envío a través de la API: utiliza el punto final de definición de eventos personalizados para crear tu evento. A partir de ahí, utiliza el ID de tu evento con el send Custom event endpoint para enviar las finalizaciones de los eventos a HubSpot.
  • Captura datos de tu sitio web sin la API:
    • Código Javascript: utilizando Javascript Personalizado, puedes insertar código personalizado en tu script de seguimiento de HubSpot utilizando el editor de código.
    • Utilice el visualizador de eventos (sólo enMarketing Hub Enterprise ): realice un seguimiento de las páginas vistas o de los elementos en los que se ha hecho clic seleccionándolos en su sitio web. Más información sobre crear Eventos personalizados con el Visualizador de eventos.
  • Importar hoja de cálculo: carga una hoja de cálculo de datos de eventos para capturar la actividad sin conexión, rellenar datos o integrar manualmente cualquier herramienta con HubSpot.

 

Nota: la herramienta de eventos personalizados sustituye a la anterior herramienta heredada de eventos. 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 evento mediante API

Si envías datos a HubSpot a través de la API, tendrás que utilizar el punto final de definición de eventos personalizados para crear tu evento. A continuación, tendrás que definir la llamada a la API para activar el evento. Descubre cómo definir la llamada de tu API en la documentación de desarrollador 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.
  • Haz 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 Gestión de datos > Eventos personalizados.
  • Haz clic en Eventos personalizados.
  • Haga clic en el nombre del evento. Se te dirigirá a la página de detalles del evento.
  • En la parte superior, localiza 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.

Crea eventos con un fragmento de código Javascript

  • En tu cuenta de HubSpot, dirígete a Gestión de datos > Eventos personalizados.
  • En la parte superior derecha, haz clic en Crear un evento.
  • Selecciona Código Javascript.
código-javascript
  • Haz clic en Siguiente.
  • Introduce un nombre de Evento y opcionalmente proporciona la descripción de tu evento.
  • Selecciona un Objeto asociado. Esto te permite asociar las finalizaciones de tus eventos con diferentes objetos en HubSpot, incluyendo Contactos, Empresas, Negocios y Tickets
detalles-de-evento-personalizados

  • Haz clic en Siguiente.

Agregar propiedades

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 el 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 hayas terminado, haz clic en Crear para finalizar tu evento e iniciar automáticamente el seguimiento. 
    example-code-snippet-custom-event

Importar datos de eventos

Sube tus datos de asistencia de eventos presenciales, datos con marca de tiempo procedentes de aplicaciones que no integras con HubSpot, datos de clientes potenciales o campañas puntuales de un proveedor, o cualquier otro dato de eventos en forma de hoja de cálculo. Los eventos te permiten capturar comportamientos y utilizarlos en HubSpot. 

  • En tu cuenta de HubSpot, dirígete a Gestión de datos > Eventos personalizados.
  • En la parte superior derecha, haz clic en Crear un evento.
  • Selecciona Importar hoja de cálculo.
hoja de cálculo de importación
  • Haz clic en Siguiente.
  • Introduce un nombre de Evento y opcionalmente proporciona la descripción de tu evento.
  • Selecciona un Objeto asociado. Esto te permite asociar las finalizaciones de tus eventos con diferentes objetos en HubSpot, incluyendo Contactos, Empresas, Negocios y Tickets

detalles-de-evento-personalizados

  • Arrastra y suelta un archivo en la sección Elegir un archivo o haz clic en Elegir un archivo para subir un archivo desde tu ordenador. Cuando subas un archivo, debes incluir lo siguiente:

mismo-archivo-personalizado-de-eventos

Archivo de ejemplo

Nota: al importar datos de eventos, se aplican los siguientes límites:
  • Tu archivo debe ser de tipo csv, .xlsx o .xls 
  • Limitado a 1 millón de filas.
  • Por ahora, los eventos creados mediante importación sólo pueden asociarse a Contactos. 
  • Los eventos crearán y actualizarán los registros de contactos. Ea importación creará nuevos registros y actividades, así como identificará y actualizará los registros existentes. Para crear nuevos registros o actividades, tu archivo debe contener las propiedades necesarias para ese contacto. Para actualizar los registros existentes, tu archivo debe contener un identificador único .
  • La importación de eventos debe utilizarse para eventos que ya hayan ocurrido, no se admiten eventos con fechas futuras.

 

  • Haz clic en el menú desplegable para seleccionar el idioma de las cabeceras de tus columnas.
subir-hoja-de-comentarios-eventos
  • Haz clic en Siguiente.
  • En la pantalla Asignar columnas de tu archivo a propiedades de HubSpot, HubSpot asignará las columnas de tu archivo a las propiedades de contactos y eventos basándose en la cabecera, el idioma de la cabecera y el nombre de la propiedad.
  • La guía de mapeo muestra las propiedades necesarias para crear y/o actualizar los contactos y eventos. Si a tu archivo le falta alguna de las propiedades necesarias para completar el objetivo de tu importación, debes arreglar tu archivo de importación y reiniciar la importación para evitar errores.
  • Las columnas de tu hoja de cálculo pueden asignarse a las propiedades de los contactos o a las propiedades de los eventos. Haz clic en el menú desplegable Importar como para seleccionar cómo importar los datos del archivo. A continuación, selecciona la propiedad de HubSpot a la que quieres asignarla. Puedes asignarla a una propiedad existente o crear una nueva.
crear-nueva-propiedad
  • Haz clic en Siguiente.
  • Confirma el nombre de tu archivo de importación.
  • Haz clic en la casilla para aceptar que los contactos esperen recibir noticias tuyas y que tu archivo de importación no incluya una lista comprada. Más información sobre Política de uso aceptable de HubSpot.
  • Haz clic en el menú desplegable para seleccionar el formato de fecha de la propiedad Ocurrido en.
  • Haz clic en Finalizar importación.

Utilizar datos de eventos personalizados

Los datos de eventos personalizados se pueden ver y utilizar en todas 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.

Puedes abrir los eventos seleccionados directamente en determinadas herramientas de HubSpot con el menú desplegable de acciones de la lista de eventos, la vista de eventos individuales o la esquina superior derecha de los gráficos de la pestaña Analizar.

Informar sobre eventos personalizados

Las finalizaciones de eventos personalizados pueden analizarse desde la herramienta de eventos personalizados, y los datos de los eventos también estarán disponibles en el generador de informes personalizados y en los informes de atribución.

Más información sobre analizando tus eventos 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 a un registro de contacto que haya completado un evento personalizado.
  • Para filtrar una línea de tiempo de contactos por eventos completados, haz clic en Filtrar actividad, luego selecciona Evento personalizado.
  • En la cronología de contactos, haga clic para expandir el evento y mostrar los detalles del mismo.

Utilizar eventos personalizados en los workflows

En un workflow, puedes retrasar en función de la finalización de eventos personalizados utilizando una acción de Retrasar hasta que ocurra el evento o un activador de inscripción de eventos.

  • En tu cuenta de HubSpot, dirígete a Automatizaciones > Workflows.
  • Haz clic en el nombre de un workflow. O, aprende a crear un nuevo workflow.
  • Para añadir un activador:
    • En el editor del workflow, haz clic en Configurar activadores.
    • En el panel izquierdo, selecciona Cuando se produce un evento. Configura los activadores y luego haz clic en Aplicar filtro.
    • Para refinar aún más tu activador, haz clic en Añadir filtros de refinamiento. Puedes seleccionar propiedades adicionales para refinar los objetos que deseas inscribir en el workflow.
    • Por opción predeterminada, los registros solo se inscribirán en un workflow la primera vez que cumplen con los activadores de inscripción. Para activar la reinscripción, en la sección ¿Debe reinscribirse [objeto] en este workflow?, selecciona Sí, reinscribir cada vez que se produzca el desencadenante.
  • Para añadir un retraso:
    • 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, a continuación, selecciona un evento 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.

Nota: todos los activadores de inscripción de eventos se separarán utilizando el operador OR. Esto significa que sólo debe producirse uno de los eventos desencadenantes de la inscripción para que el registro se inscriba en el workflow.

A continuación, el workflow retrasará los registros inscritos hasta que cumplan los criterios de evento personalizados especificados o se activará cuando se produzca el evento.

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