Dashboard de diagnóstico de mensajería

El dashboard de diagnóstico de mensajería proporciona un desglose de alto nivel de los resultados del envío de mensajes, lo que te permite detectar tendencias y diagnosticar posibles problemas en tu configuración de mensajería. Este dashboard puede ayudarte a entender por qué los mensajes de tus campañas o Canvas pueden no haberse enviado como se esperaba.

Conceptos clave

Enviado y entregado

Es fundamental entender que este dashboard informa sobre cómo Braze procesó internamente un mensaje, no sobre el estado final de entrega del mensaje.

Un mensaje marcado como “enviado” en este dashboard significa que Braze procesó y despachó el mensaje con éxito. Para la mayoría de los canales, esto significa que Braze entregó el mensaje al socio de envío externo correspondiente. Sin embargo, no garantiza la entrega final al dispositivo del usuario.

Cuando Braze “envía” un mensaje, la entrega final puede depender de servicios externos. Considera los siguientes ejemplos para cada canal.

Canal	Ejemplo de entrega final
Tarjetas de contenido	La tarjeta fue enviada y es elegible para ser vista.
Correo electrónico	Braze entrega el mensaje a un proveedor de servicios de correo electrónico (ESP). El ESP es entonces responsable de la entrega final. Ese ESP, por ejemplo, puede reportar un “rebote” si la dirección de correo electrónico no es válida o el buzón de entrada está lleno.
Mensajes dentro de la aplicación	El mensaje fue mostrado al usuario.
LINE	El mensaje fue entregado con éxito a un socio de envío.
Push	Braze entrega el mensaje al servicio de notificaciones push correspondiente (como Apple Push Notification service para iOS o Firebase Cloud Messaging para Android). Ese servicio es responsable de la entrega final de la notificación al dispositivo.
SMS/MMS/RCS	Braze entrega el mensaje a una pasarela SMS (como Twilio). Esa pasarela es responsable de la entrega final al operador móvil.
Webhooks	La solicitud del webhook se realizó con éxito, devolviendo una respuesta 2xx.
WhatsApp	El mensaje fue entregado con éxito a un socio de envío.

Actualización de datos

La frecuencia con la que se actualizan los datos en este dashboard puede variar según la carga del sistema. Aunque la frecuencia de actualización no está garantizada, es probable que sea inferior a una hora en la mayoría de los casos.

Configurar el dashboard

Puedes acceder al dashboard de diagnóstico yendo a Análisis > Generador de dashboards y seleccionando Diagnóstico de mensajería de la lista de dashboards creados por Braze.

Para ejecutar el dashboard y ver tus datos:

1. Elige Campañas o Canvas como fuente para los informes de tu dashboard.
2. Selecciona una o más campañas o Canvas.
3. Selecciona Ejecutar dashboard para cargar los datos de los filtros seleccionados.

Interpretar los datos

Mosaicos de resumen

En la parte superior de la página, hay mosaicos de resumen clave para el período de tiempo seleccionado que muestran:

• Total de cancelaciones: El recuento total de mensajes que fueron cancelados. Esto incluye miembros de la audiencia de Canvas que no entraron al Canvas o salieron del Canvas porque experimentaron un fallo en un paso o cumplieron los criterios de salida al realizar un evento de salida.
• Envíos de mensajes: El recuento total de mensajes que Braze procesó y envió con éxito.
  • Correo electrónico, SMS/MMS/RCS, WhatsApp, LINE y push: El mensaje fue entregado con éxito a un socio de envío.
  • Webhooks: La solicitud del webhook se realizó con éxito, devolviendo una respuesta 2xx.
  • Tarjetas de contenido: La tarjeta fue enviada y es elegible para ser vista.
  • Mensajes dentro de la aplicación: El mensaje fue mostrado al usuario.

Resultados de mensajes a lo largo del tiempo

Este gráfico de series temporales muestra un desglose día a día de las diferentes razones por las que un mensaje fue cancelado o un usuario fue eliminado de un Canvas. Este gráfico no muestra el número de envíos.

Desglose de resultados de mensajes

Este gráfico muestra el desglose de todos los resultados de mensajes dentro del rango de tiempo seleccionado. Proporciona una imagen completa de:

• El número total de envíos como proporción de todos los resultados.
• El desglose proporcional de cada razón de cancelación y eliminación. Esto te ayuda a identificar rápidamente las razones más comunes por las que los mensajes no se están enviando.

Resultados de cancelación

Las siguientes definiciones explican los resultados de cancelación que se muestran en el dashboard. Los resultados están agrupados por categoría para facilitar la búsqueda del que estás investigando.

Contenido y renderizado

Resultado de cancelación	Explicación
Tarjeta de contenido expirada	La tarjeta de contenido expiró antes de que el usuario la viera.
Tarjeta de contenido no válida	La tarjeta de contenido tenía errores y no fue enviada al usuario. Algunas razones comunes incluyen: Se excedió el tamaño máximo (2 KB) La fecha de expiración no es válida El mensaje contiene caracteres no válidos
Fallo de contenido conectado	Braze intentó enviar el mensaje, pero el contenido conectado falló después del número máximo de reintentos (el predeterminado es cinco). Nota: Este recuento representa el número de mensajes cancelados por alcanzar el número máximo de reintentos, no el número total de solicitudes de contenido conectado fallidas.
Tiempo de espera de renderizado de mensaje dentro de la aplicación	Después de múltiples intentos de reintento, no se pudo renderizar el Liquid y se agotó el tiempo de espera.
Cancelación por Liquid	Se llamó a la etiqueta de Liquid abort_message, por lo que el envío fue cancelado.
Tiempo de espera de renderizado de Liquid	El renderizado de la plantilla de Liquid tardó demasiado. Es más probable que ocurra con banners, mensajes dentro de la aplicación y correo electrónico.
Error de sintaxis de Liquid	La plantilla de Liquid tenía un error de análisis, por lo que el mensaje fue cancelado.

Estado de campaña y Canvas

Resultado de cancelación	Explicación
Fallo en paso de retraso	El paso de retraso falló, causando que el usuario saliera del Canvas. Este fallo puede ocurrir cuando: La variable proporcionada al paso de retraso personalizado estaba vacía o era de un tipo no válido El retraso supera la duración máxima permitida dentro del Canvas
Evento de excepción o salida	El usuario era previamente elegible para recibir el mensaje, pero realizó un evento de excepción para una campaña basada en acciones, por lo que el mensaje fue cancelado, o cumplió los criterios de salida del Canvas, por lo que fue eliminado a mitad del recorrido.
Campaña inactiva	La campaña fue detenida mientras el mensaje estaba en tránsito, por lo que fue cancelado.
Canvas inactivo	El Canvas fue detenido antes de que el usuario entrara al recorrido.
Paso en Canvas inactivo	Esto puede ocurrir en el Canvas si: El paso en Canvas fue eliminado El Canvas fue detenido, lo que causa que todos los pasos se vuelvan inactivos
Límite de volumen alcanzado	La campaña alcanzó el límite de volumen establecido, por lo que el envío fue cancelado.

Limitación de velocidad y temporización

Resultado de cancelación	Explicación
Limitación de frecuencia	El usuario ya recibió el número máximo de mensajes permitidos según las reglas de limitación de frecuencia de tu espacio de trabajo, por lo que el envío fue cancelado.
Cancelación por horas tranquilas	Las horas tranquilas estaban habilitadas para la campaña o el paso en Canvas con la alternativa configurada como Cancelar mensaje. El usuario desencadenó la campaña o entró al paso de mensaje del Canvas durante las horas tranquilas, por lo que el mensaje fue cancelado. Sin embargo, esto no hace que el usuario salga del Canvas.
Límite de velocidad superado por más de 72 horas	El mensaje fue limitado durante más de 72 horas debido a los límites de velocidad de entrega, por lo que el envío fue cancelado.

Elegibilidad del usuario y perfil

Resultado de cancelación	Explicación
Identificador de usuario duplicado	Múltiples usuarios con un identificador coincidente (como ID externo, dirección de correo electrónico, número de teléfono) eran elegibles para recibir este mensaje. Para evitar envíos duplicados al mismo usuario, este mensaje fue cancelado.
El usuario no pasó la verificación previa para el paso de mensaje	Esta verificación previa se ejecuta antes de las validaciones de entrega. Cuando esto ocurre, el usuario no cumplió la verificación previa básica para este paso de mensaje (usuario no encontrado o no elegible para el canal del paso de mensaje). Nota: Para un paso de mensaje multicanal, esto significa que el usuario no fue encontrado; la elegibilidad del canal solo se verifica aquí para pasos de mensaje de un solo canal.
El usuario no pasó la verificación previa para mensaje desencadenado	Para un mensaje desencadenado, Braze ejecuta un primer conjunto de verificaciones previas básicas para la elegibilidad de la audiencia, la re-elegibilidad y la elegibilidad del canal antes de crear un mensaje para enviar desde este desencadenador.
El usuario ya no es elegible	El usuario estaba inicialmente en la audiencia objetivo, pero ya no cumplía los criterios de audiencia antes de que Braze enviara el mensaje o ingresara al usuario en el Canvas. El tiempo entre que el usuario cumplió inicialmente los criterios de audiencia y dejó de cumplirlos podría deberse a retrasos por: Intelligent Timing Horas tranquilas Hora local Límites de velocidad de entrega (no aplica para la entrada a Canvas) Retrasos en el pipeline de mensajería
El usuario no es elegible para el paso	El usuario salió del Canvas porque no cumplió las validaciones de entrega establecidas para el paso de mensaje o porque formaba parte de una lista de supresión.
El usuario no es re-elegible	El usuario era elegible para recibir el mensaje o entrar al Canvas, pero el envío fue cancelado debido a la configuración de re-elegibilidad o re-entrada. Esto puede ocurrir si el usuario ya recibió la campaña o entró al Canvas demasiado recientemente, si otro envío de la misma campaña ya está en curso para este usuario, o si la re-elegibilidad o re-entrada está desactivada.
Perfil de usuario no encontrado	El usuario nunca existió o ya no existe en Braze. Algunos casos comunes incluyen: El usuario fue dirigido usando mensajería por API, pero nunca existió en Braze. El usuario fue eliminado antes de que el mensaje fuera enviado o el paso en Canvas fuera ejecutado. El usuario fue fusionado con otro perfil antes de que el mensaje fuera enviado.

Canal y entrega

Resultado de cancelación	Explicación
Tiempo de espera de entrega del socio	Braze intentó enviar este mensaje a tu socio de entrega durante 24 horas, pero el socio devolvió errores temporales durante toda la ventana.
Credenciales push no válidas	Las credenciales push para esta aplicación faltan o no son válidas, por lo que el envío fue cancelado. Actualiza tus credenciales en Configuración de la aplicación.
El usuario no está habilitado para push de Android, aplicación o dispositivo	No se puede enviar push a este usuario. Algunas razones comunes: El usuario no tiene la aplicación instalada. El usuario no tiene un token de notificaciones push válido. El usuario no tiene el dispositivo necesario para esta notificación push. El usuario ha desactivado las notificaciones para esta aplicación en la configuración de su dispositivo. El usuario no está suscrito ni ha optado por recibir notificaciones push.
El usuario no está habilitado para push de iOS, aplicación o dispositivo	Igual que el resultado de cancelación “El usuario no está habilitado para push de Android, aplicación o dispositivo”.
El usuario no está habilitado para push de Kindle, aplicación o dispositivo	Igual que el resultado de cancelación “El usuario no está habilitado para push de Android, aplicación o dispositivo”.
El usuario no está habilitado para notificación push web, aplicación o dispositivo	Igual que el resultado de cancelación “El usuario no está habilitado para push de Android, aplicación o dispositivo”.
El usuario no está habilitado para Tarjetas de contenido	El usuario no ha utilizado ninguna aplicación que incluya esta tarjeta de contenido.
El usuario no está habilitado para correo electrónico	No se pueden enviar correos electrónicos a este usuario. Algunas razones comunes: El usuario no tiene una dirección de correo electrónico en su perfil de usuario. El estado de suscripción del usuario lo excluye de recibir este correo electrónico. La dirección de correo electrónico del usuario ha sido previamente marcada como no válida (rebote duro). Los mensajes enviados a esta dirección de correo electrónico son marcados consistentemente como correo no deseado, por lo que el envío fue cancelado.
El usuario no está habilitado para LINE	No se pueden enviar mensajes de LINE a este usuario. Algunas razones comunes: El usuario no tiene un número de teléfono en su perfil de usuario. El número de teléfono del usuario ha sido marcado como no válido debido a fallos de entrega. El estado de suscripción del usuario lo excluye de recibir este mensaje. El usuario no tiene un ID de LINE.
El usuario no está habilitado para SMS/MMS/RCS	No se pueden enviar mensajes SMS a este usuario. Algunas razones comunes: El usuario no tiene un número de teléfono en su perfil de usuario. El número de teléfono del usuario ha sido marcado como no válido debido a fallos de entrega. El número de teléfono del usuario no está en un formato E.164 válido, y los intentos de formatear automáticamente el número fallaron. El estado de suscripción del usuario lo excluye de recibir el mensaje SMS. El número de teléfono del usuario está en un país bloqueado.
El usuario no está habilitado para WhatsApp	No se pueden enviar mensajes de WhatsApp a este usuario. Algunas razones comunes: El usuario no tiene un número de teléfono en su perfil de usuario. El número de teléfono del usuario ha sido marcado como no válido debido a fallos de entrega. El estado de suscripción del usuario lo excluye de recibir este mensaje. El usuario no tiene una cuenta de WhatsApp.
Fallo del webhook	El webhook recibió un código de respuesta no exitoso (no 2xx). Consulta el Registro de actividad de mensajes para más detalles. Los registros con más de 60 horas de antigüedad se limpian y ya no son accesibles; los errores de webhook se muestrean hasta 20 registros por hora.

Preguntas frecuentes

¿Qué significa un fallo de “verificación previa”?

Una “verificación previa” se refiere a una comprobación de validación agrupada de alta velocidad que se ejecuta al inicio de una etapa del pipeline (como cuando se desencadena un mensaje o se envía un paso de mensaje de Canvas). Piensa en ella como una salida anticipada diseñada para máxima velocidad. En lugar de ejecutar muchas comprobaciones separadas que consumen muchos recursos (como validar cada detalle del perfil de un usuario), Braze agrupa varias validaciones básicas en un “primer paso”.

Si un usuario no pasa esta comprobación agrupada, es eliminado inmediatamente. Este enfoque agrupado permite a Braze procesar volúmenes masivos de mensajes a alta velocidad y puede contribuir a un rendimiento más rápido y estable para tus campañas y Canvas al reducir la latencia de procesamiento de cada mensaje.

¿Qué significa un resultado de cancelación “otro”?

Estas son cancelaciones que no encajaron en ninguna de las categorías preexistentes de Braze. Si notas una gran proporción de cancelaciones con este resultado, ponte en contacto con soporte de Braze para obtener más ayuda.

¿Por qué la suma de Total de cancelaciones y Envíos de mensajes es menor que el tamaño esperado de mi audiencia?

Esto puede ocurrir por varias razones:

• Criterios de audiencia: Menos usuarios de los esperados pueden haber cumplido los criterios de audiencia (por ejemplo, no estaban en el segmento o no tenían los atributos necesarios) cuando se lanzó la campaña o el Canvas.
• Procesamiento en curso: Los mensajes pueden estar aún procesándose activamente. Los usuarios pueden estar todavía en pasos anteriores del Canvas y no haber llegado a ningún paso de mensaje.
• Actualización de datos: Los datos del dashboard se actualizan aproximadamente cada 15 minutos, pero esto no está garantizado. Los datos más recientes para esta campaña o Canvas pueden no haber llegado al dashboard todavía.
• Casos límite: Existe una pequeña posibilidad de que estés encontrando un caso límite que no está capturado en este dashboard en este momento. Si sospechas que este es el caso, ponte en contacto con soporte de Braze.

¿Por qué la suma de Total de cancelaciones y Envíos de mensajes es mayor que la audiencia de una campaña y Canvas?

Esto puede ocurrir por las siguientes razones:

• Mensajes multicanal: La campaña o el paso en Canvas fue configurado para enviar en múltiples canales (como SMS y correo electrónico). Un solo usuario puede recibir un resultado de “enviado” para un canal (como correo electrónico) y un resultado de “cancelación” para otro (como “El usuario no está habilitado para SMS/MMS/RCS”). En este caso, ese usuario sería contado dos veces en el gráfico: una vez como “enviado” y otra como “cancelación”.
  • Ejemplo: Envías una campaña push a 100 usuarios, dirigida tanto a iOS como a Android. Si un usuario solo tiene un dispositivo iOS, recibe el push de iOS (“enviado”) pero también desencadena una cancelación para el push de Android (“El usuario no está habilitado para push de Android, aplicación o dispositivo”).
• Múltiples pasos de mensaje (solo Canvas): Tu Canvas puede tener más de un paso de mensaje en una ruta determinada. Este dashboard agrega todos los resultados, por lo que un solo usuario podría ser contado múltiples veces si pasa por múltiples pasos de mensaje dentro del rango de tiempo seleccionado.
• Mensajes de prueba: El envío de pruebas (que se cuenta en el dashboard) hace que los recuentos totales sean mayores que el tamaño de la audiencia.