Solución de problemas

Comprender el flujo de trabajo Braze/APNs

El servicio de notificaciones push de Apple (APN) es la infraestructura de Apple para el envío de notificaciones push a las aplicaciones de iOS y OS X. 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:

1. Configura el certificado push y el perfil de aprovisionamiento
2. Los dispositivos se registran para APN y proporcionan a Braze tokens de notificaciones push
3. Lanza una campaña push de Braze
4. Braze elimina los tokens no válidos

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

Al desarrollar tu aplicación, tendrás que crear un certificado SSL para habilitar las notificaciones push. Este certificado se incluirá en el perfil de aprovisionamiento con el que se cree tu aplicación y también deberá cargarse en el panel de Braze. El certificado permite a Braze indicar a los APN que estamos autorizados a enviar notificaciones push en tu nombre.

Hay dos tipos de perfiles de aprovisionamiento y certificados: de desarrollo y de distribución. Recomendamos utilizar sólo perfiles de distribución y certificados para evitar confusiones. Si decides utilizar perfiles y certificados diferentes para el desarrollo y la distribución, asegúrate de que el certificado cargado en el panel coincide con el perfil de aprovisionamiento que utilizas actualmente.

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

Cuando los usuarios abran tu aplicación, se les pedirá que acepten notificaciones push. Si aceptan esta indicación, los APN generarán un token de notificaciones push para ese dispositivo concreto. El SDK de iOS enviará de forma inmediata y asíncrona el token de notificaciones push para las aplicaciones que utilicen la política predeterminada de descarga automática. Una vez que tengamos un token de notificaciones push asociado a un usuario, aparecerá como “Registrado push” en el panel de su perfil de usuario, en la pestaña de interacción, y será elegible para recibir notificaciones push de las campañas Braze.

Paso 3: Lanzamiento de una campaña push Braze

Cuando se lance una campaña push, Braze hará peticiones a los APN para que entreguen tu mensaje. Braze utilizará el certificado SSL push cargado en el panel para autenticar y verificar que se nos permite 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 campaña. Ten en cuenta que Braze establece la fecha de caducidad predeterminada de los 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 a los que estaban asociados.

Utilizar los registros de errores push

Braze proporciona un registro de 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 haces clic en un mensaje de error, se te redirigirá a la documentación pertinente para ayudarte a solucionar una incidencia concreta.

Los errores comunes que puedes ver aquí incluyen notificaciones específicas del usuario, como “Recibido no registrado enviando a token de notificaciones push”.

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

Problemas de registro push

Para añadir verificación a la lógica de registro push de tu aplicación, implementa pruebas unitarias push.

No hay aviso de registro push

Si la aplicación no te pide que te registres para recibir notificaciones push, es probable que haya un problema con tu integración de registro push. Asegúrate de que has 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 se muestran los usuarios “push registrados” en el panel de control

• Comprueba que tu aplicación te pide que permitas las notificaciones push. Normalmente, este mensaje aparecerá la primera vez que abras la aplicación, pero puedes programarlo para que aparezca en cualquier otro momento. Si no aparece donde debería, es probable que el problema esté en la configuración básica de las capacidades push de tu aplicación.
  • Comprueba que los pasos para la integración push se han completado correctamente.
  • Comprueba que el perfil de aprovisionamiento con el que se creó tu aplicación incluye permisos para push. Asegúrate de que obtienes 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 (Preferencias > Cuentas) (o utiliza el atajo de teclado Comando+,).
    2. Selecciona el ID de Apple que utilizas para tu cuenta de desarrollador y haz clic en Ver detalles.
    3. En la página siguiente, haz clic en Actualizar y confirma que estás extrayendo todos los perfiles de aprovisionamiento disponibles.
• Comprueba que has habilitado correctamente la función push en tu aplicación.
• Comprueba que tu perfil de aprovisionamiento push coincide con el entorno en el que estás realizando las pruebas. Los certificados universales pueden configurarse en el panel de Braze para enviarlos al entorno de APN de desarrollo o de producción. Utilizar un certificado de desarrollador 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.
• Comprueba que estás en un dispositivo (push no funcionará en un simulador) y que tienes una buena conectividad de red.

Dispositivos que no reciben notificaciones push

Los usuarios ya no se “registran por push” tras enviar una notificación push

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

Desajuste entre el panel y el certificado de la aplicación

Si el certificado push que has cargado en el panel no es el mismo que el del perfil de aprovisionamiento con el que se creó tu aplicación, las APN rechazarán el token. Comprueba que has cargado el certificado correcto y que has completado otra sesión en la aplicación antes de intentar otra notificación de prueba.

Desinstalaciones

Si un usuario ha desinstalado tu aplicación, su token de notificaciones push no será vá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 eliminar los errores de configuración que se producen al trabajar con varios entornos, perfiles y aplicaciones al mismo tiempo. Hay muchas “partes móviles” en la configuración de las notificaciones push para aplicaciones de iOS, así que a veces es mejor volver a intentarlo desde el principio. Esto también te ayudará a aislar el problema si necesitas continuar con la solución de problemas.

Los usuarios siguen siendo “registrados para push” tras enviar una notificación push

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, éste 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 has establecido para tu mensaje de prueba. Si está configurada como entrega según la zona horaria local o Intelligent Timing, es posible que aún no hayas recibido el mensaje (o que tuvieras la aplicación en primer plano cuando lo recibiste).

Usuario no “registrado para push” para la aplicación que se está probando

Comprueba el perfil de usuario del usuario al que intentas enviar un mensaje de prueba. En la pestaña “Interacción”, debería haber una lista de “aplicaciones pushables”. Comprueba que la aplicación a la que intentas enviar mensajes de prueba está en esta lista. Los usuarios aparecerán como “Registrados push” si tienen un token de notificaciones push para cualquier aplicación de tu espacio de trabajo, por lo que podría tratarse de un falso positivo.

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

No se envían mensajes push

Para solucionar problemas de notificaciones push que no se envían, consulta Solución de problemas push.

Errores del registro de actividad de mensajes

Se recibió envío no registrado a token de notificaciones push

• Asegúrate de que el token de notificaciones push que se envía a Braze desde el método [[Appboy sharedInstance] registerPushToken:] es válido. Puedes mirar en el Registro de actividad de mensajes para ver el token de notificaciones push. Debería parecerse a 6e407a9be8d07f0cdeb9e724733a89445f57a89ec890d63867c482a483506fa6, una cadena larga que contiene una mezcla de letras y números. Si tu token de notificaciones push tiene un aspecto diferente, comprueba tu código para enviar a Braze los tokens de notificaciones push.
• Asegúrate de que tu perfil de aprovisionamiento push coincide con el entorno que estás probando. Los certificados universales pueden configurarse en el panel de Braze para enviarlos al entorno de APN de desarrollo o de producción. Utilizar un certificado de desarrollador 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 coincide con el perfil de aprovisionamiento que utilizaste para crear la aplicación desde la que enviaste el token de notificaciones push.

Token de dispositivo no para el tema

Este error indica que el certificado push y el ID de paquete de tu aplicación no coinciden. Comprueba que el certificado push que subiste a Braze coincide con el perfil de aprovisionamiento utilizado para crear la aplicación desde la que se envió el token de notificaciones push.

BadDeviceToken enviando a token de notificaciones push

El BadDeviceToken es un código de error de APNs y no tiene su origen en Braze. Puede haber varias razones para que se devuelva 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.
• Se ha desactivado la función push en este espacio de trabajo.
• El usuario ha optado por no recibir push.
• La aplicación fue desinstalada.
• Apple actualizó el token de notificaciones push, lo que invalidó el token antiguo.
• La aplicación se creó para un entorno de producción, pero las credenciales push cargadas en Braze están configuradas para un entorno de desarrollo (o al revés).

Problemas tras la entrega push

Para añadir verificación a la gestión push de tu aplicación, implementa pruebas unitarias push.

Los clics push no se registran

• Si esto sólo ocurre en iOS 10, asegúrate de que has seguido los pasos de integración push para iOS 10.
• Braze no gestiona las notificaciones push recibidas silenciosamente en primer plano (por ejemplo, el comportamiento push predeterminado en primer plano antes del marco UserNotifications ). Esto significa que los enlaces no se abrirán y los clics 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. Debes asegurarte de que tu aplicación no retrasa las llamadas a nuestros métodos de gestión push; de lo contrario, el SDK de iOS puede tratar las notificaciones push como eventos push silenciosos en primer plano y no gestionarlas.

Los enlaces Web de los clics push no se abren

iOS 9+ requiere que los enlaces sean compatibles con ATS para abrirlos en vistas Web. Asegúrate de que tus enlaces Web utilizan HTTPS. Consulta nuestro artículo sobre el cumplimiento de la ATS para obtener más información.

Los vínculos profundos de los clics push no se abren

La mayor parte del código que gestiona los vínculos en profundidad también gestiona las aperturas push. Primero, asegúrate de que se registran las aperturas push. Si no es así, soluciona ese problema (ya que la solución suele arreglar la gestión de enlaces).

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

Pocas o ninguna apertura directa

Si al menos un usuario abre tu notificación push de iOS, pero se registran pocas o ninguna Direct Opens en Braze, puede haber un problema con tu integración de SDK. Ten en cuenta que las Direct Opens no se registran en los envíos de prueba ni en las notificaciones push silenciosas.

• Asegúrate de que los mensajes no se envían como notificaciones push silenciosas. El mensaje debe tener texto en el título o en el cuerpo para que no se considere silencioso.
• Comprueba los siguientes pasos de la guía de integración push:
  • Regístrate para el push: En cada inicio de la aplicación, preferiblemente en application:didFinishLaunchingWithOptions:, debe aparecer el código del paso 3. La propiedad delegada de UNUserNotificationCenter.current() debe asignarse a un objeto que implemente UNUserNotificationCenterDelegate y contenga el método (void)userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler:.
  • Habilita la manipulación push: Comprueba que se ha aplicado el método (void)userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler:.