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.
El dashboard de diagnóstico de mensajería está disponible de forma general. Ponte en contacto con tu administrador de éxito de cliente si te interesa obtener acceso a esta característica.
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 partner 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 |
|---|---|
| Content Cards | 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. |
| In-App Messages | El mensaje fue visto por el usuario y se registró una impresión. |
| LINE | El mensaje fue entregado con éxito a un partner 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. |
| El mensaje fue entregado con éxito a un partner 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 Analytics > Dashboard Builder y seleccionando Messaging Diagnostics de la lista de dashboards creados por Braze.
Para ejecutar el dashboard y ver tus datos:
- Elige Campaigns o Canvases como fuente para los informes de tu dashboard.
- Selecciona una o más campañas o Canvas.
- Selecciona Run Dashboard para cargar los datos de los filtros seleccionados.
Interpretar los datos
El dashboard muestra solo los últimos siete días de datos como máximo. Todas las marcas de tiempo se muestran en la zona horaria de tu espacio de trabajo.
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:
- Sent: 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 partner de envío.
- Webhooks: La solicitud del webhook se realizó con éxito, devolviendo una respuesta
2xx. - Content Cards: La tarjeta fue enviada y es elegible para ser vista.
- In-App Messages: El mensaje fue mostrado al usuario.
- Not Sent: 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.
Resultados de mensajes a lo largo del tiempo
Este gráfico de series temporales muestra un desglose por hora de las razones por las que un mensaje fue cancelado o un usuario fue eliminado de un Canvas. Las etiquetas de resultados en este gráfico son etiquetas normalizadas del dashboard, no valores sin procesar de la carga útil del evento. Este gráfico no muestra el número de envíos.
Registro granular de resultados de mensajes
El dashboard muestra una tabla granular de resultados individuales de mensajes para los filtros y el rango de tiempo seleccionados. Usa esta tabla para revisar registros específicos, incluyendo la marca de tiempo, el ID de usuario, el paso en Canvas, el resultado, los detalles y el canal.
Puedes filtrar la tabla para enfocarte en registros específicos:
- Filtrar por resultado: Selecciona un resultado del filtro de resultados para mostrar solo las filas con ese resultado (por ejemplo,
Frequency cappedoUser not eligible for channel). - Buscar por ID de usuario: Ingresa un ID de usuario en el campo de búsqueda para mostrar las filas de ese usuario específico.
Cuando aplicas ambos filtros, la tabla devuelve las filas que coinciden tanto con el resultado seleccionado como con el ID de usuario ingresado.
Selecciona una fila en la tabla para abrir el panel de detalles. El panel de detalles proporciona contexto adicional sobre ese resultado, y Ask Operator ofrece orientación de corrección para ayudarte a solucionar el problema subyacente.
Los filtros de canal se aplican a resultados que están vinculados a un canal de mensajería específico. Algunos resultados son independientes del canal, por lo que pueden seguir apareciendo en vistas agregadas incluso cuando aplicas un filtro de canal.
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.
Los resultados de cancelación en el diagnóstico de mensajería son etiquetas legibles del dashboard. En los eventos de participación de mensajes de Currents, la información de cancelación se representa con campos como abort_type y abort_log. Debido a que estos conjuntos de datos tienen representaciones y rutas de procesamiento diferentes, los recuentos o la nomenclatura pueden diferir entre Currents y el diagnóstico de mensajería.
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:
|
| 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. |
| Fallo de URL de medios | Braze no pudo procesar la URL de medios en el mensaje. Esto puede ocurrir cuando la URL está bloqueada, no es válida, se agota el tiempo de espera, devuelve un estado HTTP no válido o falla la validación SSL. |
Estado de Campaign 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:
|
| Evento de excepción o salida | El usuario era previamente elegible para recibir el mensaje, pero
|
| 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:
|
| 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 Abort message. 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 | 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 las validaciones de entrega completas para un paso de mensaje de Canvas. Este resultado significa que el usuario o el mensaje no pasó una de esas verificaciones, por lo que el mensaje fue cancelado para ese paso. |
| El usuario no pasó la verificación previa para 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. Este resultado significa que el usuario o el mensaje no pasó una de esas verificaciones, por lo que el mensaje fue cancelado. |
| El usuario ya no es elegible | El usuario estaba inicialmente en el público 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:
|
| El usuario no es elegible para el paso | El usuario no cumplió las validaciones de entrega establecidas para el paso de mensaje o formaba parte de una lista de supresión. Dependiendo de la configuración de Delivery validations, el usuario puede haber salido del Canvas o avanzado al siguiente paso. |
| 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:
|
Canal y entrega
| Resultado de cancelación | Explicación |
|---|---|
| Error de entrega del partner | Braze intentó enviar este mensaje a tu partner de entrega durante 24 horas, pero el partner 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. |
| Fallo del grupo de suscripción | El mensaje no pudo ser enviado debido a problemas de configuración del grupo de suscripción o del servicio de mensajería. Las razones comunes incluyen números de envío faltantes para SMS o WhatsApp, o MMS no compatible en el servicio de mensajería configurado. |
| El usuario no es elegible para el canal | El usuario no es elegible para recibir este mensaje en el canal seleccionado. Las razones comunes incluyen identificadores de canal faltantes o no válidos, ausencia de tokens de notificaciones push elegibles, restricciones de estado de suscripción, capacidad de canal no compatible o países bloqueados para canales basados en teléfono. |
| Fallo del webhook | El webhook recibió un código de respuesta no exitoso (no 2xx). Los códigos de error comunes pueden ser errores de cliente 4XX, errores de servidor o tiempo de espera 5XX, o 598 Host Unhealthy o solicitudes detenidas brevemente. |
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 encajan en las categorías existentes del dashboard. Si notas una gran proporción de cancelaciones con “otro”, ponte en contacto con soporte de Braze para obtener más ayuda.
¿Por qué la suma de Not Sent y Sent 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 Not Sent y Sent es mayor que la audiencia de una campaña o un 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 es elegible para el canal”). 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 es elegible para el canal”).
- 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.