Rastrear eventos en Intercom te brinda una mejor comprensión de cómo tus clientes usan tu producto. Esta comprensión te permite enviar mensajes dirigidos y relevantes y te da todo el contexto necesario para apoyar a tus clientes.
Intercom rastrea algunos eventos por defecto, como vistas de página e interacciones con tu Help Center, este artículo trata sobre rastrear tus propios eventos personalizados.
Hay muchas formas de enviar eventos a Intercom:
A través de nuestros SDKs móviles.
Metadatos del evento
Cada evento que rastrees también puede incluir metadatos. Esta es información adicional sobre cada ocurrencia específica del evento. Por ejemplo: si rastreas un evento de “purchase”, los metadatos podrían ser el nombre y precio del artículo comprado.
Cada evento puede enviarse con hasta veinte piezas de metadatos. Se admiten los siguientes tipos de datos:
Cadena: Una cadena simple de hasta 255 caracteres.
Número: Número positivo o negativo.
Enlace: Una URL http o https, a la que crearemos un enlace.
Enlace enriquecido: Un enlace http o https, también enviado con un título, al que crearemos un enlace.
Imagen: Un enlace http o https a una imagen, que mostraremos.
Stripe (retail): Un identificador de factura, cliente o cargo de Stripe, al que crearemos un enlace.
Monetario (retail): Una cantidad con una moneda.
Importante:
Los nombres de las claves no distinguen mayúsculas de minúsculas y no pueden contener puntos ('.'), signos de dólar ('$'), caracteres como ~`!@#%^&*'{}|\'" o el carácter NULL.
Los guiones en los nombres de las claves no se muestran en Intercom. La clave sigue siendo importante para rastrear datos, mientras que 'invited-friend' y 'invited friend' se mostrarán ambos como Invitado amigo en la interfaz, los dos campos representan datos diferentes.
Sigue leyendo para aprender cómo enviar eventos con cada método. O, salta a esta visión general de rastrear un evento de principio a fin.
La API de JavaScript de Intercom
Con el fragmento de JavaScript de Intercom instalado en tu app o en tu sitio web, puedes enviar eventos cuando tus users o visitantes realizan acciones.
Usa el método Intercom(‘trackEvent’). Esto asocia automáticamente el evento con el visitante, lead o user actualmente rastreado y lo envía a Intercom. Un evento simple se vería así:
Esto se rastrearía así:
Intercom('trackEvent', ‘upload-complete');
Opcionalmente, también puedes incluir metadatos con el evento para una segmentación más granular de mensajes basados en eventos y su inclusión en el contenido del mensaje:
Este evento con metadatos:
var metadata = {
duration: 19,
type: "JPEG",
file_location: "https://external-content.com/example.jpg"
};
Intercom('trackEvent', 'upload-complete');
Nota: Para rastrear eventos con la API de JavaScript, debes asegurarte de que el fragmento de JavaScript de Intercom ya se haya cargado correctamente en la página.
Para instalar Intercom, copia el primer fragmento de código en la configuración de instalación web, que está prellenado con tu workspace ID. Luego pega el código justo antes de la etiqueta de cierre <body/> de cualquier página donde quieras rastrear eventos.
Google Tag Manager
Si has instalado Intercom con Google tag manager, puedes usarlo para rastrear eventos personalizados, como este ejemplo de nuestro artículo de ayuda, que rastrea un evento para “Exit intent”. Esto es perfecto para mensajes que quieres enviar a los visitantes de tu sitio, como ejemplo.
Directamente a través de la REST API
Puedes rastrear eventos directamente a través de la REST API, usando el lenguaje de tu elección o uno de nuestros SDKs soportados:
Al rastrear un evento con la REST API, también puedes especificar un tiempo “created_at” para definir específicamente cuándo ocurrió, lo que te permite “ponerte al día” con eventos que ocurrieron en el pasado.
Consulta nuestra documentación de la API para más detalles.
Nota: Los eventos rastreados vía la API no activarán Banners ni Carruseles. Para estos tipos de mensajes, recomendamos usar la api de JavaScript o uno de nuestros SDKs móviles.
Desde tu app móvil usando uno de nuestros SDKs móviles
Puedes usar cualquiera de nuestros SDKs móviles para configurar el seguimiento de eventos:
Con una app como Segment o Stripe.
Varias apps de nuestra app store rastrearán eventos por ti en Intercom. Por ejemplo, la app de Stripe rastreará eventos de suscripción como pagos recientes. Esto es perfecto para enviar mensajes de notificación sobre la actividad de la cuenta.
Seguimiento de eventos en acción
Para este ejemplo, rastrearemos un evento con la API de JavaScript cada vez que se complete una carga de un cliente, luego les enviaremos un mensaje cada vez que eso ocurra.
Primero, el código que necesitamos:
Este JavaScript rastrea un evento llamado “Upload complete” e incluye:
La ubicación del archivo - “/example.jpg”
El tipo - “JPEG”
Y cuánto tiempo tomó subirlo (en minutos) - 19
Ahora cada vez que se rastrea el evento, es visible en estos lugares:
El perfil del user.
En el Help Desk (eventos recientes).
En tus filtros de mensajes.
Filtros en la lista de contactos.
Nota: Cuando alguien te contacta por primera vez y se agrega como lead en Intercom, puedes ver cualquier evento que hayan rastreado como visitante en los últimos 90 días antes de ponerse en contacto.
Desde Configuración > Datos > Personas y bajo la pestaña Eventos, agregaremos una descripción al evento para que sea muy claro para todos nuestros compañeros qué representa:
Ahora con el evento rastreado con éxito, podemos usar mensajes basados en eventos para enviarles un banner de notificación cada vez que ocurra. Lee este artículo para aprender todo sobre mensajes basados en eventos.
¿Cómo elimino eventos?
Desde la configuración de eventos de tu workspace, abre el evento y haz clic en 'Archivar':
Siempre puedes desarchivar un evento más tarde si cambias de opinión, pero los eventos archivados no se recrean si los rastreas de nuevo.
A continuación hay un ejemplo de cómo configurar un Enlace enriquecido:
var metadata = {
order_number: {url: "https://example.com/tx186373", value: "TX186373"},
};
Intercom('trackEvent', 'order', metadata);En el ejemplo anterior estamos enviando el enlace https://example.com/tx186373 en los metadatos para el evento 'order' con un título que creará un enlace a la URL que enviaste.
Cuando se envía el evento anterior para un user en particular, verán el atributo order_number con un valor de TX186373, pero el enlace estará incrustado en ese valor.
Mejores prácticas para capturar eventos
Los eventos son más útiles para filtrar y segmentar a tus users, y enviar mensajes dirigidos a tus clientes.
Con eso en mente, tenemos algunas recomendaciones sobre cómo sacar el máximo provecho de los eventos:
Envía eventos que capturen acciones significativas. Una compra es una gran base para una conversación en lugar de registrar todos los clics que llevan a esa compra. Los eventos significativos también facilitarán la creación de filtros y mensajes automáticos.
Envía la cantidad correcta de metadatos. Los metadatos son una excelente manera de contextualizar la actividad, pero enviar demasiado puede ser una distracción. Recuerda que siempre puedes vincular a tus propios sistemas para más detalles.
Formatea tus metadatos como si fueran a enviarse a un cliente. Los metadatos no se formatean cuando se incluyen en tus mensajes, por lo que deben estar listos para cuando Intercom los reciba.
Usa eventos para entender las interacciones entre users como invitaciones y actividad social. Puedes usar metadatos para proporcionar una vista detallada de cómo los users interactúan con tu negocio y entre ellos.
Nombra tus eventos de manera que sean fácilmente legibles en Intercom. Usar un verbo en pasado es una forma de hacer que la acción sea más fácil de entender cuando aparece en la línea de tiempo de actividad del user, por ejemplo, “Compró artículo”, “Creó perfil” o “Vio guía de incorporación”.