Observabilidad de mensajería
La observabilidad de mensajería rastrea eventos a lo largo de tu Canvas o Campaign para que puedas auditar y solucionar problemas de mensajería. Úsala para detectar tendencias, ver cómo progresan los usuarios a través de un Canvas y diagnosticar por qué es posible que los mensajes no se hayan enviado como se esperaba.
Requisitos previos
Para acceder a Messaging Observability, necesitas el permiso “View Dashboard Reports” en tu espacio de trabajo.
Conceptos clave
Enviado y entregado
Este panel 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 panel significa que Braze procesó y despachó correctamente el mensaje. En 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 en el dispositivo del usuario.
Cuando Braze “envía” un mensaje, la entrega final puede depender de servicios externos. Ten en cuenta los siguientes ejemplos para cada canal.
| Canal | Ejemplo de entrega final |
|---|---|
| Banners | El Banner se envió y es elegible para visualizarse. |
| Content Cards | La tarjeta se envió y es elegible para visualizarse. |
| Correo electrónico | Braze entrega el mensaje a un proveedor de servicios de correo electrónico (ESP). A partir de ahí, el ESP es responsable de la entrega final. Ese ESP, por ejemplo, puede informar de 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 usuario vio el mensaje y se registró una impresión. |
| KakaoTalk | El mensaje se entregó correctamente a un partner de envío. |
| LINE | El mensaje se entregó correctamente 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 en el dispositivo. |
| SMS/MMS/RCS | Braze entrega el mensaje a una pasarela de SMS (como Twilio). Esa pasarela es responsable de la entrega final al operador móvil. |
| Webhooks | La solicitud de webhook se realizó correctamente y devolvió una respuesta 2xx. |
| El mensaje se entregó correctamente a un partner de envío. |
Eventos de progresión de Canvas
Para los Canvas, Messaging Observability también muestra eventos de progresión: registros de cómo se mueven los usuarios a lo largo del recorrido, como entrar en el Canvas, entrar en un paso o salir del Canvas. Los eventos de progresión son independientes de los resultados del envío de mensajes. Te ayudan a ver en qué punto del Canvas se encuentran los usuarios.
Actualización de los datos
La frecuencia con la que se actualizan los datos de este panel puede variar en función de la carga del sistema. Aunque la frecuencia de actualización no está garantizada, en la mayoría de los casos probablemente sea inferior a una hora.
Configurar el panel
Abre Messaging Observability desde cualquiera de estos lugares:
- Ve a Análisis > Generador de paneles y luego selecciona Messaging Observability en la lista de paneles creados por Braze.
- En una página de análisis de Canvas o de campaña, selecciona Messaging Observability. El panel se abre con ese Canvas o esa campaña preseleccionados cuando están disponibles.
Para ejecutar el panel y ver tus datos:
- Selecciona una fecha o un intervalo de fechas de hasta los últimos siete días.
- Selecciona Campaigns o Canvas como fuente para los informes de tu panel.
- Selecciona una campaña o un Canvas.
- (Opcional, solo para Canvas) Selecciona uno o varios pasos en Canvas para limitar los resultados a esos pasos.
- Selecciona Ejecutar panel para cargar los datos de los filtros seleccionados.
Después de cambiar cualquier filtro, vuelve a seleccionar Ejecutar panel para actualizar los mosaicos de resumen, el gráfico y el registro de eventos. Hasta que lo hagas, es posible que el panel muestre una advertencia de “Resultados obsoletos”.
Interpretar los datos
El panel muestra hasta los últimos siete días de datos. 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, los mosaicos de resumen del periodo seleccionado muestran:
- Entradas: Todas las entradas elegibles en Canvas o Campaign evaluadas en el intervalo de tiempo seleccionado. Estos recuentos pueden diferir ligeramente de la vista de análisis, porque Messaging Observability utiliza datos de solución de problemas procedentes de distintas fuentes.
- Supresiones: Mensajes que Braze decidió intencionadamente no enviar tras la entrada, por ejemplo por elegibilidad, limitación de frecuencia u horas tranquilas. Para más detalles, consulta Supresiones.
- Fallos: Mensajes que fallaron de forma inesperada, como errores de Liquid, de webhook o de push. Para más detalles, consulta Fallos.
- Enviados: Mensajes que salieron correctamente del procesamiento de Braze. Esto no garantiza la entrega al destinatario. La entrega depende del canal, el operador y el dispositivo. Para más detalles, consulta Enviados y entregados.
Eventos a lo largo del tiempo
Este gráfico de serie temporal muestra un desglose por horas de los eventos según los filtros seleccionados. Usa las vistas del gráfico para comparar los totales del resumen o para desglosar las supresiones y los fallos por resultado. Las etiquetas de resultado de este gráfico son etiquetas normalizadas del panel, no valores sin procesar de la carga útil del evento.
Registro de eventos
El Registro de eventos enumera los eventos individuales que Braze registró para cada usuario según los filtros y el intervalo de tiempo seleccionados, principalmente supresiones, progresiones y fallos. Úsalo para revisar registros concretos, incluidos la marca de tiempo, el ID de usuario, el paso en Canvas, el evento, la descripción y el canal de mensajería.
Filtra la tabla para centrarte en registros concretos:
- Selecciona categorías de eventos o eventos individuales en el filtro Eventos (por ejemplo, Supresiones > Limitado por frecuencia, o Progresiones > Entró en el paso).
- Introduce un ID de usuario en el campo de búsqueda para mostrar las filas de ese usuario.
Cuando aplicas ambos filtros, la tabla devuelve las filas que coinciden tanto con los eventos seleccionados como con el ID de usuario introducido.
Selecciona Ver en una fila para abrir un panel lateral con más contexto sobre ese evento. Desde el panel, también puedes seleccionar Preguntar a Operator para obtener orientación sobre cómo solucionarlo.
Los filtros de canal se aplican a los eventos vinculados a un canal de mensajería concreto. Algunos eventos no dependen del canal, por lo que pueden seguir apareciendo en las vistas agregadas incluso cuando aplicas un filtro de canal.
Eventos de progresión
Los eventos de progresión describen cómo avanzan los usuarios por un Canvas. Son exclusivos de Canvas. La entrada en Campaign aparece en Entradas como Entró en Campaign.
Las etiquetas de eventos de progresión de Messaging Observability son etiquetas del panel legibles para las personas. Los recuentos o los nombres pueden diferir de otras superficies de análisis de Braze, porque estos conjuntos de datos tienen representaciones y rutas de procesamiento distintas.
| Evento de progresión | Explicación |
|---|---|
| Entró en Canvas | El usuario entró en el Canvas. La entrada puede ser programada, basada en acciones o desencadenada por API. Los usuarios inscritos en un grupo de control también pueden aparecer con esta etiqueta. |
| Entró en el paso Rutas de Acción | El usuario entró en un paso de Rutas de Acción y tomó una ruta tras una acción (o la ruta de todos los demás). |
| Entró en el paso Agente | El usuario entró en un paso Agente en el que se evaluó el contexto. |
| Entró en el paso Rutas de audiencia | El usuario entró en un paso de Rutas de audiencia y tomó una ruta de audiencia (o la ruta de todos los demás). |
| Entró en el paso Sincronización de audiencias | El usuario entró en un paso de Sincronización de audiencias y comenzó la sincronización de la audiencia. |
| Entró en el paso Optimizador de contenido | El usuario entró en un paso de Optimizador de contenido y se seleccionó una variante. |
| Entró en el paso Contexto | El usuario entró en un paso de Contexto en el que se establecieron o evaluaron variables de contexto. |
| Entró en el paso División de decisiones | El usuario entró en un paso para la división de decisiones y tomó una rama. |
| Entró en el paso Retraso | El usuario entró en un paso de Retraso y está en espera, avanza de inmediato (por ejemplo, con un retraso de cero) o progresa de otro modo por ese paso. |
| Entró en el paso Recorrido de experimentos | El usuario entró en un paso de recorrido de experimentos y se le asignó una variante del experimento. |
| Entró en el paso Conmutador de características | El usuario entró en un paso de conmutador de características y se están evaluando los conmutadores de características. |
| Entró en el paso Mensaje | El usuario entró en un paso de Mensaje. Las supresiones, fallos o envíos posteriores de ese paso aparecen como eventos independientes. |
| Entró en el paso Enviar a destino | El usuario entró en un paso de Enviar a destino. Braze está comprobando si cumple los requisitos para entrar en el Canvas de destino. |
| Entró en el paso Actualización de usuario | El usuario entró en un paso de Actualización de usuario. Se están actualizando los atributos del usuario o este se retrasa temporalmente por el límite de velocidad de Actualización de usuario. |
| Enviado a destino | El usuario se envió al Canvas de destino y pasó al siguiente paso del Canvas actual. |
| No enviado a destino | El usuario no entró en el Canvas de destino (por ejemplo, porque no coincidía con la audiencia) y pasó al siguiente paso del Canvas actual. |
| Destino no encontrado | No se encontró el Canvas de destino. El usuario pasó al siguiente paso del Canvas actual. |
| Salió del Canvas | El usuario abandonó el Canvas. Esto ocurre cuando:
|
Supresiones
Las supresiones son ausencias de envío intencionadas tras la entrada, motivadas por la configuración, la elegibilidad o los controles de entrega.
Las etiquetas de supresión y de fallo de Messaging Observability son etiquetas del panel legibles para las personas. En los eventos de interacción con mensajes de Currents, la información de cancelación se representa con campos como abort_type y abort_log. Como estos conjuntos de datos tienen representaciones y rutas de procesamiento distintas, los recuentos o los nombres pueden diferir entre Currents y Messaging Observability.
Configuración de envío
| Supresión | Explicación |
|---|---|
| Cancelado por prioridad | El envío se canceló porque ya había pendiente otro mensaje con mayor prioridad para este usuario o porque se redujo la prioridad de este mensaje. |
| Banner caducado | El Banner caducó antes de poder enviarse. |
| Content Card caducada | La Content Card caducó antes de que el usuario la viera. |
| Variante del Optimizador de contenido desactivada | La asignación de la variante del Optimizador de contenido se desactivó antes del envío. |
| Limitado por frecuencia | El usuario ya había recibido el número máximo de mensajes permitido por las reglas de limitación de frecuencia de tu espacio de trabajo, por lo que se canceló el envío. |
| Campaign inactiva | La Campaign se detuvo mientras el mensaje estaba en curso, por lo que se canceló. |
| Canvas inactivo | El Canvas se detuvo antes de que el usuario entrara en el recorrido. |
| Paso en Canvas inactivo | Esto puede ocurrir en el Canvas si:
|
| Cancelación por horas tranquilas | Las horas tranquilas estaban habilitadas para la Campaign o el paso en Canvas con la alternativa establecida en Cancelar mensaje. El usuario desencadenó la Campaign o entró en el paso Mensaje del Canvas durante las horas tranquilas, por lo que se canceló el mensaje. Sin embargo, esto no hace que el usuario salga del Canvas. |
| Limitado por volumen | La Campaign o el Canvas alcanzó el límite de volumen establecido, por lo que se canceló el envío. |
Elegibilidad del usuario
| Supresión | Explicación |
|---|---|
| Identificador de usuario duplicado | Varios usuarios con un identificador coincidente (como el ID externo, la dirección de correo electrónico o el número de teléfono) eran elegibles para recibir este mensaje. Para evitar envíos duplicados al mismo usuario, se canceló este mensaje. |
| Evento de excepción o de salida | El usuario era elegible previamente para recibir el mensaje, pero
|
| El usuario no superó la comprobación previa del paso Mensaje | Braze ejecuta un primer conjunto de comprobaciones previas básicas de elegibilidad de audiencia, de reelegibilidad y de elegibilidad de canal antes de las validaciones de entrega completas de un paso Mensaje de Canvas. Este resultado significa que el usuario o el mensaje no superó una de esas comprobaciones, por lo que se canceló el mensaje en ese paso. |
| El usuario no superó la comprobación previa del mensaje desencadenado | Braze ejecuta un primer conjunto de comprobaciones previas básicas de elegibilidad de audiencia, de reelegibilidad y de elegibilidad de canal antes de crear un mensaje para enviar a partir de este desencadenante. Este resultado significa que el usuario o el mensaje no superó una de esas comprobaciones, por lo que se canceló el mensaje. |
| El usuario ya no es elegible | El usuario estaba inicialmente en el público objetivo, pero dejó de cumplir los criterios de audiencia antes de que Braze enviara el mensaje o lo hiciera entrar en el Canvas. El tiempo transcurrido entre que el usuario cumplió inicialmente los criterios de audiencia y salió de la audiencia puede deberse a retrasos por:
|
| El usuario no es elegible para el canal | El usuario no es elegible para recibir este mensaje en el canal seleccionado. Entre los motivos habituales se incluyen identificadores de canal ausentes o no válidos, ausencia de tokens de notificaciones push elegibles, restricciones por estado de suscripción, capacidad de canal no admitida o países bloqueados en los canales basados en teléfono. |
| El usuario no es elegible para el paso | El usuario no cumplió las validaciones de entrega establecidas para el paso Mensaje o formaba parte de una lista de supresión. Según la configuración de Validaciones de entrega, es posible que el usuario haya salido del Canvas o que haya avanzado al siguiente paso. |
| El usuario no es reelegible | El usuario era elegible para recibir el mensaje o entrar en el Canvas, pero el envío se canceló por la configuración de reelegibilidad o de reentrada. Esto puede ocurrir si el usuario ya recibió la Campaign o entró en el Canvas demasiado recientemente, si ya hay otro envío de la misma Campaign en curso para este usuario o si la reelegibilidad o la reentrada están desactivadas. |
Fallos
Los fallos son errores inesperados durante el procesamiento o los intentos de entrega.
| Fallo | Explicación |
|---|---|
| Fallo de contenido conectado | Braze intentó enviar el mensaje, pero el contenido conectado falló tras el número máximo de reintentos (cinco de forma predeterminada). 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. |
| Content Card no válida | La Content Card tenía errores y no se envió al usuario. Algunos motivos habituales son:
|
| Fallo en el paso Retraso | El paso Retraso falló, lo que hizo que el usuario saliera del Canvas. Este fallo puede producirse cuando:
|
| Cancelación por Liquid | Se llamó a la etiqueta de Liquid abort_message, por lo que se canceló el envío. |
| Tiempo de espera de renderizado de Liquid | La plantilla de Liquid tardó demasiado en renderizarse. 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 se canceló el mensaje. |
| Fallo de la URL multimedia | Braze no pudo procesar la URL multimedia del mensaje. Esto puede ocurrir cuando la URL está bloqueada, no es válida, agota el tiempo de espera, devuelve un estado HTTP no válido o no supera la validación SSL. |
| 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 todo ese periodo. |
| Recomendación de productos no válida | No se pudo usar la recomendación de productos o la selección del catálogo para este envío. Entre los motivos habituales se incluyen una recomendación ausente o archivada, un entrenamiento incompleto o filtros que eliminaron todos los artículos del catálogo. |
| Credenciales push no válidas | Las credenciales push de esta aplicación faltan o no son válidas, por lo que se canceló el envío. Actualiza tus credenciales en Configuración de la aplicación. |
| Límite de velocidad durante más de 72 horas | El mensaje se limitó durante más de 72 horas debido a los límites de velocidad de entrega, por lo que se canceló el envío. |
| Fallo del grupo de suscripción | No se pudo enviar el mensaje por problemas de configuración del grupo de suscripción o del servicio de mensajería. Entre los motivos habituales se incluyen la falta de números de envío para SMS o WhatsApp, o que el servicio de mensajería configurado no admita MMS. |
| Perfil de usuario no encontrado | El usuario nunca existió o ya no existe en Braze. Algunos casos habituales son:
|
| Fallo del webhook | El webhook recibió un código de respuesta fallido (distinto de 2xx). Los códigos de error habituales pueden ser errores de cliente 4XX, errores de servidor 5XX o de tiempo de espera, o 598 Host Unhealthy o solicitudes detenidas brevemente. |
| Otros | Fallos que no encajan en las demás categorías de esta tabla. Si observas una gran proporción de fallos de tipo Otros, ponte en contacto con el soporte de Braze para obtener más ayuda. |
Preguntas frecuentes
¿Qué significa un fallo de “comprobación previa”?
Una “comprobación previa” es una verificación de validación agrupada y de alta velocidad que se ejecuta al principio de una etapa de procesamiento (como cuando se desencadena un mensaje o se envía un paso de Mensaje en Canvas). Piensa en ella como una salida anticipada diseñada para lograr la 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 una única “primera pasada”.
Si un usuario no supera esta comprobación agrupada, se descarta de inmediato. 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 de tus Campaigns y Canvas, ya que reduce la latencia de procesamiento de cada mensaje.
¿Qué significa un fallo de tipo “Otro”?
Son fallos que no encajan en las categorías existentes del panel. Si sigues viendo una proporción elevada de fallos de tipo Otro, ponte en contacto con el soporte de Braze para obtener más ayuda.
¿Por qué la suma de Entradas, Supresiones, Fallos y Enviados no coincide con el tamaño de audiencia que esperaba?
Esto puede ocurrir por varios motivos:
- Criterios de audiencia: Es posible que menos usuarios de los esperados cumplieran los criterios de audiencia (por ejemplo, no estaban en el Segment o no tenían los atributos necesarios) cuando se lanzó la campaña o el Canvas.
- Procesamiento en curso: Es posible que los mensajes o los pasos en Canvas sigan procesándose activamente. Los usuarios pueden estar todavía en pasos anteriores del Canvas y no haber llegado a ningún paso de Mensaje.
- Progresión sin envío: Los usuarios pueden generar eventos de progresión (como entrar en un paso de Retraso o de División de decisiones) sin que haya una supresión, un fallo o un envío correspondiente en el mismo periodo.
- Actualización de los datos: Los datos del panel se actualizan aproximadamente cada 15 minutos, pero esto no está garantizado. Es posible que los datos más recientes de esta campaña o Canvas aún no hayan llegado al panel.
- Casos límite: Existe una pequeña posibilidad de que te encuentres ante un caso límite que este panel no recoge por el momento. Si sospechas que es así, ponte en contacto con el soporte de Braze.
¿Por qué los totales de los mosaicos o del registro de eventos pueden ser mayores que la audiencia de una campaña o Canvas?
Esto puede ocurrir por los siguientes motivos:
- Mensajes multicanal: La campaña o el paso en Canvas se configuró para enviar por varios canales (como SMS y correo electrónico). Un mismo usuario puede recibir un resultado de “enviado” en un canal (como el correo electrónico) y una supresión o un fallo en otro (como “Usuario no elegible para el canal”). En este caso, ese usuario se cuenta más de una vez entre los mosaicos y el registro de eventos.
- Por 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 la notificación push de iOS (“enviado”), pero también desencadena una supresión para la notificación push de Android (“Usuario no elegible para el canal”).
- Varios pasos de Mensaje (solo Canvas): Tu Canvas puede tener más de un paso de Mensaje en una misma ruta. Este panel agrega todos los eventos, así que un mismo usuario podría contarse varias veces si pasa por varios pasos dentro del intervalo de tiempo seleccionado.
- Mensajes de prueba: Los envíos de prueba (que se cuentan en el panel) pueden hacer que los totales superen el tamaño de la audiencia.