Skip to content

Solución de problemas de notificaciones push

Usa esta página para diagnosticar problemas de entrega y visualización de notificaciones push en un dispositivo. Para comprobaciones de entrega del lado del panel (estado de suscripción, Segments, límites), consulta Solución de problemas de push.

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

Empieza aquí: identifica tu síntoma

Busca el comportamiento que estás observando en la tabla y luego sigue los pasos de esa sección. Si no estás seguro de qué sección aplica, usa la ruta de investigación estándar.

Síntoma Ir a
Push no recibido en una plataforma Selecciona la pestaña de tu SDK en Solución de problemas específica de la plataforma
Los saltos de línea alrededor de las etiquetas de Liquid se ven mal al guardar Saltos de línea en notificaciones push
Verificaciones de entrega en el panel (suscripción, Segment, límites) Solución de problemas de push
El vínculo profundo desde push no se abre correctamente Solución de problemas de vinculación en profundidad
Códigos de error push comunes Mensajes de error push comunes

Ruta de investigación estándar

Usa este flujo de trabajo para cada incidente de notificación push. Empieza en el paso 1.

  1. Confirma que el dispositivo tiene un token de notificaciones push válido y que el permiso push está concedido en la configuración del dispositivo.
  2. En el panel, confirma que el usuario de prueba coincide con el Segment de la Campaign o Canvas y que no está en el grupo de control.
  3. Envía una notificación push de prueba al dispositivo de prueba.
  4. Habilita el registro detallado, reproduce el problema y revisa la guía específica de la plataforma en tu pestaña del SDK.
  5. Si el problema persiste, ponte en contacto con soporte de Braze con los registros detallados, la plataforma, la versión del SDK y el ID de la Campaign o Canvas.

Solución de problemas específica de la plataforma

Selecciona la pestaña de tu SDK para verificaciones de configuración y visualización específicas de la plataforma.

Solución de problemas

Si tienes problemas después de configurar las notificaciones push, ten en cuenta lo siguiente:

  • Las notificaciones push web requieren que tu sitio sea HTTPS.
  • No todos los navegadores pueden recibir mensajes push. Asegúrate de que braze.isPushSupported() devuelva true en el navegador.
  • Algunos navegadores, como Firefox, no muestran imágenes en las notificaciones push. Para más detalles sobre la compatibilidad de navegadores, consulta la documentación de MDN sobre imágenes de Notification.
  • Si un usuario ha denegado el acceso push a un sitio, no se le volverá a solicitar permiso a menos que elimine el estado de denegación de las preferencias de su navegador.

Comprender el flujo de trabajo push de Braze

El servicio de mensajería en la nube de Firebase (FCM) es la infraestructura de Google para las notificaciones push enviadas a las aplicaciones de Android. Esta es la estructura simplificada de cómo se habilitan las notificaciones push para los dispositivos de tus usuarios y cómo Braze puede enviarles notificaciones push:

---
config:
  theme: mc
---
sequenceDiagram
  participant Device as User Device
  participant App as Android App
  participant BrazeSDK as Braze SDK
  participant BrazeAPI as Braze Server
  participant Firebase as Google Firebase
  Note over Device, Firebase: Register Option 1<br/>Register Automatically using `com_braze_firebase_cloud_messaging_registration_enabled` in braze.xml
  App ->> Braze: App initializes Braze with the first Braze call<br>This could be automatic session handling
  BrazeSDK ->> App: Get push token from Firebase Manager
  BrazeSDK ->> BrazeAPI: Send push token to Braze Server
  Note right of BrazeAPI: Braze will remove push token from any<br>other user who may have previously<br> been logged in on the same device.
  Note over Device, Firebase: Register Option 2<br/>Manual registration.
  App ->> BrazeSDK: App sets `Braze.registeredPushToken`
  BrazeSDK ->> BrazeAPI: Send push token to Braze Server
  Note right of BrazeAPI: Braze will remove push token from any<br>other user who may have previously<br> been logged in on the same device.
  Note over Device, Firebase: Push permission
  BrazeAPI ->> BrazeSDK: In-App Message containing push prompt
  BrazeSDK -> App: In-App Message is displayed
  App -> BrazeSDK: User requests permissions
  BrazeSDK -> App: Displays the Push Authorization prompt
  BrazeSDK -> BrazeAPI: If authorized and `com_braze_optin_when_push_authorized`, Opt-In value is sent.
  Note over Device, Firebase: Push Notification Is Sent
  BrazeAPI ->> Firebase: Sends push message
  Firebase ->> Device: Push message sent
  Device ->> App: Android will send the push to the App.<br>This could be blocked to Do Not Disturb, Power Saving Mode, etc.
  App ->> BrazeSDK: Message is sent to BrazeFirebaseMessagingService
  BrazeSDK ->> Device: SDK will check if the push is from Braze.<br>If so, push data is transformed into a Push Notification and displayed.

Paso 1: Configurar tu clave de API de Google Cloud

Al desarrollar tu aplicación, tendrás que proporcionar al SDK de Android de Braze tu ID de remitente de Firebase. Además, tendrás que proporcionar al panel de Braze una clave de API para aplicaciones de servidor. Braze utilizará esta clave de API para enviar mensajes a tus dispositivos. También tendrás que comprobar que el servicio FCM está habilitado en la consola para desarrolladores de Google.

Paso 2: Los dispositivos se registran en FCM y proporcionan a Braze tokens de notificaciones push

En las integraciones típicas, el SDK de Android de Braze se encargará de registrar los dispositivos para la función FCM. Esto suele ocurrir inmediatamente después de abrir la aplicación por primera vez. Tras el registro, Braze recibirá un ID de registro de FCM, que se utiliza para enviar mensajes a ese dispositivo en concreto. Almacenaremos el ID de registro de ese usuario, y ese usuario se convertirá en “registrado push” si antes no tenía un token de notificaciones push para ninguna de tus aplicaciones.

Paso 3: Lanzamiento de una Campaign push de Braze

Cuando se lance una Campaign push, Braze hará solicitudes a FCM para que entregue tu mensaje. Braze utilizará la clave de API copiada en el panel para autenticar y verificar que podemos enviar notificaciones push a los tokens de notificaciones push proporcionados.

Paso 4: Eliminar tokens no válidos

Si FCM nos informa de que alguno de los tokens de notificaciones push a los que intentábamos enviar un mensaje no es válido, eliminamos esos tokens de los perfiles de usuario a los que estaban asociados. Si los usuarios no tienen otros tokens de notificaciones push, ya no aparecerán como “Registrados push” en la página Segments.

Para más detalles sobre FCM, visita Mensajería en la nube.

Utilizar los registros de errores push

Braze proporciona errores de notificación push dentro del registro de actividad de mensajes. Este registro de errores proporciona una serie de advertencias que pueden ser muy útiles para identificar por qué tus campañas no funcionan como esperabas. Si seleccionas un mensaje de error, se te redirigirá a la documentación pertinente para ayudarte a solucionar una incidencia concreta.

Registro de actividad de mensajes de Braze mostrando entradas de errores de notificaciones push.

Solución de problemas

Push no se envía

Puede que tus mensajes push no se envíen debido a las siguientes situaciones:

  • Tus credenciales existen en un ID de proyecto de Google Cloud Platform incorrecto (ID de remitente incorrecto).
  • Tus credenciales tienen un ámbito de permiso incorrecto.
  • Has cargado credenciales erróneas en el espacio de trabajo de Braze equivocado (ID de remitente incorrecto).

Para otros problemas que puedan impedirte enviar un mensaje push, consulta la Guía del usuario: Solución de problemas de notificaciones push.

No se muestran usuarios “registrados push” en el panel de Braze (antes de enviar mensajes)

Confirma que tu aplicación está correctamente configurada para permitir notificaciones push. Los puntos de fallo habituales que hay que comprobar incluyen lo siguiente:

ID de remitente incorrecto

Comprueba que el ID de remitente de FCM correcto está incluido en el archivo braze.xml. Un ID de remitente incorrecto dará lugar a errores de MismatchSenderID en el registro de actividad de mensajes del panel.

No se produce el registro de Braze

Dado que el registro de FCM se gestiona fuera de Braze, el fallo en el registro solo puede producirse en dos lugares:

  1. Durante el registro en FCM
  2. Al pasar el token de notificaciones push generado por FCM a Braze

Recomendamos establecer un punto de interrupción o de registro para confirmar que el token de notificaciones push generado por FCM se envía a Braze. Si un token no se genera correctamente o no se genera en absoluto, te recomendamos que consultes la documentación de FCM.

Los servicios de Google Play no están presentes

Para que FCM push funcione, Google Play Services debe estar presente en el dispositivo. Si Google Play Services no está en un dispositivo, no se producirá el registro push.

Dispositivo no conectado a Internet

Comprueba que tu dispositivo tiene una buena conexión a Internet y que no está enviando tráfico de red a través de un proxy.

Al tocar la notificación push no se abre la aplicación

Comprueba si com_braze_handle_push_deep_links_automatically está configurado como true o false. Para habilitar Braze para que abra automáticamente la aplicación y cualquier vínculo profundo al tocar una notificación push, configura com_braze_handle_push_deep_links_automatically en true en tu archivo braze.xml.

Si com_braze_handle_push_deep_links_automatically está configurado con su valor predeterminado de false, tienes que utilizar una devolución de llamada push de Braze para escuchar y gestionar las intenciones push recibidas y abiertas.

Notificaciones push rebotadas

Si no se entrega una notificación push, asegúrate de que no ha rebotado consultando la consola para desarrolladores. A continuación se describen errores comunes que pueden registrarse en la consola para desarrolladores:

Error: MismatchSenderID

MismatchSenderID indica un fallo de autenticación. Confirma que tu ID de remitente de Firebase y tu clave de API de FCM son correctos.

Error: InvalidRegistration

InvalidRegistration puede deberse a un token de notificaciones push mal formado.

  1. Asegúrate de pasar un token de notificaciones push válido a Braze desde Firebase Cloud Messaging.

Error: NotRegistered

  1. NotRegistered también puede ocurrir cuando se producen varios registros y un segundo registro invalida el primer token.

Notificaciones push enviadas pero no mostradas en los dispositivos de los usuarios

Hay algunas razones por las que esto podría estar ocurriendo:

Se forzó la salida de la aplicación

Si fuerzas la salida de tu aplicación a través de la configuración del sistema, no se enviarán tus notificaciones push. Si vuelves a iniciar la aplicación, tu dispositivo volverá a estar habilitado para recibir notificaciones push.

BrazeFirebaseMessagingService no registrado

El servicio BrazeFirebaseMessagingService debe estar correctamente registrado en AndroidManifest.xml para que aparezcan las notificaciones push:

1
2
3
4
5
6

<service android:name="com.braze.push.BrazeFirebaseMessagingService"
  android:exported="false">
  <intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT" />
  </intent-filter>
</service>

El cortafuegos bloquea el push

Si estás probando el push a través de Wi-Fi, puede que tu cortafuegos esté bloqueando los puertos necesarios para que FCM reciba mensajes. Confirma que los puertos 5228, 5229 y 5230 están abiertos. Además, como FCM no especifica sus IP, también debes permitir que tu cortafuegos acepte conexiones salientes a todas las direcciones IP contenidas en los bloques IP enumerados en el ASN de Google de 15169.

Fábrica de notificaciones personalizada que devuelve null

Si has implementado una fábrica de notificaciones personalizada, asegúrate de que no devuelve null. Esto hará que no se muestren las notificaciones.

Los usuarios “registrados push” ya no están habilitados después de enviar mensajes

Hay varias razones por las que esto puede estar ocurriendo:

Se ha desinstalado la aplicación

Los usuarios han desinstalado la aplicación. Esto invalidará su token de notificaciones push de FCM.

Clave inválida del servidor de Firebase Cloud Messaging

La clave del servidor de Firebase Cloud Messaging proporcionada en el panel de Braze no es válida. El ID de remitente proporcionado debe coincidir con el indicado en el archivo braze.xml de tu aplicación. La clave del servidor y el ID del remitente se encuentran aquí, en tu consola de Firebase:

La plataforma Firebase, en «Configuración» y luego en «Mensajería en la nube», mostrará el ID de tu servidor y la clave del servidor.

Los clics push no se registran

Si no se registran los clics push, es posible que los datos de los clics push aún no se hayan enviado a nuestros servidores. El SDK de Android de Braze puede regular la frecuencia de los envíos.

Si implementaste un controlador push personalizado, asegúrate de que estás preservando correctamente los análisis push nativos.

El registro de clics push es una operación de red y está sujeto a las limitaciones de la red. Por ello, aunque el SDK de Android de Braze intenta adaptarse a los fallos de red y reintenta las solicitudes fallidas, es de esperar cierta pérdida de eventos.

Los vínculos profundos pueden probarse con ADB. Te recomendamos que pruebes tu vínculo profundo con el siguiente comando:

adb shell am start -W -a android.intent.action.VIEW -d "THE_DEEP_LINK" THE_PACKAGE_NAME

Si el vínculo profundo no funciona, es posible que esté mal configurado. Un vínculo profundo mal configurado no funcionará cuando se envíe a través de notificaciones push de Braze.

Verificar la lógica de gestión personalizada

Si el vínculo profundo funciona correctamente con ADB pero no funciona desde Braze push, comprueba si se ha implementado alguna gestión personalizada de apertura de push. Si es así, comprueba que el código de gestión personalizado gestiona correctamente el vínculo profundo entrante.

Desactivar el comportamiento del back stack

Si el vínculo profundo funciona correctamente con ADB pero no funciona desde Braze push, prueba a desactivar el back stack. Para ello, actualiza tu archivo braze.xml para incluir:

1

<bool name="com_braze_push_deep_link_back_stack_activity_enabled">false</bool>

Comprender el flujo de trabajo de Braze/APN

El servicio de notificaciones push de Apple (APN) es la infraestructura para enviar notificaciones push a aplicaciones que se ejecutan en las plataformas de Apple. A continuación se muestra la estructura simplificada de cómo se habilitan las notificaciones push para los dispositivos de tus usuarios y cómo Braze puede enviarles notificaciones push:

  1. Configuras el certificado push y el perfil de aprovisionamiento
  2. Los dispositivos se registran en APN y proporcionan a Braze los tokens de notificaciones push
  3. Lanzas una Campaign push de Braze
  4. Braze elimina los tokens no válidos

Paso 1: Configurar el certificado push y el perfil de aprovisionamiento

Para desarrollar tu aplicación, crea un certificado SSL para habilitar las notificaciones push. Este certificado se incluye en el perfil de aprovisionamiento con el que se compila tu aplicación y también debe cargarse en el panel de Braze. El certificado permite a Braze indicar a APN que está autorizado para enviar notificaciones push en tu nombre.

Existen dos tipos de perfiles de aprovisionamiento y certificados: desarrollo y distribución. Recomendamos utilizar solo perfiles y certificados de distribución para evitar confusiones. Si decides utilizar perfiles y certificados diferentes para desarrollo y distribución, asegúrate de que el certificado cargado en el panel coincida con el perfil de aprovisionamiento que estás utilizando actualmente.

Paso 2: Los dispositivos se registran en APN y proporcionan a Braze los tokens de notificaciones push

Cuando los usuarios abren tu aplicación, se les solicita aceptar las notificaciones push. Si aceptan esta solicitud, APN genera un token de notificaciones push para ese dispositivo en particular. El SDK de Swift envía inmediata y asíncronamente el token de notificaciones push para las aplicaciones que utilizan la política de vaciado automático predeterminada. Una vez que tenemos un token de notificaciones push asociado a un usuario, aparecerá como “Push Registered” en el panel, en su perfil de usuario, en la pestaña Engagement, y será elegible para recibir notificaciones push de Campaigns de Braze.

Consideraciones para la generación de tokens de notificaciones push

  • Si los usuarios instalan tu aplicación en otro dispositivo, Braze crea y captura otro token de la misma manera.
  • Si los usuarios reinstalan tu aplicación, el SDK genera un nuevo token y lo pasa a Braze. Sin embargo, APN y Braze pueden seguir registrando el token original como válido.
  • Si los usuarios desinstalan tu aplicación, Braze no recibe una notificación inmediatamente, y el token sigue apareciendo como válido hasta que APN lo retira.
  • En algún momento, APN retira los tokens antiguos. Braze no controla ni tiene visibilidad sobre este proceso.

Paso 3: Lanzar una Campaign push de Braze

Cuando se lanza una Campaign push, Braze realiza solicitudes a APN para entregar tu mensaje. Específicamente, las solicitudes se pasan a APN para cada token de notificaciones push válido actual, a menos que se seleccione Send to a user’s most recent device. Después de que Braze recibe una respuesta exitosa de APN, Braze registra una entrega exitosa en el perfil del usuario, aunque es posible que el usuario no haya recibido el mensaje real por razones que incluyen:

  • Su dispositivo está apagado.
  • Su dispositivo no está conectado a internet (Wi-Fi o celular).
  • Recientemente desinstaló la aplicación.

Braze utiliza el certificado SSL push cargado en el panel para autenticarse y verificar que está autorizado para enviar notificaciones push a los tokens de notificaciones push proporcionados. Si un dispositivo está en línea, la notificación debería recibirse poco después de que se haya enviado la Campaign. Ten en cuenta que Braze establece la fecha de expiración predeterminada de APN para las notificaciones en 30 días.

Paso 4: Eliminar tokens no válidos

Si APN nos informa de que alguno de los tokens de notificaciones push a los que intentábamos enviar un mensaje no es válido, eliminamos esos tokens de los perfiles de usuario con los que estaban asociados.

Uso de los registros de errores push

El registro de actividad de mensajes te permite ver cualquier mensaje (especialmente mensajes de error) asociado con tus Campaigns y envíos, incluidos los errores de notificaciones push. Este registro de errores proporciona una variedad de advertencias que pueden ser muy útiles para identificar por qué tus Campaigns no funcionan como se esperaba. Al seleccionar un mensaje de error, se te redirige a la documentación relevante para ayudarte a solucionar un incidente en particular.

Registros de errores push que muestran la hora en que ocurrió el error, el nombre de la aplicación, el canal, el tipo de error y el mensaje de error.

Los errores comunes que podrías ver aquí incluyen notificaciones específicas del usuario, como “Received Unregistered Sending to Push Token”.

Además, Braze también proporciona un registro de cambios push en el perfil del usuario, en la pestaña Engagement. Este registro de cambios ofrece información sobre el comportamiento del registro push, como la invalidación de tokens, los errores de registro push, los tokens que se trasladan a nuevos usuarios, etc.

Pestaña Engagement del perfil de usuario de Braze que muestra el registro de cambios del registro push.

Errores del registro de actividad de mensajes

Received unregistered sending to push token

  • Asegúrate de que el token de notificaciones push que se envía a Braze desde el método AppDelegate.braze?.notifications.register(deviceToken:) sea válido. Puedes consultar el Message Activity Log para ver el token de notificaciones push. Debería tener un aspecto similar a 6e407a9be8d07f0cdeb9e724733a89445f57a89ec890d63867c482a483506fa6, una cadena larga que contiene una mezcla de letras y números. Si tu token de notificaciones push tiene un aspecto diferente, revisa tu código para enviar los tokens de notificaciones push a Braze.
  • Asegúrate de que tu perfil de aprovisionamiento push coincida con el entorno en el que estás probando. Los certificados universales pueden configurarse en el panel de Braze para enviar al entorno de APN de desarrollo o producción. Usar un certificado de desarrollo para una aplicación de producción o un certificado de producción para una aplicación de desarrollo no funcionará.
  • Comprueba que el token de notificaciones push que has cargado en Braze coincida con el perfil de aprovisionamiento que utilizaste para compilar la aplicación desde la que enviaste el token de notificaciones push.

Device token not for topic

APN devuelve DeviceTokenNotForTopic (estado HTTP 400) cuando el token de notificaciones push no coincide con el topic (bundle ID) configurado para tus credenciales. Braze puede mostrar esto en el Message Activity Log o en los registros de entrega push como DeviceTokenNotForTopic.

Para resolver la discrepancia:

  1. Confirma que el bundle ID de la aplicación coincide con el App Bundle ID en Braze (Configuración > Configuración de la aplicación > Push Notification Settings).
  2. Verifica que el perfil de aprovisionamiento utilizado para compilar la aplicación incluya la capacidad push para ese bundle ID.
  3. Confirma que la credencial push cargada en Braze coincide con el entorno de la aplicación (desarrollo frente a producción).
  4. Para claves .p8, verifica que el Team ID y el Key ID en Braze coincidan con tu cuenta de Apple Developer.
  5. Vuelve a cargar una clave .p8 válida o un certificado .p12 si las credenciales fueron rotadas o revocadas.

Prefiere las claves de autenticación .p8 cuando sea posible. Para tipos de credenciales e indicadores de estado del panel, consulta Migrar a una clave de autenticación .p8.

BadDeviceToken sending to push token

El BadDeviceToken es un código de error de APN y no se origina en Braze. Puede haber varias razones por las que se devuelve esta respuesta, entre ellas las siguientes:

  • La aplicación recibió un token de notificaciones push que no era válido para las credenciales cargadas en el panel.
  • Las notificaciones push estaban desactivadas para este espacio de trabajo.
  • El usuario ha rechazado las notificaciones push.
  • La aplicación fue desinstalada.
  • Apple actualizó el token de notificaciones push, lo que invalidó el token anterior.
  • La aplicación se compiló para un entorno de producción, pero las credenciales push cargadas en Braze están configuradas para un entorno de desarrollo (o viceversa).

Problemas de registro push

No aparece la solicitud de registro push

Si la aplicación no te solicita registrarte para notificaciones push, es probable que haya un problema con tu integración de registro push. Asegúrate de haber seguido nuestra documentación e integrado correctamente nuestro registro push. También puedes establecer puntos de interrupción en tu código para asegurarte de que el código de registro push se está ejecutando.

No aparecen usuarios “push registered” en el panel (antes de enviar mensajes)

Asegúrate de que tu aplicación esté correctamente configurada para permitir notificaciones push. Los puntos de fallo comunes a verificar incluyen:

  • Comprueba que tu aplicación te solicita permitir las notificaciones push. Normalmente, esta solicitud aparecerá en la primera apertura de la aplicación, pero puede programarse para que aparezca en otro lugar. Si no aparece donde debería, el problema probablemente esté en la configuración básica de las capacidades push de tu aplicación.
    • Verifica que los pasos de integración push se hayan completado correctamente.
    • Comprueba que el perfil de aprovisionamiento con el que se compiló tu aplicación incluya permisos para push. Asegúrate de que estás descargando todos los perfiles de aprovisionamiento disponibles de tu cuenta de desarrollador de Apple. Para confirmarlo, realiza los siguientes pasos:
      1. En Xcode, ve a Preferences > Accounts (o usa el atajo de teclado Command+,).
      2. Selecciona el Apple ID que usas para tu cuenta de desarrollador y haz clic en View Details.
      3. En la siguiente página, haz clic en Refresh y confirma que estás descargando todos los perfiles de aprovisionamiento disponibles.
  • Comprueba que has habilitado correctamente la capacidad push en tu aplicación.
  • Comprueba que tu perfil de aprovisionamiento push coincida con el entorno en el que estás probando. Los certificados universales pueden configurarse en el panel de Braze para enviar al entorno de APN de desarrollo o producción. Usar un certificado de desarrollo para una aplicación de producción o un certificado de producción para una aplicación de desarrollo no funcionará.
  • Comprueba que estás llamando a nuestro método registerPushToken estableciendo un punto de interrupción en tu código.
  • Asegúrate de que estás probando con un dispositivo (push no funcionará en un simulador) y de que tienes buena conectividad de red.

Notificaciones push enviadas pero no mostradas en los dispositivos de los usuarios

Los usuarios “push registered” ya no están habilitados después de enviar mensajes

Esto probablemente indica que el usuario tenía un token de notificaciones push no válido. Esto puede ocurrir por varias razones:

Discrepancia entre el certificado del panel y la aplicación

Si el certificado push que cargaste en el panel no es el mismo que está en el perfil de aprovisionamiento con el que se compiló tu aplicación, APN rechazará el token. Verifica que has cargado el certificado correcto y completa otra sesión en la aplicación antes de intentar otra notificación de prueba.

La aplicación fue desinstalada

Si un usuario ha desinstalado tu aplicación, su token de notificaciones push será inválido y se eliminará en el siguiente envío.

Regenerar tu perfil de aprovisionamiento

Como último recurso, empezar de cero y crear un perfil de aprovisionamiento completamente nuevo puede resolver errores de configuración que surgen al trabajar con múltiples entornos, perfiles y aplicaciones al mismo tiempo. Hay muchas “piezas móviles” en la configuración de las notificaciones push, por lo que a veces es mejor volver a intentarlo desde el principio. Esto también ayudará a aislar el problema si necesitas continuar con la solución de problemas.

Mensajes no entregados a usuarios “push registered”

La aplicación está en primer plano

En las versiones de iOS que no integran push a través del framework UserNotifications, si la aplicación está en primer plano cuando se recibe el mensaje push, no se mostrará. Debes poner la aplicación en segundo plano en tus dispositivos de prueba antes de enviar mensajes de prueba.

Notificación de prueba programada incorrectamente

Comprueba la programación que estableciste para tu mensaje de prueba. Si está configurada para entrega en zona horaria local o sincronización inteligente, es posible que simplemente aún no hayas recibido el mensaje (o que la aplicación estuviera en primer plano cuando se recibió).

El usuario no está “push registered” para la aplicación que se está probando

Comprueba el perfil del usuario al que intentas enviar un mensaje de prueba. En la pestaña Engagement, debería haber una lista de “pushable apps”. Verifica que la aplicación a la que intentas enviar mensajes de prueba esté en esta lista. Los usuarios aparecerán como “Push Registered” si tienen un token de notificaciones push para cualquier aplicación en tu espacio de trabajo, por lo que esto podría ser un falso positivo.

Lo siguiente indicaría un problema con el registro push o que el token del usuario fue devuelto a Braze como no válido por APN después de haber sido enviado:

Un perfil de usuario que muestra la configuración de contacto de un usuario. En Push, se muestra "No Apps".

Los clics en push no se registran

  • Asegúrate de haber seguido los pasos de integración push.
  • Braze no gestiona las notificaciones push recibidas silenciosamente en primer plano (comportamiento predeterminado de push en primer plano antes del framework UserNotifications). Esto significa que los enlaces no se abrirán y los clics en push no se registrarán. Si tu aplicación aún no ha integrado el framework UserNotifications, Braze no gestionará las notificaciones push cuando el estado de la aplicación sea UIApplicationStateActive. Asegúrate de que tu aplicación no retrase las llamadas a los métodos de gestión push; de lo contrario, el SDK de Swift puede tratar las notificaciones push como eventos push silenciosos en primer plano y no gestionarlos.

Para una solución de problemas integral en todos los canales, incluidos los enlaces universales, esquemas personalizados, correo electrónico y proveedores de terceros como Branch, consulta Solución de problemas de vinculación en profundidad.

Los enlaces en las notificaciones push deben cumplir con ATS para poder abrirse en vistas web. Asegúrate de que tus enlaces web utilicen HTTPS. Para más información, consulta Cumplimiento de ATS.

La mayor parte del código que gestiona los vínculos profundos también gestiona las aperturas push. Primero, asegúrate de que las aperturas push se estén registrando. Si no es así, soluciona ese problema (ya que la solución a menudo también corrige la gestión de enlaces).

Si las aperturas se están registrando, comprueba si se trata de un problema con el vínculo profundo en general o con la gestión de clics push de vinculación en profundidad. Para ello, prueba si un vínculo profundo desde un clic en un mensaje dentro de la aplicación funciona.

Comprender el flujo de trabajo push de Braze

El servicio de mensajería en la nube de Firebase (FCM) es la infraestructura de Google para las notificaciones push enviadas a las aplicaciones de Android. Esta es la estructura simplificada de cómo se habilitan las notificaciones push para los dispositivos de tus usuarios y cómo Braze puede enviarles notificaciones push:

---
config:
  theme: mc
---
sequenceDiagram
  participant Device as User Device
  participant App as Android App
  participant BrazeSDK as Braze SDK
  participant BrazeAPI as Braze Server
  participant Firebase as Google Firebase
  Note over Device, Firebase: Register Option 1<br/>Register Automatically using `com_braze_firebase_cloud_messaging_registration_enabled` in braze.xml
  App ->> Braze: App initializes Braze with the first Braze call<br>This could be automatic session handling
  BrazeSDK ->> App: Get push token from Firebase Manager
  BrazeSDK ->> BrazeAPI: Send push token to Braze Server
  Note right of BrazeAPI: Braze will remove push token from any<br>other user who may have previously<br> been logged in on the same device.
  Note over Device, Firebase: Register Option 2<br/>Manual registration.
  App ->> BrazeSDK: App sets `Braze.registeredPushToken`
  BrazeSDK ->> BrazeAPI: Send push token to Braze Server
  Note right of BrazeAPI: Braze will remove push token from any<br>other user who may have previously<br> been logged in on the same device.
  Note over Device, Firebase: Push permission
  BrazeAPI ->> BrazeSDK: In-App Message containing push prompt
  BrazeSDK -> App: In-App Message is displayed
  App -> BrazeSDK: User requests permissions
  BrazeSDK -> App: Displays the Push Authorization prompt
  BrazeSDK -> BrazeAPI: If authorized and `com_braze_optin_when_push_authorized`, Opt-In value is sent.
  Note over Device, Firebase: Push Notification Is Sent
  BrazeAPI ->> Firebase: Sends push message
  Firebase ->> Device: Push message sent
  Device ->> App: Android will send the push to the App.<br>This could be blocked to Do Not Disturb, Power Saving Mode, etc.
  App ->> BrazeSDK: Message is sent to BrazeFirebaseMessagingService
  BrazeSDK ->> Device: SDK will check if the push is from Braze.<br>If so, push data is transformed into a Push Notification and displayed.

Paso 1: Configurar tu clave de API de Google Cloud

Al desarrollar tu aplicación, tendrás que proporcionar al SDK de Android de Braze tu ID de remitente de Firebase. Además, tendrás que proporcionar al panel de Braze una clave de API para aplicaciones de servidor. Braze utilizará esta clave de API para enviar mensajes a tus dispositivos. También tendrás que comprobar que el servicio FCM está habilitado en la consola para desarrolladores de Google.

Paso 2: Los dispositivos se registran en FCM y proporcionan a Braze tokens de notificaciones push

En las integraciones típicas, el SDK de Android de Braze se encargará de registrar los dispositivos para la función FCM. Esto suele ocurrir inmediatamente después de abrir la aplicación por primera vez. Tras el registro, Braze recibirá un ID de registro de FCM, que se utiliza para enviar mensajes a ese dispositivo en concreto. Almacenaremos el ID de registro de ese usuario, y ese usuario se convertirá en “registrado push” si antes no tenía un token de notificaciones push para ninguna de tus aplicaciones.

Paso 3: Lanzamiento de una Campaign push de Braze

Cuando se lance una Campaign push, Braze hará solicitudes a FCM para que entregue tu mensaje. Braze utilizará la clave de API copiada en el panel para autenticar y verificar que podemos enviar notificaciones push a los tokens de notificaciones push proporcionados.

Paso 4: Eliminar tokens no válidos

Si FCM nos informa de que alguno de los tokens de notificaciones push a los que intentábamos enviar un mensaje no es válido, eliminamos esos tokens de los perfiles de usuario a los que estaban asociados. Si los usuarios no tienen otros tokens de notificaciones push, ya no aparecerán como “Registrados push” en la página Segments.

Para más detalles sobre FCM, visita Mensajería en la nube.

Utilizar los registros de errores push

Braze proporciona errores de notificación push dentro del registro de actividad de mensajes. Este registro de errores proporciona una serie de advertencias que pueden ser muy útiles para identificar por qué tus campañas no funcionan como esperabas. Si seleccionas un mensaje de error, se te redirigirá a la documentación pertinente para ayudarte a solucionar una incidencia concreta.

Registro de actividad de mensajes de Braze mostrando entradas de errores de notificaciones push.

Solución de problemas

Push no se envía

Puede que tus mensajes push no se envíen debido a las siguientes situaciones:

  • Tus credenciales existen en un ID de proyecto de Google Cloud Platform incorrecto (ID de remitente incorrecto).
  • Tus credenciales tienen un ámbito de permiso incorrecto.
  • Has cargado credenciales erróneas en el espacio de trabajo de Braze equivocado (ID de remitente incorrecto).

Para otros problemas que puedan impedirte enviar un mensaje push, consulta la Guía del usuario: Solución de problemas de notificaciones push.

No se muestran usuarios “registrados push” en el panel de Braze (antes de enviar mensajes)

Confirma que tu aplicación está correctamente configurada para permitir notificaciones push. Los puntos de fallo habituales que hay que comprobar incluyen lo siguiente:

ID de remitente incorrecto

Comprueba que el ID de remitente de FCM correcto está incluido en el archivo braze.xml. Un ID de remitente incorrecto dará lugar a errores de MismatchSenderID en el registro de actividad de mensajes del panel.

No se produce el registro de Braze

Dado que el registro de FCM se gestiona fuera de Braze, el fallo en el registro solo puede producirse en dos lugares:

  1. Durante el registro en FCM
  2. Al pasar el token de notificaciones push generado por FCM a Braze

Recomendamos establecer un punto de interrupción o de registro para confirmar que el token de notificaciones push generado por FCM se envía a Braze. Si un token no se genera correctamente o no se genera en absoluto, te recomendamos que consultes la documentación de FCM.

Los servicios de Google Play no están presentes

Para que FCM push funcione, Google Play Services debe estar presente en el dispositivo. Si Google Play Services no está en un dispositivo, no se producirá el registro push.

Dispositivo no conectado a Internet

Comprueba que tu dispositivo tiene una buena conexión a Internet y que no está enviando tráfico de red a través de un proxy.

Al tocar la notificación push no se abre la aplicación

Comprueba si com_braze_handle_push_deep_links_automatically está configurado como true o false. Para habilitar Braze para que abra automáticamente la aplicación y cualquier vínculo profundo al tocar una notificación push, configura com_braze_handle_push_deep_links_automatically en true en tu archivo braze.xml.

Si com_braze_handle_push_deep_links_automatically está configurado con su valor predeterminado de false, tienes que utilizar una devolución de llamada push de Braze para escuchar y gestionar las intenciones push recibidas y abiertas.

Notificaciones push rebotadas

Si no se entrega una notificación push, asegúrate de que no ha rebotado consultando la consola para desarrolladores. A continuación se describen errores comunes que pueden registrarse en la consola para desarrolladores:

Error: MismatchSenderID

MismatchSenderID indica un fallo de autenticación. Confirma que tu ID de remitente de Firebase y tu clave de API de FCM son correctos.

Error: InvalidRegistration

InvalidRegistration puede deberse a un token de notificaciones push mal formado.

  1. Asegúrate de pasar un token de notificaciones push válido a Braze desde Firebase Cloud Messaging.

Error: NotRegistered

  1. NotRegistered también puede ocurrir cuando se producen varios registros y un segundo registro invalida el primer token.

Notificaciones push enviadas pero no mostradas en los dispositivos de los usuarios

Hay algunas razones por las que esto podría estar ocurriendo:

Se forzó la salida de la aplicación

Si fuerzas la salida de tu aplicación a través de la configuración del sistema, no se enviarán tus notificaciones push. Si vuelves a iniciar la aplicación, tu dispositivo volverá a estar habilitado para recibir notificaciones push.

BrazeFirebaseMessagingService no registrado

El servicio BrazeFirebaseMessagingService debe estar correctamente registrado en AndroidManifest.xml para que aparezcan las notificaciones push:

1
2
3
4
5
6

<service android:name="com.braze.push.BrazeFirebaseMessagingService"
  android:exported="false">
  <intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT" />
  </intent-filter>
</service>

El cortafuegos bloquea el push

Si estás probando el push a través de Wi-Fi, puede que tu cortafuegos esté bloqueando los puertos necesarios para que FCM reciba mensajes. Confirma que los puertos 5228, 5229 y 5230 están abiertos. Además, como FCM no especifica sus IP, también debes permitir que tu cortafuegos acepte conexiones salientes a todas las direcciones IP contenidas en los bloques IP enumerados en el ASN de Google de 15169.

Fábrica de notificaciones personalizada que devuelve null

Si has implementado una fábrica de notificaciones personalizada, asegúrate de que no devuelve null. Esto hará que no se muestren las notificaciones.

Los usuarios “registrados push” ya no están habilitados después de enviar mensajes

Hay varias razones por las que esto puede estar ocurriendo:

Se ha desinstalado la aplicación

Los usuarios han desinstalado la aplicación. Esto invalidará su token de notificaciones push de FCM.

Clave inválida del servidor de Firebase Cloud Messaging

La clave del servidor de Firebase Cloud Messaging proporcionada en el panel de Braze no es válida. El ID de remitente proporcionado debe coincidir con el indicado en el archivo braze.xml de tu aplicación. La clave del servidor y el ID del remitente se encuentran aquí, en tu consola de Firebase:

La plataforma Firebase, en «Configuración» y luego en «Mensajería en la nube», mostrará el ID de tu servidor y la clave del servidor.

Los clics push no se registran

Si no se registran los clics push, es posible que los datos de los clics push aún no se hayan enviado a nuestros servidores. El SDK de Android de Braze puede regular la frecuencia de los envíos.

Si implementaste un controlador push personalizado, asegúrate de que estás preservando correctamente los análisis push nativos.

El registro de clics push es una operación de red y está sujeto a las limitaciones de la red. Por ello, aunque el SDK de Android de Braze intenta adaptarse a los fallos de red y reintenta las solicitudes fallidas, es de esperar cierta pérdida de eventos.

Los vínculos profundos pueden probarse con ADB. Te recomendamos que pruebes tu vínculo profundo con el siguiente comando:

adb shell am start -W -a android.intent.action.VIEW -d "THE_DEEP_LINK" THE_PACKAGE_NAME

Si el vínculo profundo no funciona, es posible que esté mal configurado. Un vínculo profundo mal configurado no funcionará cuando se envíe a través de notificaciones push de Braze.

Verificar la lógica de gestión personalizada

Si el vínculo profundo funciona correctamente con ADB pero no funciona desde Braze push, comprueba si se ha implementado alguna gestión personalizada de apertura de push. Si es así, comprueba que el código de gestión personalizado gestiona correctamente el vínculo profundo entrante.

Desactivar el comportamiento del back stack

Si el vínculo profundo funciona correctamente con ADB pero no funciona desde Braze push, prueba a desactivar el back stack. Para ello, actualiza tu archivo braze.xml para incluir:

1

<bool name="com_braze_push_deep_link_back_stack_activity_enabled">false</bool>

Solución de problemas

Tocar una notificación push no abre la aplicación

En Android, si tocar una notificación push lleva automáticamente tu aplicación al primer plano y abre su vínculo profundo depende del indicador nativo com_braze_handle_push_deep_links_automatically, que por defecto es false.

Con el valor predeterminado de false:

  • El SDK nativo sigue enviando una difusión BRAZE_PUSH_CLICKED y tu listener Dart push_opened sigue activándose como se espera.
  • El SDK nativo no llama a startActivity(), por lo que tu aplicación no se lleva al primer plano y el vínculo profundo no se sigue automáticamente.

Si estos dos comportamientos coinciden con lo que estás viendo, es probable que la configuración del indicador sea la causa. Para confirmarlo, revisa los registros de tu dispositivo en busca de una entrada BrazePushReceiver que gestione com.braze.action.BRAZE_PUSH_CLICKED, seguida de un evento push_opened en tus registros de Flutter, sin un lanzamiento de aplicación correspondiente.

Para solucionarlo, establece com_braze_handle_push_deep_links_automatically en true en tu braze.xml:

1

<bool name="com_braze_handle_push_deep_links_automatically">true</bool>

Para más información, consulta Añadir vínculos profundos (Android) en la guía de notificaciones push de Flutter.

Otros problemas de entrega push y registro

Dado que el SDK de Braze para Flutter en Android está construido sobre el SDK nativo de Braze para Android, la mayoría de los demás problemas de entrega push, registro y logging (como discrepancias en el ID del remitente, ausencia de Google Play Services o que BrazeFirebaseMessagingService no esté registrado) también se aplican a las aplicaciones Flutter. Para más información, consulta la guía de solución de problemas nativa de Android.

Solución de problemas

Push no aparece después de cerrar la aplicación desde el selector de tareas

Si observas que las notificaciones push ya no aparecen después de cerrar la aplicación desde el selector de tareas, es probable que tu aplicación esté en modo Debug. .NET MAUI añade scaffolding en modo Debug que impide que las aplicaciones reciban push después de que su proceso sea terminado. Si ejecutas tu aplicación en modo Release, deberías ver push incluso después de cerrar la aplicación desde el selector de tareas.

La fábrica de notificaciones personalizada no se configura correctamente

Las fábricas de notificaciones personalizadas (y todos los delegados) deben extender Java.Lang.Object para funcionar correctamente a través de la división entre C# y Java. Consulta Xamarin sobre la implementación de interfaces Java para más información.

Saltos de línea en las notificaciones push

Al redactar notificaciones push con etiquetas de Liquid, los saltos de línea adyacentes a las etiquetas de Liquid se eliminan automáticamente antes de que se envíe el mensaje. En el creador de notificaciones push, estos saltos de línea se vuelven a añadir para que tu mensaje siga siendo legible mientras lo editas. Si notas saltos de línea alrededor de las etiquetas de Liquid al guardar tu mensaje, se trata de un comportamiento esperado.
New Stuff!