Gestión de tu base de suscriptores de push

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

Entendiendo los tokens de push y cómo funcionan

Un token de 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 de push:

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

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

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

1. Cuando la aplicación se inicia por primera vez, solicita permiso al sistema operativo (SO) del dispositivo para recibir notificaciones push.

2. El servicio de push de la aplicación (por ejemplo, APNs para iOS, FCM para Android) genera un token de 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 han otorgado permiso.

3. 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.

4. Pushwoosh almacena de forma segura el token para futuras mensajerías.

5. 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 apropiada.

6. 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.

7. Si el token de push se vuelve inválido (por ejemplo, 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 de 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 de 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 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

Importante

Pushwoosh determina la validez de un token solo cuando una notificación push no se entrega. No comprueba proactivamente el estado del token.

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

Para mantener limpia tu lista de suscriptores de 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 hacer esto:

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 de 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

Se necesita ayuda de un desarrollador

Anular el registro de dispositivos a través de la API requiere la ayuda de tu equipo de desarrollo. Por favor, comparte esta guía con ellos para implementar el proceso.

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

Para hacerlo:

1. Crea un segmento de usuarios que coincida con tus criterios (por ejemplo, usuarios que se han dado de baja, usuarios de nivel gratuito o aquellos inactivos durante X días).
2. Exporta el segmento usando el Panel de Control o el método de la API exportSegment.
3. Llama a /bulkUnregisterDevice para eliminar los tokens de push de los dispositivos de 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 de 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 predeterminada Last Application Open. Si un usuario no ha abierto la aplicación durante 90 días o más, su token de push se marca como inactivo y se elimina de tu base de suscriptores.

Importante

Esta función está habilitada por defecto para todas las cuentas creadas a partir del 1 de enero de 2024. Para comprobar si está activa en tu cuenta o para solicitar su activación, por favor contacta con el Soporte de Pushwoosh.

Usar el seguimiento de desinstalaciones (Uninstall Tracking)

El seguimiento de desinstalaciones (Uninstall Tracking) mantiene precisa tu lista de suscriptores de 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 (Uninstall Tracking) solo es compatible con iOS y Android.

Funciona de la siguiente manera:

1. 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 insignias.
2. Cada dispositivo tiene un token de push único proporcionado por una puerta de enlace de notificaciones. Si la aplicación ha sido desinstalada, el token se vuelve inválido. Cuando el push silencioso falla, la puerta de enlace devuelve un error.
3. Pushwoosh detecta el error y elimina el token inválido de tu lista de suscriptores.

Importante

El seguimiento de desinstalaciones (Uninstall Tracking) envía notificaciones push silenciosas a todos los suscriptores diariamente, lo que puede aumentar la carga del sistema. Asegúrate de que tu infraestructura pueda soportar este volumen. La función está habilitada por defecto en las plataformas compatibles. Para desactivarla, contacta con el Soporte de Pushwoosh o con tu Customer Success Manager.

Limitaciones del seguimiento de desinstalaciones

Las puertas de enlace de notificaciones no garantizan la entrega de pushes silenciosos. 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 monitorear la actividad de desinstalación, navega a Estadísticas > Paneles > Panel de la aplicación en tu Panel de Control de Pushwoosh. El gráfico de Desinstalaciones de la aplicación proporciona una vista cronológica de las tendencias de desinstalación para tu aplicación.

¿Se pueden restaurar los usuarios después de eliminar un token de push?

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

Cuando un usuario vuelve a abrir tu aplicación:

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