Solución de problemas

Comprobaciones básicas

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

1. ¿Estaba el usuario en el segmento al inicio de la sesión, cuando el SDK solicita nuevos mensajes dentro de la aplicación?
2. ¿El usuario era elegible o reelegible para recibir el mensaje dentro de la aplicación según las reglas de segmentación de la Campaign?
3. ¿Se vio afectado el usuario por un límite de frecuencia?
4. ¿Estaba el usuario en un grupo de control? Comprueba si tu Campaign está configurada para pruebas AB.
5. ¿Se mostró un mensaje dentro de la aplicación diferente y de mayor prioridad en lugar del mensaje esperado?
6. ¿Mi dispositivo estaba en la orientación correcta especificada por la Campaign?
7. ¿Mi mensaje fue suprimido por el intervalo de tiempo mínimo predeterminado de 30 segundos entre desencadenamientos, impuesto por el SDK?

Mi mensaje dentro de la aplicación no se mostró a todos los usuarios de esta plataforma

1. ¿Tu Campaign está configurada para dirigirse a aplicaciones móviles o navegadores web, según corresponda? Por ejemplo, si tu Campaign solo se dirige a navegadores web, no se enviará a dispositivos Android.
2. ¿Implementaste una interfaz de usuario personalizada y funciona según lo previsto? ¿Hay algún otro manejo personalizado o supresión del lado de la aplicación que pueda estar interfiriendo con la visualización?
3. ¿Alguna vez esta plataforma y versión de aplicación en particular ha mostrado mensajes dentro de la aplicación con éxito?
4. ¿El desencadenamiento tuvo lugar localmente en el dispositivo? Ten en cuenta que no se puede utilizar una llamada REST para desencadenar un mensaje dentro de la aplicación en el SDK.

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

1. ¿Se configuró correctamente la acción desencadenante en el dashboard, así como en la integración de la aplicación?
2. ¿Se mostró un mensaje dentro de la aplicación diferente y de mayor prioridad en lugar del mensaje esperado?
3. ¿Tienes una versión reciente del SDK? Algunos tipos de mensajes dentro de la aplicación tienen requisitos de versión del SDK.
4. ¿Se han integrado correctamente las sesiones en tu integración? ¿Funcionan los análisis de sesión en esta aplicación?
5. ¿Estás usando una biblioteca de componentes personalizada que pueda interferir con la forma en que se muestran los mensajes dentro de la aplicación?

Mi mensaje dentro de la aplicación tardó mucho en aparecer

1. Si sirves archivos grandes de imagen o video desde tu CDN a un mensaje dentro de la aplicación basado en HTML, comprueba que tus archivos estén optimizados para ser lo más pequeños posible y que tu CDN tenga un buen rendimiento.

2. Comprueba si has configurado un delay para tu mensaje dentro de la aplicación en el dashboard.

3. Dependiendo de las circunstancias, los mensajes dentro de la aplicación descargarán o cargarán las imágenes relevantes del disco antes de su visualización. Si tienes una conexión de red lenta o un dispositivo de muy bajo rendimiento, este proceso puede tardar. Asegúrate de que tus imágenes estén optimizadas para ser lo más pequeñas posible.

Para profundizar en estos escenarios, visita la sección de solución de problemas avanzada.

Problemas con los análisis de impresiones y clics

Las impresiones y los clics no se registran

Si has configurado un delegado de mensajes dentro de la aplicación para gestionar manualmente la visualización del mensaje o las acciones de clic, debes registrar los clics y las impresiones manualmente en el mensaje dentro de la aplicación.

Las impresiones son mayores que las impresiones únicas

Este es un comportamiento esperado y puede ocurrir cuando:

• Aunque la reelegibilidad esté desactivada, los usuarios que recibieron la Campaign pueden tener más de un dispositivo. El desencadenamiento de la Campaign se actualiza en el siguiente inicio de sesión, por lo que un dispositivo no sabrá si otro dispositivo ya ha desencadenado la Campaign hasta que el usuario inicie una nueva sesión.
• Si tu mensaje dentro de la aplicación tiene un retraso programado de unos minutos después de que ocurra el evento desencadenante, los usuarios pueden haber recibido el mensaje más de una vez.

Para más información sobre la reelegibilidad, consulta Reelegibilidad para Campaigns y Canvas.

Las impresiones son inferiores a lo esperado

1. Los desencadenantes tardan en sincronizarse con el dispositivo al iniciar la sesión, por lo que puede darse una condición de carrera si los usuarios registran un evento o una compra justo después de iniciar la sesión. Una posible solución podría ser cambiar la Campaign para que se desencadene al inicio de la sesión y luego segmentar en función del evento o la compra previstos. Ten en cuenta que esto entregaría el mensaje dentro de la aplicación en el siguiente inicio de sesión tras producirse el evento.

2. Si la Campaign se desencadena por el inicio de una sesión o un evento personalizado, debes asegurarte de que este evento o sesión se produce con la frecuencia suficiente para desencadenar el mensaje. Comprueba estos datos en las páginas Resumen (para datos de sesión) o Eventos personalizados:

Otras razones incluyen:

• Los usuarios no han visto el mensaje dentro de la aplicación, por lo que las impresiones no se registran.
• Varios mensajes dentro de la aplicación se interceptan entre sí (como varios mensajes de alta prioridad).
• Si el mensaje está en un Canvas, los usuarios pueden estar entrando en un paso de retraso que es más largo que el tiempo de espera de sesión antes de recibir el mensaje dentro de la aplicación.

Las impresiones son más bajas que antes

1. Asegúrate de que nadie haya alterado involuntariamente el segmento o la Campaign desde su lanzamiento. Nuestros registros de cambios de segmentos y Campaigns te darán información sobre los cambios que se han hecho, quién los hizo y cuándo ocurrieron.

2. Asegúrate de no reutilizar tu evento desencadenante en otra Campaign de mensajes dentro de la aplicación con una prioridad mayor.

Solución de problemas avanzada

La mayoría de los problemas de mensajes dentro de la aplicación pueden dividirse en dos categorías principales: entrega y visualización. Para solucionar por qué un mensaje dentro de la aplicación esperado no se mostró en tu dispositivo, confirma que el mensaje dentro de la aplicación se entregó al dispositivo y luego soluciona el problema de visualización del mensaje.

Solución de problemas de entrega

El SDK solicita mensajes dentro de la aplicación a los servidores de Braze al iniciar la sesión. Para comprobar si los mensajes dentro de la aplicación se están entregando a tu dispositivo, tendrás que asegurarte de que los mensajes dentro de la aplicación están siendo solicitados por el SDK y devueltos por los servidores de Braze.

Comprueba si los mensajes se solicitan y se devuelven

1. Añádete como usuario de prueba en el dashboard.
2. Configura una Campaign de mensajes dentro de la aplicación dirigida a tu usuario.
3. Asegúrate de que se produce una nueva sesión en tu aplicación.
4. Utiliza los registros de eventos de usuario para comprobar que tu dispositivo solicita mensajes dentro de la aplicación al inicio de la sesión. Busca la solicitud del SDK asociada al evento de inicio de sesión de tu usuario de prueba.
   • Si tu aplicación debía solicitar mensajes dentro de la aplicación desencadenados, deberías ver trigger en el campo Requested Responses, en Response Data.
   • Si tu aplicación debía solicitar mensajes originales dentro de la aplicación, deberías ver in_app en el campo Requested Responses, en Response Data.
5. Utiliza los registros de eventos de usuario para comprobar si los mensajes correctos dentro de la aplicación se devuelven en los datos de respuesta.
   

Solución de problemas de mensajes no solicitados

Si tus mensajes dentro de la aplicación no se solicitan, es posible que tu aplicación no esté haciendo un seguimiento correcto de las sesiones, ya que los mensajes dentro de la aplicación se actualizan al iniciar la sesión. Además, asegúrate de que tu aplicación está iniciando realmente una sesión según la semántica de tiempo de espera de sesión de tu aplicación:

Solución de problemas de mensajes no devueltos

Si tus mensajes dentro de la aplicación no se devuelven, es probable que estés experimentando un problema de segmentación de la Campaign:

1. Tu segmento no contiene a tu usuario.
   • Comprueba la pestaña Interacción de tu usuario para ver si el segmento correcto aparece en Segments.
2. Tu usuario ha recibido previamente el mensaje dentro de la aplicación y no era reelegible para volver a recibirlo.
   • Comprueba la configuración de reelegibilidad de la Campaign en el paso Delivery del Campaign Composer y asegúrate de que la configuración de reelegibilidad se ajusta a tu configuración de prueba.
3. Tu usuario alcanzó el límite de frecuencia de la Campaign.
   • Comprueba la configuración de límite de frecuencia de la Campaign y asegúrate de que se ajusta a tu configuración de prueba.
4. Si había un grupo de control en la Campaign, tu usuario puede haber caído en el grupo de control.
   • Puedes comprobar si esto ha ocurrido creando un segmento con un filtro de variante de Campaign recibida, en el que la variante de Campaign esté configurada como Control, y comprobando si tu usuario cayó en ese segmento.
   • Cuando crees Campaigns para realizar pruebas de integración, asegúrate de no añadir un grupo de control.

Solución de problemas de visualización

Si tu aplicación solicita y recibe correctamente mensajes dentro de la aplicación, pero no se muestran, es posible que la lógica del dispositivo esté impidiendo la visualización:

1. ¿Se desencadena el evento como se espera? Para comprobarlo, intenta configurar el mensaje para que se desencadene mediante una acción diferente (como el inicio de sesión) y verifica si se muestra.

2. Los mensajes desencadenados dentro de la aplicación tienen una tasa limitada en función del intervalo de tiempo mínimo entre desencadenamientos, que es de 30 segundos de forma predeterminada.

3. Las descargas de imágenes fallidas impedirán que se muestren los mensajes dentro de la aplicación con imágenes. Comprueba los registros de tu dispositivo para asegurarte de que las descargas de imágenes no están fallando. Prueba a eliminar temporalmente la imagen de tu mensaje para ver si así se muestra.

4. Si has configurado un delegado para personalizar la gestión de mensajes dentro de la aplicación, comprueba tu delegado para asegurarte de que no está afectando a la visualización de mensajes dentro de la aplicación.

5. Si la orientación del dispositivo no coincide con la orientación especificada por el mensaje dentro de la aplicación, el mensaje dentro de la aplicación no se mostrará. Asegúrate de que tu dispositivo está en la orientación correcta.

6. Si tu mensaje dentro de la aplicación se desencadena al iniciar la sesión y has configurado un tiempo de espera de sesión ampliado, esto afectará a la rapidez con la que puedes mostrar mensajes. Por ejemplo, si el tiempo de espera de tu sesión está configurado en 300 segundos, cerrar y volver a abrir la aplicación en menos de ese tiempo no actualizará la sesión, por lo que un mensaje dentro de la aplicación desencadenado por el inicio de una sesión no se mostrará.

Solución de problemas de carga de activos (NSURLError código -1008)

Al integrar Braze junto con bibliotecas de registro de red de terceros, los desarrolladores pueden encontrarse habitualmente con un NSURLError con el código del dominio -1008. Este error indica que activos como imágenes y fuentes no se han podido recuperar o no se han almacenado en caché. Para evitar estos casos, tendrás que registrar las URL de CDN de Braze en la lista de dominios que deben ser ignorados por estas bibliotecas.

Dominios

La lista completa de dominios CDN es la siguiente:

• "appboy-images.com"
• "braze-images.com"
• "cdn.braze.eu"
• "cdn.braze.com"

Ejemplos

A continuación se muestran las bibliotecas que se sabe que entran en conflicto con el almacenamiento en caché de activos de Braze, junto con un código de ejemplo para solucionar el problema. Si tu proyecto utiliza una biblioteca que provoca un error de recurso no disponible y no aparece en la lista siguiente, consulta la documentación de esa biblioteca para conocer las API de uso similares.

Netfox

• swift
• objective-c

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

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

NetGuard

• swift
• objective-c

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;

XNLogger

• swift
• objective-c

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]];