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 los usuarios progresan a través de un Canvas y diagnosticar por qué los mensajes pueden no haberse enviado como se esperaba.
Para acceder a Observabilidad de mensajería, necesitas el permiso de usuario “View Dashboard Reports” para tu espacio de trabajo.
Conceptos clave
Enviados y entregados
Este panel informa sobre cómo Braze procesó internamente un mensaje, no sobre el estado de entrega final del mensaje.
Un mensaje marcado como “enviado” en este panel significa que Braze procesó y despachó correctamente el mensaje. 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 su visualización. |
| 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 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 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ó correctamente, devolviendo una respuesta 2xx. |
| El mensaje fue entregado correctamente a un partner de envío. |
Eventos de progresión en Canvas
Para Canvas, Messaging Observability también muestra eventos de progresión: registros de cómo los usuarios avanzan a través 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 de envío de mensajes. Te ayudan a ver dónde se encuentran los usuarios dentro del Canvas.
Actualización de los datos
La frecuencia con la que se actualizan los datos en este panel puede variar según la carga del sistema. Si bien la frecuencia de actualización no está garantizada, es probable que sea inferior a una hora en la mayoría de los casos.
Configura el panel
Abre Messaging Observability desde cualquiera de estos lugares:
- Ve a Analytics > Dashboard Builder y selecciona Messaging Observability en la lista de paneles creados por Braze.
- En la página de análisis de un Canvas o Campaign, selecciona Messaging Observability. El panel se abre con ese Canvas o Campaign preseleccionado cuando está disponible.
Para ejecutar el panel y ver tus datos:
- Selecciona una fecha o un rango de fechas de hasta los últimos siete días.
- Selecciona Campaigns o Canvases como la fuente de los informes de tu panel.
- Selecciona un Campaign o Canvas.
- (Opcional, solo Canvas) Selecciona uno o más pasos en Canvas para limitar los resultados a esos pasos.
- Selecciona Run dashboard para cargar los datos de los filtros seleccionados.
Después de cambiar cualquier filtro, selecciona Run dashboard de nuevo para actualizar los mosaicos de resumen, el gráfico y el registro de eventos. Hasta que lo hagas, el panel puede mostrar una advertencia de “Outdated results”.
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 para el período de tiempo seleccionado muestran:
- Entradas: Todas las entradas elegibles de Canvas o Campaigns 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 de diferentes fuentes.
- Supresiones: Mensajes que Braze intencionalmente no envió después de la entrada, como por elegibilidad, limitación de frecuencia u horas tranquilas. Para más información, consulta Supresiones.
- Fallos: Mensajes que fallaron inesperadamente, como errores de Liquid, webhook o push. Para más información, 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 información, consulta Enviados y entregados.
Eventos a lo largo del tiempo
Este gráfico de series temporales muestra un desglose por hora de los eventos para 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 en 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 específicos, 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 específicos:
- Selecciona categorías de eventos o eventos individuales desde 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 ingresado.
Selecciona Ver en una fila para abrir un panel lateral con más contexto sobre ese evento. Desde el panel, también puedes seleccionar Ask Operator para obtener orientación sobre la corrección.
Los filtros de canal se aplican a eventos vinculados a un canal de mensajería específico. Algunos eventos son independientes 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 los usuarios se mueven a través de un Canvas. Son exclusivos de Canvas. La entrada a una Campaign aparece en Entradas como Entró en Campaign.
Las etiquetas de eventos de progresión en Messaging Observability son etiquetas legibles del panel. Los recuentos o la nomenclatura pueden diferir de otras superficies de análisis de Braze porque estos conjuntos de datos tienen representaciones y rutas de procesamiento diferentes.
| Evento de progresión | Explicación |
|---|---|
| Entró en Canvas | El usuario entró en el Canvas. La entrada puede ser programada, basada en acciones o activada por API. Los usuarios inscritos en un grupo de control también pueden aparecer bajo 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 después de una acción (o la ruta de todos los demás). |
| Entró en el paso Agente | El usuario entró en un paso de Agente donde se evaluó el contexto. |
| Entró en el paso Ruta de audiencia | El usuario entró en un paso de ruta de audiencia y tomó una ruta de audiencia (o la ruta de todos los demás). |
| Entró en el paso Audience Sync | El usuario entró en un paso de Audience Sync y se inició la sincronización de audiencia. |
| Entró en el paso Content Optimizer | El usuario entró en un paso de Content Optimizer y se seleccionó una variante. |
| Entró en el paso de contexto | El usuario entró en un paso de contexto donde se establecieron o evaluaron variables de contexto. |
| Entró en el paso de división de decisiones | El usuario entró en un paso de división de decisiones y tomó una rama. |
| Entró en el paso de demora | El usuario entró en un paso de demora y está esperando, avanzando inmediatamente (por ejemplo, una demora de cero) o progresando de otro modo a través de ese paso. |
| Entró en el paso de recorrido de experimentos | El usuario entró en un paso de recorrido de experimentos y fue asignado a una variante del experimento. |
| Entró en el paso de 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 de mensaje | El usuario entró en un paso de mensaje. Las supresiones, fallos o envíos posteriores para ese paso aparecen como eventos separados. |
| Entró en el paso de enviar a destino | El usuario entró en un paso de enviar a destino. Braze está verificando si califica para entrar en el Canvas de destino. |
| Entró en el paso de actualización de usuario | El usuario entró en un paso de actualización de usuario. Se están actualizando los atributos del usuario, o el usuario está temporalmente demorado por la limitación de velocidad de actualización de usuario. |
| Enviado al destino | El usuario fue enviado al Canvas de destino y avanzó al siguiente paso en el Canvas actual. |
| No enviado al destino | El usuario no entró en el Canvas de destino (por ejemplo, debido a una falta de coincidencia de audiencia) y avanzó al siguiente paso en el Canvas actual. |
| Destino no encontrado | No se encontró el Canvas de destino. El usuario avanzó al siguiente paso en el Canvas actual. |
| Salió del Canvas | El usuario dejó el Canvas. Esto ocurre cuando:
|
Supresiones
Las supresiones son no envíos intencionales después de la entrada, impulsados por la configuración, la elegibilidad o los controles de entrega.
Las etiquetas de supresión y fallo en Messaging Observability son etiquetas legibles del panel. 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. Dado que estos conjuntos de datos tienen representaciones y rutas de procesamiento diferentes, los recuentos o la nomenclatura pueden diferir entre Currents y Messaging Observability.
Configuración de envío
| Supresión | Explicación |
|---|---|
| Cancelado por prioridad | El envío fue cancelado porque otro mensaje de mayor prioridad para este usuario ya estaba pendiente, o este mensaje fue despriorizado. |
| Banner expirado | El Banner expiró antes de que pudiera ser enviado. |
| Content Card expirada | La Content Card expiró antes de que el usuario la viera. |
| Variante de Content Optimizer desactivada | La asignación de variante de Content Optimizer fue desactivada antes del envío. |
| Limitado por frecuencia | El usuario ya recibió la cantidad máxima de mensajes permitida según las reglas de limitación de frecuencia de tu espacio de trabajo, por lo que el envío fue cancelado. |
| Campaign inactiva | La Campaign 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 en el recorrido. |
| Paso de Canvas inactivo | Esto puede ocurrir en el Canvas si:
|
| Cancelado por horas tranquilas | Las horas tranquilas estaban habilitadas para la Campaign o el paso de Canvas con la alternativa configurada como Cancelar mensaje. El usuario activó la Campaign o entró en el paso de mensaje del Canvas durante las horas tranquilas, por lo que el mensaje fue cancelado. Sin embargo, esto no saca al usuario del Canvas. |
| Limitado por volumen | La Campaign o el Canvas alcanzó el límite de volumen establecido, por lo que el envío fue cancelado. |
Elegibilidad del usuario
| Supresión | Explicación |
|---|---|
| Identificador de usuario duplicado | Varios usuarios con un identificador coincidente (como ID externo, dirección de correo electrónico o número de teléfono) eran elegibles para recibir este mensaje. Para evitar envíos duplicados al mismo usuario, este mensaje fue cancelado. |
| Evento de excepción o salida | El usuario era previamente elegible para recibir el mensaje, pero:
|
| El usuario no pasó la verificación previa del paso de mensaje | Braze ejecuta un primer conjunto de verificaciones previas básicas de elegibilidad de audiencia, reelegibilidad y elegibilidad de canal antes de las validaciones completas de entrega para un paso de mensaje del 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 del mensaje desencadenado | Braze ejecuta un primer conjunto de verificaciones previas básicas de elegibilidad de audiencia, reelegibilidad y elegibilidad de 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 coincidía con los criterios de audiencia antes de que Braze enviara el mensaje o ingresara al usuario en el Canvas. El tiempo entre que el usuario inicialmente cumplió los criterios de audiencia y dejó de cumplirlos podría deberse a demoras por:
|
| 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 inválidos, ausencia de tokens de push elegibles, restricciones de estado de suscripción, capacidad de canal no compatible o países bloqueados para 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 de mensaje o era parte de una lista de supresión. Dependiendo de la configuración de Validaciones de entrega, el usuario puede haber salido del Canvas o 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 fue cancelado debido a la configuración de reelegibilidad o reentrada. Esto puede ocurrir si el usuario ya recibió la Campaign o entró en el Canvas demasiado recientemente, si otro envío de la misma Campaign ya está 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ó después del número máximo de reintentos (el valor predeterminado es cinco). Este recuento representa la cantidad de mensajes cancelados por alcanzar el número máximo de reintentos, no el total de solicitudes de contenido conectado fallidas. |
| Content Card inválida | La Content Card tenía errores y no fue enviada al usuario. Algunas razones comunes incluyen:
|
| Fallo del paso de demora | El paso de demora falló, provocando que el usuario saliera del Canvas. Este fallo puede ocurrir cuando:
|
| Cancelación por Liquid | Se invocó la etiqueta de Liquid abort_message, por lo que el envío fue cancelado. |
| Tiempo de espera agotado en el 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 tuvo un error de análisis, por lo que el mensaje fue cancelado. |
| Fallo en la URL de medios | Braze no pudo procesar la URL de medios en el mensaje. Esto puede ocurrir cuando la URL está bloqueada, es inválida, se agota el tiempo de espera, devuelve un estado HTTP inválido o falla 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 toda la ventana. |
| Recomendación de productos inválida | La recomendación de productos o la selección de catálogo no pudo usarse para este envío. Las razones comunes incluyen una recomendación faltante o archivada, entrenamiento incompleto o filtros que eliminaron todos los elementos del catálogo. |
| Credenciales push inválidas | Las credenciales push para esta aplicación están faltantes o son inválidas, por lo que el envío fue cancelado. Actualiza tus credenciales en Configuración de la aplicación. |
| Limitado por velocidad durante 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. |
| 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. |
| Perfil de usuario no encontrado | El usuario nunca existió o ya no existe en Braze. Algunos casos comunes incluyen:
|
| Fallo del webhook | El webhook recibió un código de respuesta no exitoso (distinto de 2xx). Los códigos de error comunes pueden ser errores de cliente 4XX, errores de servidor o tiempo de espera agotado 5XX, o 598 Host Unhealthy o solicitudes detenidas brevemente. |
| Otro | Fallos que no se incluyen en las otras categorías de esta tabla. Si notas una gran proporción de fallos en Otro, contacta a soporte de Braze para obtener asistencia adicional. |
Preguntas frecuentes
¿Qué significa un fallo de “comprobación previa”?
Una “comprobación previa” se refiere a una verificación de validación rápida y agrupada que se ejecuta al comienzo de una etapa del pipeline (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 obtener la máxima velocidad. En lugar de ejecutar muchas comprobaciones separadas y que consumen muchos recursos (como validar cada detalle del perfil de un usuario), Braze agrupa varias validaciones básicas en una sola “primera pasada”.
Si un usuario no supera esta comprobación agrupada, se descarta inmediatamente. Este enfoque agrupado permite a Braze procesar volúmenes masivos de mensajes a gran velocidad y puede contribuir a un rendimiento más rápido y estable para tus Campaigns y Canvas al reducir la latencia de procesamiento de cada mensaje.
¿Qué significa un fallo de tipo “Otro”?
Son fallos que no se incluyen en las categorías existentes del panel. Si sigues observando una gran proporción de fallos de tipo Otro, ponte en contacto con el soporte de Braze para obtener más ayuda.
¿Por qué Entradas, Supresiones, Fallos y Enviados no suman el tamaño de audiencia esperado?
Esto puede ocurrir por varias razones:
- Criterios de audiencia: Puede que menos usuarios de los esperados hayan cumplido los criterios de audiencia (por ejemplo, no estaban en el Segment o no tenían los atributos necesarios) cuando se lanzó la Campaign o el Canvas.
- Procesamiento en curso: Los mensajes o pasos de Canvas pueden estar procesándose activamente. Los usuarios pueden seguir en pasos anteriores del Canvas y aún 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 Delay o de división de decisiones) sin que se registre una supresión, un fallo o un envío correspondiente en el mismo periodo.
- Actualización de 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 Campaign o Canvas aún no hayan llegado al panel.
- Casos excepcionales: Existe una pequeña posibilidad de que estés encontrando un caso excepcional que no se recoge en este panel en este momento. Si crees que es así, ponte en contacto con el soporte de Braze.
¿Por qué los totales de las tarjetas o del registro de eventos pueden ser mayores que la audiencia de una Campaign o un Canvas?
Esto puede ocurrir por las siguientes razones:
- Mensajes multicanal: La Campaign o el paso de Canvas se configuró para enviar en varios canales (como SMS y correo electrónico). Un solo usuario puede recibir un resultado de “enviado” en un canal (como correo electrónico) y una supresión o fallo en otro (como “Usuario no elegible para el canal”). En este caso, ese usuario se contabiliza más de una vez en las tarjetas y el registro de eventos.
- Por ejemplo, envías una Campaign 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 genera una supresión para la notificación push de Android (“Usuario no elegible para el canal”).
- Múltiples pasos de mensaje (solo Canvas): Tu Canvas puede tener más de un paso de mensaje en un recorrido determinado. Este panel agrega todos los eventos, por lo que un solo usuario podría contabilizarse varias veces si pasa por múltiples pasos dentro del rango de tiempo seleccionado.
- Mensajes de prueba: Los envíos de prueba (que se contabilizan en el panel) pueden hacer que los totales superen el tamaño de la audiencia.