Gestionar tu base de suscriptores push

En Pushwoosh, cada suscriptor se identifica mediante un token push, un identificador único que permite la entrega de mensajes a un dispositivo específico. Este artículo explica cómo funcionan los tokens push y cómo mantener solo tokens válidos en tu base de suscriptores.

Entender los tokens push y cómo funcionan

Un token push es un identificador único y anónimo asignado a una instancia de aplicación específica en un dispositivo por su proveedor de servicios push:

Apple Push Notification Service (APNs) para dispositivos iOS
Firebase Cloud Messaging (FCM) para dispositivos Android

Este token garantiza que las notificaciones push se entreguen a la aplicación correcta en el dispositivo del usuario.

En Pushwoosh, el ciclo de vida del token push incluye estas etapas clave:

Cuando la aplicación se inicia por primera vez, solicita permiso al sistema operativo (SO) del dispositivo para recibir notificaciones push.
El servicio push de la aplicación (p. ej., APNs para iOS, FCM para Android) genera un token push único para esa instancia de la aplicación. Por defecto, el SDK de Pushwoosh recopila y almacena este token incluso si el usuario no ha otorgado permisos para mostrar notificaciones. Los mensajes push no se mostrarán a estos usuarios, pero el token aún se puede usar para enviar mensajes a la bandeja de entrada de su aplicación, otro canal de mensajería en Pushwoosh.

Sin embargo, puedes configurar el SDK para que recopile tokens solo de los usuarios que hayan otorgado permiso.
La aplicación utiliza el SDK de Pushwoosh para enviar este token a la base de datos de Pushwoosh junto con los datos del dispositivo (incluido un ID de hardware o HWID) a Pushwoosh a través del punto final de la API /registerDevice.
Pushwoosh almacena de forma segura el token para futuros mensajes.
Cuando se activa una notificación, Pushwoosh utiliza el token almacenado para enrutar el mensaje a través de la puerta de enlace de entrega adecuada.
La puerta de enlace elegida entrega el mensaje al dispositivo, y el SO lo muestra según la configuración de notificaciones del sistema y de la aplicación.
Si el token push se vuelve inválido (p. ej., debido a la desinstalación de la aplicación), Pushwoosh detecta el fallo en la entrega después de otro envío de notificación, cuando la puerta de enlace devuelve la lista de errores de envío, incluidos los tokens caducados/inválidos/etc. Luego, Pushwoosh marca el token como inactivo y lo elimina de la base de datos. Si la aplicación se reinstala en el mismo dispositivo, se emitirá un nuevo token.

Razones comunes por las que los tokens push se vuelven inválidos

Aunque el Apple Push Notification Service (APNs) y Firebase Cloud Messaging (FCM) no proporcionan total transparencia sobre las políticas del ciclo de vida de los tokens ni permiten la validación proactiva de los mismos, existen escenarios conocidos en los que los tokens push pueden volverse inválidos o caducar.

Causa	APNs (iOS)	FCM (Android)
Desinstalación de la aplicación	El token se vuelve inválido después de la desinstalación de la aplicación. APNs eventualmente devuelve un error `410 Unregistered`. Apple no especifica cuándo ocurre la invalidación; puede tardar desde unos minutos hasta varios días. Más información	El token se invalida inmediatamente después de la desinstalación. Los envíos posteriores devuelven un error `Unregistered`. Más información
Actualización del token	APNs emite un nuevo token después de actualizaciones del SO, restauración de copias de seguridad del dispositivo, reinstalación de la aplicación o actualizaciones del SO. Más información	Mismo comportamiento que APNs. También se activa al borrar los datos de la aplicación o al restaurar el dispositivo. Más información
Inactividad del token	No hay caducidad documentada por inactividad. Más información	Los tokens inactivos durante más de 270 días se consideran obsoletos/caducados. FCM los marca como inválidos. Más información

Cómo mantener limpia tu lista de suscriptores eliminando tokens push inválidos

Para mantener limpia tu lista de suscriptores push, revisa regularmente las estadísticas de entrega, elimina los tokens inválidos y asegúrate de que tu aplicación y tu backend siempre tengan los datos de token más recientes.

Pushwoosh ofrece varias formas de ayudarte a hacerlo:

Envía notificaciones push a toda tu base de suscriptores regularmente

Envía mensajes push a toda tu base de suscriptores de forma regular. Esto ayuda a Pushwoosh a identificar tokens inválidos. Cuando un mensaje no se entrega, generalmente debido a un token inválido, la puerta de enlace push devuelve un error. El SDK captura esta respuesta y elimina el token inválido automáticamente, asegurando que se excluya de futuros envíos.

Importante: La validez del token solo se comprueba cuando se envía un push. Pushwoosh no realiza comprobaciones en segundo plano sobre la validez del token.

Anular el registro de dispositivos usando la API

Puedes usar el método de la API de Dispositivos /bulkUnregisterDevice para eliminar tokens push de tu base de suscriptores, por ejemplo, cuando los usuarios se dan de baja o ya no están activos.

Para hacerlo:

Crea un segmento de usuarios que coincida con tus criterios (p. ej., usuarios que se han dado de baja, usuarios de nivel gratuito o aquellos inactivos durante X días).
Exporta el segmento usando el Panel de Control o el método de la API exportSegment.
Llama a /bulkUnregisterDevice para eliminar los tokens push de los dispositivos en ese segmento.

Eliminar automáticamente tokens inactivos después de 90 días con autovalidación

El algoritmo de limpieza automática por inactividad en Pushwoosh ayuda a mantener limpia tu lista de suscriptores eliminando los tokens push de los usuarios que no han estado activos durante 90 días.

Funciona rastreando la última vez que los usuarios abrieron tu aplicación usando la etiqueta por defecto Last Application Open. Si un usuario no ha abierto la aplicación durante 90 días o más, su token push se marca como inactivo y se elimina de tu base de suscriptores.

Usar el seguimiento de desinstalaciones (Uninstall Tracking)

El seguimiento de desinstalaciones (Uninstall Tracking) mantiene precisa tu lista de suscriptores push al detectar cuándo los usuarios desinstalan tu aplicación. Esto permite a Pushwoosh eliminar automáticamente los tokens inválidos.

Nota: El seguimiento de desinstalaciones solo es compatible con iOS y Android.

Así es como funciona:

Pushwoosh envía una notificación push silenciosa una vez al día a todos los dispositivos suscritos. Estas notificaciones silenciosas son invisibles para los usuarios, sin alertas, sonidos ni globos de notificación.
Cada dispositivo tiene un token push único proporcionado por una puerta de enlace de notificaciones. Si la aplicación ha sido desinstalada, el token se vuelve inválido. Cuando la notificación push silenciosa falla, la puerta de enlace devuelve un error.
Pushwoosh detecta el error y elimina el token inválido de tu lista de suscriptores.

Limitaciones del seguimiento de desinstalaciones

Las puertas de enlace de notificaciones no garantizan la entrega de notificaciones push silenciosas. Estos mensajes pueden ser despriorizados o descartados por la puerta de enlace, lo que puede retrasar o limitar la precisión de la detección de desinstalaciones. Más información

Ver datos de desinstalaciones

Para monitorizar la actividad de desinstalaciones, navega a Statistics > Dashboards > Application dashboard en tu Panel de Control de Pushwoosh. El gráfico App Uninstalls proporciona una vista cronológica de las tendencias de desinstalación de tu aplicación.

¿Puedes restaurar usuarios después de eliminar un token push?

Eliminar un token push utilizando cualquier método compatible es fácilmente reversible.

Cuando un usuario vuelve a abrir tu aplicación:

El SDK de Pushwoosh solicita automáticamente un nuevo token push.
Luego, vuelve a registrar el dispositivo (a través de registerDevice).
El usuario se convierte de nuevo en un suscriptor activo y recibirá notificaciones push en el futuro.