Ciclo de vida del token de notificaciones push
Este artículo cubre el proceso mediante el cual se asigna un token de notificaciones push a un usuario, y cómo Braze envía mensajes push a tus usuarios.
Acerca de los tokens de notificaciones push
Cuando una aplicación solicita permisos push a un dispositivo, el proveedor de servicios push del dispositivo genera un token de notificaciones push para esa aplicación. Cada aplicación recibe su propio token de notificaciones push único y anónimo, que es la forma en que identifica al dispositivo y a la instancia de la aplicación actual al enviar una notificación push.
Ten en cuenta que los tokens de notificaciones push no son identificadores estáticos que duran para siempre—pueden actualizarse y pueden caducar.
Para detalles específicos de cada plataforma, consulta Registro de tokens de notificaciones push.
Push en primer plano vs. en segundo plano
Los tokens de notificaciones push se utilizan para enviar tanto notificaciones push en primer plano como en segundo plano.
| Tipo | ¿Requiere adhesión voluntaria? | Descripción |
|---|---|---|
| Push en primer plano | Sí | Se muestra visiblemente una notificación al usuario mientras la aplicación está en primer plano. |
| Push en segundo plano | No | Una notificación se entrega silenciosamente en segundo plano sin mostrarse. Se utiliza a menudo para funcionalidades como Uninstall Tracking. |
Cuando un usuario acepta recibir notificaciones push de tu aplicación, se le considerará “registrado para push”, lo que significa que ahora puede ser segmentado utilizando el filtro de segmentación Foreground Push Enabled for App en Braze.
Esto es diferente del filtro de segmentación Foreground Push Enabled, que se utiliza para identificar a los usuarios que han aceptado recibir notificaciones push en al menos una de tus aplicaciones, no en una aplicación específica. Para más información, consulta Filtros de segmentación.
Múltiples usuarios en un dispositivo
Los tokens de notificaciones push son únicos tanto para el dispositivo como para la aplicación, lo que significa que los tokens de notificaciones push no pueden utilizarse para dirigirse a usuarios específicos si múltiples usuarios están usando el mismo dispositivo.
Por ejemplo, supongamos que tienes dos usuarios: Charlie y Kim. Si Charlie ha habilitado las notificaciones push para tu aplicación en su teléfono y Kim usa el teléfono de Charlie para cerrar la sesión del perfil de Charlie e iniciar sesión en el suyo, el token de notificaciones push se reasignará al perfil de Kim. El token de notificaciones push permanecerá asignado al perfil de Kim en ese dispositivo hasta que ella cierre sesión y Charlie vuelva a iniciar sesión.
Una aplicación o sitio web solo puede tener una suscripción push por dispositivo. Así que cuando un usuario cierra sesión en un dispositivo o sitio web, y un nuevo usuario inicia sesión, el token de notificaciones push se reasigna al nuevo usuario. Esto se refleja en el perfil del usuario en la sección Configuración de contacto de la pestaña Interacción:
Dado que no hay forma de que los proveedores push (APNs/FCM) distingan entre múltiples usuarios en un dispositivo, pasamos el token de notificaciones push al último usuario que inició sesión para determinar a qué usuario dirigirse en el dispositivo para push.
Si ves un mensaje de error en Configuración de contacto > Registro de cambios push, consulta Mensajes de error push comunes para obtener explicaciones y los pasos a seguir.
Registro de tokens de notificaciones push
Cada plataforma de dispositivo gestiona el registro de tokens de notificaciones push de forma diferente. Consulta lo siguiente para obtener detalles específicos de cada plataforma:
Debes solicitar la adhesión voluntaria explícita de los usuarios a través del cuadro de diálogo de permiso nativo del navegador. Recibirás un token una vez que los usuarios hayan optado por participar. A diferencia de iOS y Android, que permiten que tu aplicación muestre el aviso de permiso en cualquier momento, algunos navegadores modernos solo mostrarán el aviso si se desencadena mediante un “gesto del usuario” (clic del ratón o pulsación de tecla). Si tu sitio web intenta solicitar permiso de notificaciones push al cargar la página, es probable que el navegador lo ignore o lo silencie.
Cuando tu aplicación se instala, se genera automáticamente un token de notificaciones push para ella—sin embargo, solo se puede utilizar para notificaciones push en segundo plano hasta que el usuario haga la adhesión voluntaria explícitamente. Además, el registro se gestiona de forma diferente en las distintas versiones de Android:
| Versión | Detalles |
|---|---|
| Android 13 | El permiso de notificaciones push debe ser solicitado y concedido por el usuario. Tu aplicación puede solicitar el permiso manualmente, o se le pedirá automáticamente al usuario después de crear un canal de notificaciones. |
| Android 12 y anteriores | Todos los usuarios se consideran Subscribed después de su primera sesión. Braze solicita automáticamente un token de notificaciones push en ese momento, lo que convierte al usuario en habilitado para push con un token válido y un estado de suscripción predeterminado de Subscribed. |
iOS no genera automáticamente tokens de notificaciones push para una aplicación cuando se instala. Además, el registro se gestiona de forma diferente en las distintas versiones de iOS:
| Versión | ¿Autorización provisional? | Detalles |
|---|---|---|
| iOS 12 | Sí | Cuando un usuario opta por las notificaciones push, se te concede autorización estándar, lo que te permite enviar notificaciones push en primer plano. Sin embargo, también puedes solicitar autorización provisional, que te permite enviar silenciosamente notificaciones push en segundo plano directamente al centro de notificaciones. |
| iOS 11 o anteriores | No | Todos los usuarios deben optar explícitamente por recibir notificaciones push. Un token de notificaciones push se genera solo después de que se conceda el permiso. |
Braze asume que los tokens de notificaciones push importados son tokens de notificaciones push en primer plano válidos para tu aplicación y entorno.
Cuando importas tokens de iOS, Braze no almacena una puerta de enlace del servicio de notificaciones push de Apple (APN) (development o production) para ellos. Braze envía a estos tokens a través de la puerta de enlace configurada de tu aplicación. Si un token se generó para el otro entorno, APN lo rechaza con BadDeviceToken y el envío rebota.
Braze almacena una puerta de enlace para el token solo si el SDK registra posteriormente el mismo token e informa de una puerta de enlace.
Comprobación del estado de suscripción push del usuario
Hay dos formas de comprobar el estado de suscripción push de un usuario con Braze:
- Perfil de usuario: Puedes acceder a los perfiles de usuario individuales a través del panel de Braze en la página de búsqueda de usuarios. Después de encontrar el perfil de un usuario (por dirección de correo electrónico, número de teléfono o ID de usuario externo), puedes seleccionar la pestaña Participación para ver y ajustar manualmente el estado de suscripción del usuario.
- Exportación con REST API: Puedes exportar perfiles de usuario individuales en formato JSON utilizando los endpoints de exportación Usuarios por segmento o Usuarios por identificador. Braze devolverá un objeto de tokens de notificaciones push que contiene información de habilitación push por dispositivo.
Comprobación del estado de registro push
En la pestaña Participación del perfil de un usuario, verás Push Registered For seguido de un nombre de aplicación. Si no existe información de aplicación para ese dispositivo, verás dos guiones (--). Habrá una entrada por cada dispositivo que pertenezca al usuario.
Si el nombre de la aplicación de la entrada del dispositivo tiene el prefijo Foreground:, la aplicación está autorizada para recibir tanto notificaciones push en primer plano (visibles para el usuario) como notificaciones push en segundo plano (no visibles para el usuario) en ese dispositivo.
Por otro lado, si el nombre de la aplicación de la entrada del dispositivo tiene el prefijo Background:, la aplicación solo está autorizada para recibir push en segundo plano y no puede mostrar notificaciones visibles para el usuario en ese dispositivo. Esto generalmente indica que el usuario ha desactivado las notificaciones para la aplicación en ese dispositivo.
Si un token de notificaciones push se traslada a un usuario diferente en el mismo dispositivo, el primer usuario dejará de estar registrado para push.
Gestión de tokens de notificaciones push
Consulta la siguiente tabla para conocer las acciones que provocan cambios o la eliminación de tokens de notificaciones push de los perfiles de usuario.
| Acción | Descripción |
|---|---|
Llamada al método changeUser() |
El método changeUser() de Braze cambia el ID de usuario al que los SDK asignan los datos de comportamiento del usuario. Este método suele invocarse cuando un usuario inicia sesión en una aplicación. Cuando se invoca changeUser() con un ID de usuario diferente o nuevo en un dispositivo específico, el token de notificaciones push de ese dispositivo se trasladará al perfil de Braze correspondiente con el ID de usuario adecuado. |
| Se produce un error de push | Algunos errores comunes de push que provocan la eliminación del token incluyen MismatchSenderId, InvalidRegistration y otros tipos de rebotes push. Consulta nuestra lista completa de errores de push comunes. |
| El usuario desinstala la aplicación | Cuando un usuario desinstala la aplicación de un dispositivo, Braze eliminará el token de notificaciones push del usuario de su perfil. |
¿Cómo funciona esto a mayor escala?
Cuando un usuario abre una nueva aplicación y concede acceso push desde un aviso de push, el SDK de Braze realiza una llamada a los proveedores de push. Cuando se realiza esa llamada, el proveedor de push ejecuta una verificación para comprobar que todo esté configurado correctamente. Si es así, se pasa un token de notificaciones push a tu dispositivo. Cuando llega ese token, el SDK lo comunica a Braze. Una vez que Braze ha recibido el token del proveedor de push, actualiza o crea un nuevo perfil de usuario. Estos usuarios se consideran ahora como registrados.
Si queremos lanzar una Campaign, creamos una Campaign en Braze que genera una carga útil de push para enviar al proveedor de push. A partir de ahí, el proveedor entrega la carga útil de push al dispositivo del usuario y el SDK pasa el estado de la mensajería a Braze.
| Pasos de registro | Pasos de mensajería |
|---|---|
| 1. El cliente (dispositivo) se registra en el proveedor de push 2. El proveedor genera y entrega el token de notificaciones push 3. Se envían los tokens a Braze |
1. Braze envía la carga útil de push al proveedor 2. El proveedor entrega la carga útil de push al dispositivo 3. El SDK pasa las estadísticas de mensajería a Braze |
Preguntas frecuentes
¿Qué sucede cuando un usuario que ha dado su adhesión voluntaria elimina y luego vuelve a descargar mi aplicación?
Supongamos que un usuario da su adhesión voluntaria para push, recibe algunos mensajes push y luego elimina la aplicación. Esto eliminará el consentimiento de push a nivel del dispositivo. A partir de aquí, el primer push rebotado después de la desinstalación hará que automáticamente se cancele la adhesión voluntaria de ese usuario para futuros mensajes push. Después de esto, si un usuario reinstalara la aplicación pero no la iniciara, Braze no podrá enviarle una notificación push porque los tokens de notificaciones push no se han vuelto a conceder para tu aplicación.
Además, si un usuario volviera a habilitar las notificaciones push en primer plano, se necesitaría un inicio de sesión para actualizar esta información en su perfil de usuario y poder comenzar a recibir mensajes push.
¿Cuándo caducan los tokens de notificaciones push?
Lamentablemente, los APN y FCM no definen esto de forma clara. Los tokens de notificaciones push pueden caducar cuando se actualiza una aplicación, cuando los usuarios transfieren sus datos a un nuevo dispositivo o cuando reinstalan un sistema operativo. En general, no tenemos mucha información sobre por qué los proveedores de servicios de notificaciones push hacen caducar ciertos tokens de notificaciones push.
Para tener en cuenta esa ambigüedad, nuestras integraciones push del SDK siempre registran y actualizan los tokens al inicio de sesión para asegurarnos de tener el token más actualizado.