Saltar al contenido principal
Este documento explica las capacidades y el uso de nuestros eventos de Mensajes Dentro de la Aplicación. Puedes rastrear estadísticas de engagement esenciales cada vez que un usuario hace clic o visualiza estos mensajes, incluyendo clics a nivel de bloque y visualizaciones específicas de página.

​
Eventos de mensajes dentro de la aplicación

Hay tres tipos event.kind de Eventos de Mensajes Dentro de la Aplicación:
  • Impresión dentro de la aplicación - message.iam.impression
  • Clic dentro de la aplicación - message.iam.clicked
  • Página dentro de la aplicación mostrada - message.iam.page_displayed
Estos eventos se disparan cuando un usuario abre e interactúa con un mensaje dentro de la aplicación en el dispositivo.

​
Impresión dentro de la aplicación

Este evento se dispara tan pronto como el mensaje termina de cargar y se muestra en pantalla. Cuando se usan carruseles, puedes obtener el nombre y UUID de la página específica que se muestra usando event.data.page_name y event.data.page_id.

​
Clic dentro de la aplicación

Este evento es aplicable a cualquier elemento o bloque con una acción de clic (también referido como “target” u objetivo). Puedes obtener el nombre y UUID del objetivo específico en el que se hizo clic usando event.data.target_name y event.data.target_id, así como la página a la que pertenece el objetivo usando event.data.page_name y event.data.page_id. Ve Acciones de clic dentro de la aplicación para más detalles.

​
Página dentro de la aplicación mostrada

Este es un evento que solo es aplicable a carruseles. Puedes obtener el nombre y UUID de la página o tarjeta específica que se muestra usando event.data.page_name y event.data.page_id. La impresión para la primera tarjeta se dispara tan pronto como el documento termina de cargar. Las impresiones de páginas subsiguientes se disparan al deslizar.

​
Datos de eventos de mensajes dentro de la aplicación

Cada event.kind puede tener datos de eventos adicionales dependiendo de cómo crees el mensaje dentro de la aplicación.
​
event.data.page_name
string
El nombre de la página o tarjeta que se muestra cuando el event.kind es clicked o page_displayed. No disponible para eventos de impression.El page_name es útil para saber qué página se mostró y en qué se hizo clic en esa página.Los nombres de páginas tienen como valor predeterminado “Card 1”, “Card 2”, etc. pero puedes cambiar los nombres dentro del Editor de Bloques.
​
event.data.page_id
string UUID v4
Un identificador único para la página. Útil para casos de uso de un carrusel y una tarjeta antigua se elimina o reemplaza con una nueva tarjeta.
​
event.data.target_name
string
El nombre del botón o elemento de bloque de imagen. Debes configurar acciones de clic.
​
event.data.target_id
string UUID v4
Un identificador único para el botón o elemento de bloque de imagen. Debes configurar acciones de clic. Esto es útil cuando se usa un carrusel y una tarjeta antigua se elimina o reemplaza con una nueva tarjeta.

​
Crea tu Flujo de Eventos de mensajes dentro de la aplicación

​
Configurar flujos de eventos

Revisa las instrucciones de Configuración de Flujo de Eventos para orientación sobre cómo configurar y personalizar tu flujo de eventos. Lo siguiente proporciona pasos específicos de IAM para configurar tu flujo de eventos (paso 3).

​
Asegúrate de que el objetivo que deseas rastrear esté configurado correctamente

Para aprovechar los nombres personalizados en el cuerpo de una solicitud de flujos de eventos, debes especificar manualmente un nuevo nombre personalizado en el Editor de Bloques o HTML. Los Mensajes Dentro de la Aplicación que han existido antes del lanzamiento de nombres personalizados no podrán exponer valores de page_name y target_name en el flujo de eventos hasta que el Dentro de la Aplicación se actualice con nombres personalizados para cada página o bloque. Después de que el Dentro de la Aplicación se haya actualizado, las solicitudes de flujo de eventos que se activen a partir de ese momento tendrán acceso a esos valores. En cualquier momento dado, los valores de page_name y target_name reflejarán el estado de nombres personalizados del Dentro de la Aplicación en ese momento, que puede cambiar si el Dentro de la Aplicación se actualiza nuevamente.
  • Editor de bloques
  • Editor HTML
Los tres eventos se pueden usar con este editor. Cuando uses el editor de bloques, asegúrate de que el objetivo contenga una acción de clic dentro de la aplicación. Un objetivo incluye imágenes, botones, el botón de cerrar y el bloque de fondo. Los bloques de texto actualmente no admiten acciones de clic y no están incluidos.Los nombres personalizados de objetivos deben ser únicos para evitar confusión en la experiencia del panel.

​
Utilizar IDs únicos

Mejor Práctica: Cuando uses Flujos de Eventos para propósitos de análisis, usa message.id, page_id y target_id para validar unicidad. Los nombres personalizados se pueden usar, pero están destinados a ayudar a diferenciar entre elementos en un IAM en un formato legible para humanos. Si tienes múltiples mensajes dentro de la aplicación, usa message.id para diferenciarlos.

​
Usar nombres claros en el editor de bloques

Usa nombres significativos y únicos para todos los títulos, tarjetas y bloques de mensajes dentro de la aplicación para simplificar el análisis de datos. Para renombrar una tarjeta en un carrusel, selecciona la pestaña que deseas actualizar y selecciona el menú desplegable “Opciones” junto a las pestañas de tarjetas. Verás una opción para renombrar la tarjeta. Para renombrar un bloque, selecciona el menú de opciones de tres puntos en la esquina superior derecha de cada bloque para abrir el modal de renombrado. Todos los nombres personalizados se reflejarán en el informe del panel y el flujo de eventos, si es aplicable. Los nombres personalizados no aparecerán en los flujos de eventos a menos que estén configurados y guardados. Si tienes IAMs activos y recientemente configuraste un nuevo flujo de eventos de IAM, querrás asegurarte de que estos IAMs tengan nombres personalizados significativos para un análisis más limpio.