Gérer votre base d'abonnés aux notifications push

Dans Pushwoosh, chaque abonné est identifié par un jeton push, un identifiant unique qui permet la livraison de messages à un appareil spécifique. Cet article explique comment fonctionnent les jetons push et comment ne conserver que les jetons valides dans votre base d’abonnés.

Comprendre les jetons push et leur fonctionnement

Un jeton push est un identifiant unique et anonyme attribué à une instance d’application spécifique sur un appareil par son fournisseur de services push :

• Apple Push Notification Service (APNs) pour les appareils iOS
• Firebase Cloud Messaging (FCM) pour les appareils Android

Ce jeton garantit que les notifications push sont livrées à la bonne application sur l’appareil de l’utilisateur.

Dans Pushwoosh, le cycle de vie du jeton push comprend ces étapes clés :

1. Lorsque l’application est lancée pour la première fois, elle demande au système d’exploitation (OS) de l’appareil l’autorisation de recevoir des notifications push.

2. Le service push de l’application (par ex., APNs pour iOS, FCM pour Android) génère un jeton push unique pour cette instance d’application. Par défaut, le SDK Pushwoosh collecte et stocke ce jeton même si l’utilisateur n’a pas accordé les autorisations d’affichage des notifications. Les messages push ne seront pas affichés à ces utilisateurs, mais le jeton peut toujours être utilisé pour envoyer des messages à leur boîte de réception d’application, un autre canal de messagerie dans Pushwoosh.

   Cependant, vous pouvez configurer le SDK pour ne collecter les jetons que des utilisateurs qui ont accordé l’autorisation.

3. L’application utilise le SDK Pushwoosh pour envoyer ce jeton à la base de données Pushwoosh avec les données de l’appareil (y compris un identifiant matériel ou HWID) à Pushwoosh via le point de terminaison de l’API /registerDevice.

4. Pushwoosh stocke le jeton en toute sécurité pour les futurs messages.

5. Lorsqu’une notification est déclenchée, Pushwoosh utilise le jeton stocké pour acheminer le message via la passerelle de livraison appropriée.

6. La passerelle choisie livre le message à l’appareil, et l’OS l’affiche en fonction des paramètres de notification du système et de l’application.

7. Si le jeton push devient invalide (par ex., en raison de la désinstallation de l’application), Pushwoosh détecte l’échec de la livraison après un autre envoi de notification, lorsque la passerelle renvoie la liste des erreurs d’envoi, y compris les jetons expirés/invalides/etc. Pushwoosh marque alors le jeton comme inactif et le supprime de la base de données. Si l’application est réinstallée sur le même appareil, un nouveau jeton sera émis.

Raisons courantes pour lesquelles les jetons push deviennent invalides

Bien que l’Apple Push Notification Service (APNs) et Firebase Cloud Messaging (FCM) n’offrent pas une transparence totale sur les politiques de cycle de vie des jetons ou ne permettent pas la validation proactive des jetons, il existe des scénarios connus dans lesquels les jetons push peuvent devenir invalides ou expirer.

Cause	APNs (iOS)	FCM (Android)
Désinstallation de l’application	Le jeton devient invalide après la désinstallation de l’application. APNs renvoie finalement une erreur 410 Unregistered. Apple ne précise pas quand l’invalidation se produit ; cela peut prendre de quelques minutes à plusieurs jours. En savoir plus	Le jeton est immédiatement invalidé lors de la désinstallation. Les envois ultérieurs renvoient une erreur Unregistered. En savoir plus
Actualisation du jeton	APNs émet un nouveau jeton après les mises à niveau de l’OS, la sauvegarde/restauration de l’appareil, la réinstallation de l’application ou les mises à jour de l’OS. En savoir plus	Même comportement qu’APNs. Également déclenché par l’effacement des données de l’application ou la restauration de l’appareil. En savoir plus
Inactivité du jeton	Aucune expiration documentée due à l’inactivité. En savoir plus	Les jetons inactifs pendant plus de 270 jours sont considérés comme obsolètes/expirés. FCM les marque comme invalides. En savoir plus

Important

Pushwoosh ne détermine la validité d’un jeton que lorsqu’une notification push échoue à être livrée. Il ne vérifie pas de manière proactive l’état des jetons.

Comment maintenir votre liste d’abonnés propre en supprimant les jetons push invalides

Pour maintenir votre liste d’abonnés push propre, vérifiez régulièrement les statistiques de livraison, supprimez les jetons invalides et assurez-vous que votre application et votre backend disposent toujours des données de jeton les plus récentes.

Pushwoosh offre plusieurs moyens pour vous aider à le faire :

Envoyer régulièrement des notifications push à toute votre base d’abonnés

Envoyez régulièrement des messages push à toute votre base d’abonnés. Cela aide Pushwoosh à identifier les jetons invalides. Lorsqu’un message ne parvient pas à être livré, généralement en raison d’un jeton invalide, la passerelle push renvoie une erreur. Le SDK capture cette réponse et supprime automatiquement le jeton invalide, s’assurant qu’il est exclu des envois futurs.

Important : La validité du jeton n’est vérifiée que lorsqu’un push est envoyé. Pushwoosh n’effectue pas de vérifications en arrière-plan sur la validité des jetons.

Désinscrire des appareils à l’aide de l’API

Assistance d'un développeur requise

La désinscription d’appareils via l’API nécessite l’aide de votre équipe de développement. Veuillez partager ce guide avec eux pour mettre en œuvre le processus.

Vous pouvez utiliser la méthode de l’API Device /bulkUnregisterDevice pour supprimer les jetons push de votre base d’abonnés, par exemple, lorsque les utilisateurs se désinscrivent ou ne sont plus actifs.

Pour ce faire :

1. Créez un segment d’utilisateurs correspondant à vos critères (par ex., désinscrits, utilisateurs de niveau gratuit, ou ceux inactifs depuis X jours).
2. Exportez le segment à l’aide du Control Panel ou de la méthode de l’API exportSegment.
3. Appelez /bulkUnregisterDevice pour supprimer les jetons push des appareils de ce segment.

Supprimer automatiquement les jetons inactifs après 90 jours avec l’autovalidation

L’algorithme de nettoyage automatique de l’inactivité dans Pushwoosh aide à maintenir votre liste d’abonnés propre en supprimant les jetons push des utilisateurs qui n’ont pas été actifs pendant 90 jours.

Il fonctionne en suivant la dernière fois que les utilisateurs ont ouvert votre application à l’aide du tag par défaut Last Application Open. Si un utilisateur n’a pas ouvert l’application depuis 90 jours ou plus, son jeton push est marqué comme inactif et supprimé de votre base d’abonnés.

Important

Cette fonctionnalité est activée par défaut pour tous les comptes créés le 1er janvier 2024 ou après. Pour vérifier si elle est active pour votre compte ou pour demander son activation, veuillez contacter le support Pushwoosh.

Utiliser le suivi des désinstallations

Le suivi des désinstallations (Uninstall Tracking) maintient la précision de votre liste d’abonnés push en détectant quand les utilisateurs désinstallent votre application. Cela permet à Pushwoosh de supprimer automatiquement les jetons invalides.

Note : Le suivi des désinstallations n’est pris en charge que sur iOS et Android.

Il fonctionne comme suit :

1. Pushwoosh envoie une notification push silencieuse une fois par jour à tous les appareils abonnés. Ces notifications silencieuses sont invisibles pour les utilisateurs, sans alertes, sons ou badges.
2. Chaque appareil possède un jeton push unique fourni par une passerelle de notification. Si l’application a été désinstallée, le jeton devient invalide. Lorsque le push silencieux échoue, la passerelle renvoie une erreur.
3. Pushwoosh détecte l’erreur et supprime le jeton invalide de votre liste d’abonnés.

Important

Le suivi des désinstallations envoie quotidiennement des notifications push silencieuses à tous les abonnés, ce qui peut augmenter la charge du système. Assurez-vous que votre infrastructure peut supporter ce volume. La fonctionnalité est activée par défaut sur les plateformes prises en charge. Pour la désactiver, contactez le support Pushwoosh ou votre Customer Success Manager.

Limites du suivi des désinstallations

Les passerelles de notification ne garantissent pas la livraison des pushes silencieux. Ces messages peuvent être dépriorisés ou abandonnés par la passerelle, ce qui peut retarder ou limiter la précision de la détection des désinstallations. En savoir plus

Afficher les données de désinstallation

Pour surveiller l’activité de désinstallation, accédez à Statistics > Dashboards > Application dashboard dans votre Control Panel Pushwoosh. Le graphique App Uninstalls offre une vue chronologique des tendances de désinstallation pour votre application.

Pouvez-vous restaurer les utilisateurs après la suppression du jeton push ?

La suppression d’un jeton push à l’aide de n’importe quelle méthode prise en charge est facilement réversible.

Lorsqu’un utilisateur rouvre votre application :

1. Le SDK Pushwoosh demande automatiquement un nouveau jeton push.
2. Il réinscrit ensuite l’appareil (via registerDevice).
3. L’utilisateur redevient un abonné actif et recevra désormais des notifications push.