Solución de problemas de mensajes dentro de la aplicación

Usa esta página para diagnosticar por qué los mensajes dentro de la aplicación no se entregan o no se muestran en un dispositivo. Para la configuración del dashboard (prioridad, desencadenantes, Segments y reelegibilidad), consulta las preguntas frecuentes sobre mensajes dentro de la aplicación.

Antes de depurar, añádete como usuario de prueba y revisa Envío de mensajes de prueba.

Empieza aquí: identifica tu síntoma

Ruta de investigación estándar

Usa este flujo de trabajo para cada incidente. Comienza en el paso 1.

1. Confirma que se registra un inicio de sesión para el dispositivo de prueba. Los mensajes dentro de la aplicación se solicitan al inicio de sesión.
2. Abre los registros de eventos de usuario y busca la solicitud del SDK para ese inicio de sesión. En Response Data:
   • En el JSON sin procesar, confirma que respond_with incluye "triggers": true.
   • La fila Requested Responses debe incluir triggers.
   • Las filas Trigger In-App Message enumeran cada mensaje dentro de la aplicación devuelto para esa solicitud.
   • Si no hay una clave triggers ni filas Trigger In-App Message, ve a Solución de problemas de mensajes no solicitados.
   • Si triggers está presente pero vacío ([]), ve a Solución de problemas de mensajes no devueltos.
   • Si hay filas Trigger In-App Message pero nada se muestra, ve a Solución de problemas de visualización específica por plataforma.
   • Cada carga útil de desencadenante incluye un type: inapp (estándar) o templated_iam (requiere una solicitud de plantilla antes de mostrarse). Consulta Tipos de mensajes dentro de la aplicación.
3. Para la elegibilidad del lado del dashboard (Segment, reelegibilidad, límites de frecuencia, prioridad, grupos de control), consulta Solución de problemas de entrega y las preguntas frecuentes sobre mensajes dentro de la aplicación.
4. Para problemas de visualización del lado del dispositivo (delegados, límites de velocidad, orientación, tiempo de espera de sesión), selecciona la pestaña de tu SDK en Solución de problemas de visualización específica por plataforma.

Mensajes dentro de la aplicación en Canvas

Síntoma: Un usuario entró en un paso de mensaje dentro de la aplicación en Canvas pero no vio el mensaje cuando se esperaba.

Tres comportamientos generan la mayoría de los tickets de Canvas y mensajes dentro de la aplicación:

1. Visualización en la siguiente sesión: Los mensajes dentro de la aplicación en Canvas son elegibles en el siguiente inicio de sesión después de que se procese el paso, no inmediatamente a mitad de sesión. Consulta ¿Cuándo se envían los mensajes dentro de la aplicación en Canvas? en las preguntas frecuentes de Canvas.
2. Validaciones de entrega en la entrada del paso: Si Validar audiencia al enviar el mensaje está habilitado en el paso de mensaje, la pertenencia al Segment y los límites de frecuencia se evalúan cuando el usuario entra en el paso, no en el momento de la visualización. Consulta Validaciones de entrega.
3. Retraso y tiempo de espera de sesión: Si un usuario entra en un paso de retraso más largo que el tiempo de espera de sesión de tu SDK, puede iniciar una nueva sesión antes del paso de mensaje dentro de la aplicación. Es posible que el mensaje no se obtenga en el inicio de sesión cuando esperas que se muestre.

Para ventanas de disponibilidad, expiración y cero Envíos en los análisis de Canvas, consulta Mensajes dentro de la aplicación y entrega en las preguntas frecuentes de Canvas.

Importante

Los mensajes dentro de la aplicación en Canvas solo pueden ser desencadenados por eventos enviados a través del SDK, no por la REST API.

El mensaje dentro de la aplicación no se mostró para un usuario

Síntoma: Un usuario no recibió un mensaje dentro de la aplicación esperado; otros usuarios pueden no estar afectados.

Comprueba lo siguiente:

• ¿Estaba el usuario en el Segment al inicio de sesión, cuando el SDK solicita nuevos mensajes dentro de la aplicación?
• ¿Era el usuario elegible o reelegible según las reglas de segmentación de la Campaign o Canvas? Consulta Reelegibilidad para Campaigns y Canvas.
• ¿Se aplicó un límite de frecuencia?
• ¿Estaba el usuario en un grupo de control de la Campaign? Comprueba si la Campaign está configurada para pruebas A/B.
• ¿Se mostró en su lugar un mensaje dentro de la aplicación de mayor prioridad? Consulta ¿Pueden mostrarse varios mensajes dentro de la aplicación en la misma sesión? en las preguntas frecuentes de mensajes dentro de la aplicación.
• ¿Estaba el dispositivo en la orientación especificada por la Campaign?
• ¿Fue suprimido el mensaje por el intervalo mínimo predeterminado de 30 segundos entre desencadenantes? Consulta Anular el límite de velocidad predeterminado.

Luego sigue la ruta de investigación estándar.

El mensaje dentro de la aplicación no se mostró en una plataforma

Síntoma: Los mensajes dentro de la aplicación no se muestran en Android, iOS o Web, pero pueden funcionar en otras plataformas.

El mensaje dentro de la aplicación no se mostró para todos los usuarios

Síntoma: Ningún usuario o menos usuarios de los esperados recibieron el mensaje dentro de la aplicación.

Comprueba lo siguiente:

• ¿Está la acción desencadenante configurada correctamente en el dashboard y en la integración de la aplicación?
• ¿Interceptó un mensaje dentro de la aplicación de mayor prioridad la Campaign? Consulta las preguntas frecuentes sobre mensajes dentro de la aplicación.
• ¿Estás usando una versión reciente del SDK? Algunos tipos de mensajes dentro de la aplicación tienen requisitos mínimos de SDK.
• ¿Están las sesiones integradas correctamente? Confirma que los análisis de sesión funcionan para esta aplicación.
• ¿Está una biblioteca de UI personalizada interfiriendo con la visualización? Consulta Personalización.

Luego sigue la ruta de investigación estándar.

Temporización y visualización retrasada

Síntoma: El mensaje dentro de la aplicación apareció más tarde de lo esperado o no hasta una nueva sesión.

Causas comunes:

• Precarga en el inicio de sesión de la Campaign: Los mensajes dentro de la aplicación se almacenan en caché al inicio de sesión y se muestran cuando se activa el desencadenante. Un desencadenante que ocurre antes del siguiente inicio de sesión no se mostrará hasta esa sesión. Consulta Desencadenar mensajes.
• Comportamiento de siguiente sesión en Canvas: Consulta Mensajes dentro de la aplicación en Canvas.
• Retraso planificado en el dashboard: Confirma si hay un retraso configurado en la Campaign o el paso.
• Condición de carrera en la sincronización de desencadenantes: Si los usuarios registran un evento inmediatamente después del inicio de sesión, es posible que los desencadenantes aún no se hayan sincronizado. Considera desencadenar a partir del inicio de sesión y segmentar por el evento deseado para que la entrega ocurra en la siguiente sesión después del evento.
• Mensajes dentro de la aplicación secuenciales: Si estás aplazando o restaurando mensajes en un recorrido, consulta Aplazar mensajes dentro de la aplicación desencadenados.
• Activos grandes o CDN lento: Optimiza las imágenes y el video para mensajes dentro de la aplicación HTML. En dispositivos móviles, las imágenes pueden descargarse antes de mostrarse en redes lentas; selecciona la pestaña de tu SDK a continuación para notas específicas de la plataforma.

Nota

Si tu mensaje dentro de la aplicación se desencadena por el inicio de sesión y has configurado un tiempo de espera de sesión extendido, cerrar y volver a abrir la aplicación dentro de esa ventana no actualizará la sesión. Por ejemplo, con un tiempo de espera de 300 segundos, un mensaje dentro de la aplicación desencadenado por inicio de sesión no se mostrará hasta que la sesión se actualice realmente. Ajusta el tiempo de espera de sesión o el tipo de desencadenante si esto afecta tu prueba.

Solución de problemas de entrega

La mayoría de los problemas con mensajes dentro de la aplicación son de entrega (el dispositivo no recibió los desencadenantes) o de visualización (los desencadenantes llegaron pero no se mostraron). Confirma primero la entrega y luego comprueba la visualización.

Solución de problemas de entrega

El SDK solicita mensajes dentro de la aplicación a los servidores de Braze al inicio de sesión. Confirma que el SDK está solicitando desencadenantes y que Braze los está devolviendo.

Comprueba si los mensajes se solicitan y se devuelven

1. Añádete como usuario de prueba.
2. Configura una Campaign de mensaje dentro de la aplicación dirigida a tu usuario.
3. Inicia una nueva sesión en tu aplicación.
4. En los registros de eventos de usuario, busca la solicitud del SDK para el evento de inicio de sesión. En Response Data:
   • En el JSON sin procesar, confirma que respond_with incluye "triggers": true.
   • La fila Requested Responses enumera las claves de nivel superior en la respuesta. Para mensajes dentro de la aplicación, espera triggers.
   • Las filas Trigger In-App Message enumeran cada mensaje dentro de la aplicación devuelto para esa solicitud.

   Luego clasifica:

   • Si no hay una clave triggers ni filas Trigger In-App Message, consulta Solución de problemas de mensajes no solicitados.
   • Si triggers está presente pero vacío ([]), consulta Solución de problemas de mensajes no devueltos.
   • Si hay filas Trigger In-App Message pero nada se muestra en el dispositivo, consulta Solución de problemas de visualización específica por plataforma.
   • Cada carga útil de desencadenante incluye un type: inapp (estándar) o templated_iam (requiere una solicitud de plantilla antes de mostrarse). Consulta Tipos de mensajes dentro de la aplicación.
5. Confirma que los mensajes dentro de la aplicación correctos aparecen en los datos de respuesta.

Solución de problemas de mensajes no solicitados

Si los mensajes dentro de la aplicación no se están solicitando, es posible que tu aplicación no esté rastreando las sesiones correctamente; los mensajes dentro de la aplicación se actualizan al inicio de sesión. Confirma que la aplicación está iniciando una sesión según la semántica de tiempo de espera de sesión:

Solución de problemas de mensajes no devueltos

Si los mensajes dentro de la aplicación no se están devolviendo, es probable que haya un problema de segmentación o elegibilidad:

1. Tu Segment no contiene a tu usuario.
   • Comprueba la pestaña Interacción del usuario para el Segment esperado.
2. Tu usuario ya recibió el mensaje y no era reelegible.
   • Comprueba la configuración de reelegibilidad y las preguntas frecuentes sobre mensajes dentro de la aplicación.
3. Tu usuario alcanzó el límite de frecuencia.
   • Comprueba la configuración de límites de frecuencia.
4. Tu usuario cayó en un grupo de control.
   • Crea un Segment con un filtro Received campaign variant establecido en Control, o excluye los grupos de control durante las pruebas de integración.
5. Un mensaje dentro de la aplicación de mayor prioridad tuvo precedencia. Consulta las preguntas frecuentes sobre mensajes dentro de la aplicación.

Para Campaigns archivadas, configuración de desencadenantes y horas tranquilas, consulta las preguntas frecuentes sobre mensajes dentro de la aplicación.

Impresiones y análisis

Síntoma: Los recuentos de impresiones o clics no coinciden con las expectativas.

• Impresiones mayores que Impresiones únicas: Es esperado cuando los usuarios tienen varios dispositivos o cuando un retraso planificado hace que el mismo usuario califique más de una vez. Consulta Reelegibilidad para Campaigns y Canvas.
• Impresiones menores de lo esperado: Es posible que los usuarios no hayan visto el mensaje (las impresiones se registran al mostrarse), que varios mensajes de alta prioridad se intercepten entre sí, o que se apliquen condiciones de carrera en la sincronización de desencadenantes. Para mensajes dentro de la aplicación en Canvas, consulta Mensajes dentro de la aplicación en Canvas. Para definiciones completas de métricas, consulta Informes de mensajes dentro de la aplicación y las preguntas frecuentes sobre mensajes dentro de la aplicación.
• Impresiones menores que antes: Revisa los registros de cambios del Segment y la Campaign. Confirma que no reutilizaste el mismo evento desencadenante en una Campaign de mayor prioridad.

Si usas un delegado o un controlador personalizado para mostrar mensajes dentro de la aplicación manualmente, debes registrar las impresiones y los clics tú mismo. Consulta la pestaña de tu SDK en Solución de problemas de visualización específica por plataforma para detalles de Swift y Android, o Registrar datos de mensajes dentro de la aplicación para Web.

Solución de problemas de visualización específica por plataforma

Si aparecen filas Trigger In-App Message en los registros de eventos de usuario pero nada se muestra en el dispositivo, selecciona la pestaña de tu SDK para comprobaciones de visualización (delegados, límites de velocidad, orientación y controladores personalizados).

• web
• android
• swift

1
NFX.sharedInstance().ignoreURLs(["https://cdn.braze.com"])

1
[NFX.sharedInstance ignoreURLs:@[@"https://cdn.braze.com"]];

1
NetGuard.blackListHosts.append(contentsOf: ["cdn.braze.com"])

1
2
3
NSMutableArray<NSString *> *blackListHosts = [NetGuard.blackListHosts mutableCopy];
[blackListHosts addObject:@"cdn.braze.com"];
NetGuard.blackListHosts = blackListHosts;

1
2
let brazeAssetsHostFilter = XNHostFilter(host: "https://cdn.braze.com")
XNLogger.shared.addFilters([brazeAssetsHostFilter])

1
2
XNHostFilter *brazeAssetsHostFilter = [[XNHostFilter alloc] initWithHost: @"https://cdn.braze.com"];
[XNLogger.shared addFilters:@[brazeAssetsHostFilter]];