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 le fonctionnement des 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 d’un 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 exemple, 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 montrés à ces utilisateurs, mais le jeton peut toujours être utilisé pour envoyer des messages à leur boîte de réception dans l’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 ID matériel ou HWID) à Pushwoosh via le point de terminaison de l’API /registerDevice.

4. Pushwoosh stocke le jeton de manière sécurisée pour les futures messageries.

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 exemple, 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. Ensuite, Pushwoosh marque 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 une 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 finit par renvoyer 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 ne parvient pas à être livrée. Il ne vérifie pas de manière proactive l’état des jetons.

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

Pour maintenir votre liste d’abonnés aux notifications push à jour, 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 y aider :

Envoyez régulièrement des notifications push à l’ensemble de votre base d’abonnés

Envoyez régulièrement des messages push à l’ensemble de 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’une notification push est envoyée. Pushwoosh n’effectue pas de vérifications en arrière-plan sur la validité des jetons.

Désinscrire des appareils via l’API

Aide des développeurs 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 des jetons push de votre base d’abonnés, par exemple, lorsque les utilisateurs se désabonnent ou ne sont plus actifs.

Pour ce faire :

1. Créez un segment d’utilisateurs correspondant à vos critères (par exemple, désabonnés, utilisateurs gratuits ou inactifs depuis X jours).
2. Exportez le segment à l’aide du Panneau de Contrôle ou de la méthode 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 à jour en supprimant les jetons push des utilisateurs qui n’ont pas été actifs depuis 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 à partir du 1er janvier 2024. 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 aux notifications 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.

Voici comment cela fonctionne :

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 la notification push silencieuse é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 notifications push silencieuses. 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

Consulter les données de désinstallation

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

Pouvez-vous restaurer les utilisateurs après la suppression d’un 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.