Solución de problemas de push

Usa esta página para solucionar problemas con el canal de mensajería push.

Notificaciones push faltantes

¿Tienes problemas con la entrega de notificaciones push? Hay una serie de pasos que puedes seguir para solucionar este problema comprobando lo siguiente:

• Estado de suscripción push
• Segment
• Límites de notificaciones push
• Límites de velocidad
• Estado del grupo de control
• Token de push válido
• Tipo de notificación push
• Aplicación actual

Estado de suscripción push

Las notificaciones push solo pueden enviarse a usuarios suscritos u optados. Comprueba tu perfil de usuario en la pestaña Interacción en la sección Perfil de usuario para confirmar si estás registrado activamente para push en el espacio de trabajo que estás probando. Si estás registrado en varias aplicaciones, las encontrarás en el campo Push Registered For:

También puedes exportar los perfiles de usuario utilizando los puntos de conexión de exportación de Braze:

• Usuarios por identificador
• Usuarios por segmento

Cualquiera de los dos puntos de conexión devolverá un objeto de token de push que incluye información de habilitación de push por dispositivo.

Segment

Asegúrate de que perteneces al segmento al que te diriges (si se trata de una campaña en vivo y no de una prueba). En el Perfil de usuario, verás una lista de segmentos a los que pertenece actualmente el usuario. Recuerda que esta es una variable en constante cambio, ya que la segmentación se actualiza en tiempo real.

También puedes confirmar que el usuario forma parte del segmento utilizando Búsqueda de usuario al crear un segmento.

Límites de notificaciones push

Comprueba los límites de frecuencia globales. Es posible que no hayas recibido la notificación push porque tu espacio de trabajo tiene una limitación de frecuencia global activa y ya has alcanzado tu límite de notificaciones push para el período de tiempo especificado.

Puedes hacerlo comprobando la limitación de frecuencia global en el dashboard. Si la campaña está configurada para respetar las reglas de limitación de frecuencia, habrá un número de usuarios afectados por esta configuración.

Límites de velocidad

Si tienes un límite de velocidad configurado para tu campaña o Canvas, es posible que no estés recibiendo mensajes porque has superado este límite. Para más información, consulta Límite de velocidad.

Estado del grupo de control

Si se trata de una campaña de un solo canal o un Canvas con un grupo de control, es posible que estés cayendo en el grupo de control.

1. Comprueba la distribución de variantes para ver si hay un grupo de control.
2. Si es así, crea un segmento filtrando por en grupo de control de Campaign y luego exporta el segmento y comprueba si tu ID de usuario está en esta lista.

Token de push válido

Un token de push es un identificador que los remitentes utilizan para dirigirse a dispositivos específicos con una notificación push. Por lo tanto, si el dispositivo no tiene un token de push válido, no hay forma de enviarle una notificación push.

Tipo de notificación push

Comprueba que estás utilizando el tipo correcto de notificación push. Por ejemplo, si quieres dirigirte a un FireTV, usarías una notificación push de Kindle, no una campaña push de Android. Del mismo modo, si quieres dirigirte a un Android, usa una notificación push de Android y no una campaña push de iOS. Consulta los siguientes artículos para más información sobre cómo entender el flujo de trabajo de Braze para:

• Apple Push Notification
• Firebase Cloud Messaging

Aplicación actual

Al probar envíos push con usuarios internos, asegúrate de que el usuario que deseas que reciba la notificación push esté actualmente conectado en la aplicación correspondiente. Esto puede provocar que el usuario no reciba una notificación push o que reciba una push para la que crees que no está segmentado.

Al hacer clic en una notificación push no se abre la aplicación

Si al hacer clic en una notificación push no se abre tu aplicación, comprueba lo siguiente según tu plataforma.

Android

1. Verifica el comportamiento al hacer clic: Confirma que la campaña está configurada para abrir la aplicación al hacer clic.
2. Comprueba el manejo de vínculos profundos: En tu archivo braze.xml, comprueba si com_braze_handle_push_deep_links_automatically está configurado como true o false.
   • Si está configurado como true, el SDK de Braze maneja los vínculos profundos directamente y la aplicación debería abrirse como se espera.
   • Si está configurado como false, tu aplicación necesita un receptor de difusión para escuchar y manejar las intenciones de push recibidas y abiertas. Verifica que este receptor esté implementado correctamente.
3. Recopila registros detallados: Habilita el registro detallado, reproduce el problema y proporciona los registros junto con tu braze.xml y AndroidManifest.xml al soporte de Braze.

iOS

1. Verifica el comportamiento al hacer clic: Confirma que la campaña está configurada para abrir la aplicación al hacer clic.
2. Comprueba la integración push: La vinculación en profundidad desde una notificación push hacia la aplicación se maneja automáticamente mediante la integración push estándar de Braze. Confirma que la integración está implementada correctamente, incluyendo cualquier manejo de delegado personalizado.
3. Recopila registros detallados: Habilita el registro detallado, reproduce el problema y proporciona los registros al soporte de Braze.

Los clics en push abren inesperadamente dentro de la aplicación

Si tienes problemas con enlaces en notificaciones push que se abren inesperadamente dentro de tu aplicación en lugar de en tu navegador web, puede haber un problema con la configuración de tu campaña o la implementación del SDK. Consulta estos pasos para obtener ayuda.

Verifica el comportamiento al hacer clic

En tu campaña o paso en Canvas, verifica que Open web URL inside mobile app no esté seleccionado. Si lo está, desmarca la selección y vuelve a lanzar.

La interacción predeterminada para el comportamiento al hacer clic “Open web URL” difiere según la versión del SDK. Para las versiones del SDK iOS 2.29.0 y Android 2.0.0 y superiores, esta opción está seleccionada de forma predeterminada y las URL web se abrirán en una vista web dentro de la aplicación. Antes de estas versiones, esta opción está desmarcada de forma predeterminada y las URL web se abren en el navegador web predeterminado del dispositivo.

Si este no es el problema, puede haber un problema con tu implementación push.

Verifica la integración push

Si los enlaces en tus notificaciones push se abren inesperadamente en la aplicación, puede deberse a problemas con la integración de notificaciones push o la configuración de personalización. Sigue estos pasos para solucionar el problema:

1. Revisa la implementación del delegado push: Asegúrate de que el delegado push de Braze esté implementado correctamente. Para instrucciones detalladas, consulta la guía de integración de notificaciones push para tu plataforma.
2. Inspecciona el manejo personalizado de enlaces: Comprueba si la aplicación incluye un manejo personalizado para todos los enlaces https://. Las configuraciones personalizadas pueden anular los comportamientos predeterminados. Colabora con tu equipo de desarrollo para revisar y ajustar esta configuración si es necesario.
3. Verifica el registro push en iOS: Para iOS, revisa el paso 1 de la guía de integración push sobre registrar notificaciones push con APNs. Asegúrate de que tu objeto delegado se asigne de forma sincrónica antes de que la aplicación termine de lanzarse. Este paso debe completarse en el método application:didFinishLaunchingWithOptions:.
4. Prueba tu integración: Después de realizar los ajustes, prueba el comportamiento de las notificaciones push en dispositivos iOS y Android para confirmar que el problema se ha resuelto.

Migrar a una clave de autenticación .p8

Las claves de autenticación .p8 de Apple son el enfoque requerido para push de APNs en Braze. A diferencia de los tipos de archivo de certificado heredados, las claves .p8 no caducan y son compatibles con todas tus aplicaciones bajo una sola clave, eliminando la necesidad de renovaciones anuales de certificados y reduciendo el riesgo de fallos en la entrega push.

Si actualmente estás usando un certificado .p12 o .pem, migra a una clave .p8 lo antes posible. Para instrucciones sobre cómo crear y cargar una clave .p8, consulta Cargar tu certificado push de APNs. Para la guía de Apple sobre cómo generar una clave .p8 desde tu cuenta de desarrollador, consulta Communicate with APNs using authentication tokens.

Las notificaciones push web no se comportan como se espera

Si tienes problemas con las notificaciones push en tu navegador, es posible que necesites restablecer los permisos de notificación de tu sitio y borrar el almacenamiento de tu sitio. Consulta estos pasos para obtener ayuda.

• chrome
• firefox
• safari

Mensajes de error de push

Para información detallada sobre mensajes de error push comunes (como DEVICE_UNREGISTERED, Unregistered, NotRegistered y otros), consulta Mensajes de error push comunes.

¿Aún necesitas ayuda? Abre un ticket de soporte.