Skip to content

Habilitación push y suscripción push

Este artículo de referencia cubre los conceptos de habilitación push y estados de suscripción push en Braze, incluyendo las diferencias fundamentales de comportamiento entre iOS, Android y Web.

Estados de suscripción push

Un “Estado de suscripción push” en Braze identifica la preferencia global de un usuario en cuanto a su deseo de recibir notificaciones push. Dado que el estado de suscripción se basa en el usuario, no es específico de ninguna aplicación concreta. Los estados de suscripción se convierten en banderas útiles a la hora de decidir a qué usuarios dirigir las notificaciones push.

Existen las siguientes opciones de estado de suscripción: Subscribed, Opted-In, y Unsubscribed.

De forma predeterminada, para que tus usuarios puedan recibir tus mensajes a través de notificaciones push, su estado de suscripción a las notificaciones push debe ser oSubscribed Opted-In, y deben tener habilitadas las notificaciones push en primer plano. Puede anular esta configuración si es necesario al redactar un mensaje.

Actualización de los estados de suscripción push

Revisa las siguientes formas de actualizar el estado de la suscripción push de un usuario:

Inscripción automática (por defecto)

Por defecto, Braze establece el estado de suscripción push de un usuario en Opted-In cuando autoriza por primera vez las notificaciones push para tu aplicación. Braze también lo hace cuando un usuario vuelve a activar los permisos push en la configuración del sistema tras haberlos desactivado previamente.

Para desactivar este comportamiento predeterminado, añada la siguiente propiedad al archivo braze.xml de su proyecto de Android Studio:

1

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

A partir de la versión 7.5.0 del SDK de Braze Swift, puedes desactivar o personalizar aún más este comportamiento añadiendo la configuración optInWhenPushAuthorized al archivo AppDelegate.swift de tu proyecto Xcode:

1
2
3
4

configuration.optInWhenPushAuthorized = false // disables the default behavior

let braze = Braze(configuration: configuration)
AppDelegate.braze = braze

Integración de SDK

Puede actualizar el estado de suscripción de un usuario con el SDK Braze utilizando el método setPushNotificationSubscriptionType en Web, Android o iOS. Por ejemplo, puedes utilizar este método para crear una página de configuración en tu aplicación en la que los usuarios puedan activar o desactivar manualmente las notificaciones push.

API REST

Puedes actualizar el estado de suscripción de un usuario con la API REST de Braze utilizando el/users/track punto final para actualizar supush_subscribe atributo.

Comprobación del estado de la suscripción push

Perfil de usuario de John Doe con su estado de suscripción push establecido en Suscrito.

Puedes comprobar el estado de la suscripción push de un usuario con Braze de cualquiera de las siguientes maneras:

  • Perfil del 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 (a través de la dirección de correo electrónico, el número de teléfono o el ID de usuario externo), puede seleccionar la pestaña Compromiso para ver y ajustar manualmente el estado de suscripción de un usuario.
  • Exportación de la API REST: Puedes exportar perfiles de usuario individuales en formato JSON utilizando los puntos finales Exportar usuarios por segmento o Exportar usuarios por identificador. Braze devuelve un objeto de tokens de notificaciones push que contiene información sobre la habilitación de push por dispositivo.

Acciones del usuario en iOS y estado push

La siguiente tabla muestra cómo las diferentes acciones del usuario afectan la habilitación push en iOS, el registro push en primer plano o segundo plano, y el estado de suscripción push en Braze. Cuando un usuario instala tu aplicación e inicia su primera sesión, su estado es generalmente el que se muestra en la primera fila. Cada acción posterior puede actualizar algunos de estos valores, pero no otros.

* Si la aplicación no utiliza push provisional, Foreground Push Enabled es false hasta que el usuario permita las notificaciones push. Si la aplicación utiliza push provisional, Foreground Push Enabled es true al inicio de la primera sesión. Para más información, consulta Autorización provisional y push silencioso.

** A partir de la versión 7.5.0 de Braze Swift SDK, la propiedad de configuración optInWhenPushAuthorized controla si el estado de suscripción push se establece automáticamente en Opted-In cuando se autoriza el permiso push. Para más información, consulta Actualización de los estados de suscripción push.

Permiso push

Todas las plataformas habilitadas para push (iOS, Web y Android) requieren adhesión voluntaria explícita a través de un aviso a nivel del sistema operativo, con algunas ligeras diferencias que se describen a continuación.

Dado que la decisión del usuario es definitiva y no puedes volver a preguntar después de que rechace, usar mensajes dentro de la aplicación de push primer es una estrategia importante para aumentar tus tasas de adhesión voluntaria.

Avisos nativos de permiso push del sistema operativo

Android

Antes de Android 13, no se necesitaba permiso para enviar notificaciones push. En Android 12 e inferior, todos los usuarios se consideran Subscribed en su primera sesión cuando Braze solicita automáticamente un token push. En ese momento, el usuario está habilitado para push con un token push válido para ese dispositivo y un estado de suscripción predeterminado de Subscribed.

A partir de Android 13, el permiso push debe solicitarse y ser otorgado por el usuario. Tu aplicación puede solicitar manualmente el permiso al usuario en momentos oportunos, pero si no lo hace, los usuarios recibirán el aviso automáticamente cuando tu aplicación cree un canal de notificaciones.

iOS

Una notificación en el Centro de notificaciones del sistema con un mensaje en la parte inferior que pregunta "¿Seguir recibiendo notificaciones de la aplicación Yachtr?" con dos botones debajo para "Keep" o "Turn Off"

Tu aplicación puede solicitar push provisional o push autorizado.

El push autorizado requiere permiso explícito del usuario antes de enviar cualquier notificación, mientras que el push provisional te permite enviar notificaciones silenciosamente, directamente al centro de notificaciones sin ningún sonido ni alerta.

Autorización provisional y push silencioso

Antes de iOS 12 (lanzado en 2018), todos los usuarios debían adherirse explícitamente para recibir notificaciones push.

En iOS 12, Apple introdujo la autorización provisional, que permite a las marcas enviar notificaciones push silenciosas al centro de notificaciones de sus usuarios antes de que se adhieran explícitamente, dándote la oportunidad de demostrar el valor de tus mensajes de forma temprana. Consulta autorización provisional para obtener más información.

Web

Para Web, debes solicitar la adhesión voluntaria explícita del usuario a través del diálogo de permiso nativo del navegador.

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 es desencadenado por un “gesto del usuario” (clic del ratón o pulsación de tecla). Si tu sitio intenta solicitar permiso de notificaciones push al cargar la página, probablemente será ignorado o silenciado por el navegador.

Como resultado, solo debes solicitar permiso cuando un usuario haga clic en algún lugar de tu sitio web y no de forma aleatoria cuando se carga una página.

Tokens push

Los tokens push son un identificador anónimo único generado por el dispositivo del usuario y enviado a Braze para identificar dónde enviar la notificación de cada destinatario.

Hay dos formas en que un token push puede clasificarse, que son esenciales para entender cómo se puede enviar una notificación push a tus usuarios.

  1. Push en primer plano proporciona la capacidad de enviar notificaciones push visibles regulares al primer plano del dispositivo del usuario.
  2. Push en segundo plano está disponible independientemente de si un dispositivo en particular ha optado por recibir notificaciones push de esa marca. El push en segundo plano permite a las marcas enviar notificaciones push silenciosas (notificaciones que intencionalmente no se muestran) a los dispositivos para soportar funcionalidades clave como Uninstall Tracking.

Cuando un perfil de usuario tiene un token push de primer plano válido asociado con una aplicación, Braze considera al usuario como “registrado para push” en la aplicación dada. Braze, entonces, proporciona un filtro de segmentación específico, Foreground Push Enabled for App, para ayudar a identificar a estos usuarios.

Múltiples usuarios en un dispositivo

Los tokens push son específicos tanto del dispositivo como de la aplicación, por lo que no es posible usar tokens push para distinguir entre múltiples usuarios que usan 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 push se reasignará al perfil de Kim. El token 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 push se reasigna al nuevo usuario. Esto se refleja en el perfil del usuario, en la sección Contact Settings de la pestaña Engagement:

Registro de cambios del token push en la pestaña **Engagement** del perfil de un usuario, que muestra cuándo se movió el token push a otro usuario y cuál era el token.

Dado que no hay forma de que los proveedores push (APNs/FCM) distingan entre múltiples usuarios en un dispositivo, pasamos el token push al último usuario que inició sesión para determinar a qué usuario dirigir en el dispositivo para push.

Múltiples dispositivos y un usuario

El estado de suscripción push se basa en el usuario y no es específico de ninguna aplicación individual. El estado de la suscripción push es el último valor establecido. Así que si un usuario ha optado por recibir notificaciones push, su estado de suscripción push es Opted-In en todos los dispositivos elegibles. Si un usuario posteriormente cancela explícitamente su suscripción a las notificaciones push a través de tu aplicación u otros métodos que tu marca proporcione, su estado de suscripción push se actualiza a Unsubscribed y ningún dispositivo registrado para push puede recibir notificaciones push.

Filtro Foreground Push Enabled

Foreground Push Enabled es un filtro de segmentación en Braze que permite a los especialistas en marketing identificar fácilmente a los usuarios que permiten que Braze les envíe notificaciones push y a los usuarios que no han expresado preferencias para no recibir notificaciones push.

El filtro Foreground Push Enabled tiene en cuenta lo siguiente:

  • La capacidad de Braze para enviar una notificación push (token push de primer plano)
  • La preferencia general del usuario para recibir push en cualquiera de sus dispositivos (estado de suscripción push)

Una captura de pantalla del dashboard que muestra que un usuario está "Push Registered for Marketing (iOS)"

Un usuario se considera “habilitado para push” o “registrado para push” si tiene un token push de primer plano activo para una aplicación dentro de tu espacio de trabajo, lo que significa que el estado de habilitación push es específico de la aplicación.

Otros escenarios específicos de plataforma

Cuando un usuario acepta el aviso nativo de permiso push, su estado de suscripción cambiará a opted in.

Para gestionar las suscripciones, puedes usar el método de usuario setPushNotificationSubscriptionType para crear una página de configuración de preferencias en tu sitio, después de lo cual puedes filtrar usuarios por estado de cancelación en el dashboard.

Si un usuario deshabilita las notificaciones en su navegador, la siguiente notificación push enviada a ese usuario rebotará, y Braze actualizará el token push del usuario en consecuencia. Esto se usa para gestionar la elegibilidad de los filtros habilitados para push (Background or Foreground Push Enabled, Foreground Push Enabled y Foreground Push Enabled for App). El estado de suscripción establecido en el perfil del usuario es una configuración a nivel de usuario y no cambia cuando un push rebota.

Si un usuario habilitado para push en primer plano deshabilita push en la configuración de su sistema operativo, al inicio de la siguiente sesión:

  • Braze lo marca como deshabilitado para push en primer plano y ya no intenta enviarle mensajes push.
  • El filtro Foreground Push Enabled for App (Android) y el filtro de segmentación Foreground Push Enabled (asumiendo que ninguna otra aplicación en el perfil del usuario tiene un token push de primer plano válido) devolverán false.

En este escenario, dado que un token push en segundo plano seguirá existiendo, puedes continuar enviando notificaciones push en segundo plano (silenciosas) con el filtro de segmentación Background or Foreground Push Enabled = true.

Para Android, Braze considerará a un usuario como deshabilitado para push si:

  • Un usuario desinstala la aplicación de su dispositivo.
  • Un mensaje push no se entrega debido a un rebote. Esto generalmente es causado por una desinstalación, pero también puede deberse a actualizaciones de la aplicación, una nueva versión del token push o un cambio de formato.
  • El registro push falla en Firebase Cloud Messaging (a veces causado por conexiones de red deficientes o una falla al conectarse a FCM o de FCM para devolver un token válido).
  • El usuario bloquea las notificaciones push para la aplicación en la configuración de su dispositivo y posteriormente registra una sesión.

Independientemente de si un usuario acepta el aviso de adhesión voluntaria de push en primer plano, aún podrás enviar push en segundo plano si tienes las notificaciones remotas habilitadas en Xcode y tu aplicación llama a registerForRemoteNotifications().

Si tu aplicación tiene autorización provisional o el usuario ha optado por push, reciben un token push de primer plano, lo que te permite enviarles todo tipo de push. Dentro de Braze, consideramos que un usuario en iOS que está habilitado para push en primer plano está habilitado para push, ya sea explícitamente (a nivel de aplicación) o provisionalmente (a nivel de dispositivo).

Si un usuario rechaza recibir notificaciones push a nivel del sistema operativo, su estado de suscripción push será Subscribed, y su perfil no mostrará que se ha registrado un token push de primer plano.

En el escenario en que un usuario, que inicialmente optó por push a nivel del sistema operativo, deshabilita las notificaciones push en la configuración de su sistema operativo, al inicio de la siguiente sesión ocurrirá lo siguiente:

  • Braze lo marca como deshabilitado para push en primer plano y ya no intenta enviar mensajes push.
  • El filtro Foreground Push Enabled for App (iOS) y el filtro de segmentación Foreground Push Enabled (asumiendo que ninguna otra aplicación en el perfil del usuario tiene un token push de primer plano válido) devolverán false.

En este escenario, dado que un token push en segundo plano seguirá existiendo, puedes continuar enviando notificaciones push en segundo plano (silenciosas) con el filtro de segmentación Background or Foreground Push Enabled = true.

Buenas prácticas

Consulta nuestro artículo dedicado sobre buenas prácticas de push para obtener orientación detallada sobre cómo optimizar tu uso de push en Braze.
New Stuff!