Abonnements

​

Aperçu

Un Abonnement représente un canal spécifique par lequel un utilisateur peut recevoir des messages, comme une adresse e-mail, un numéro de téléphone ou un appareil. OneSignal prend en charge quatre types d’Abonnements : Chaque utilisateur peut avoir plusieurs Abonnements. Utilisez l’ID externe pour identifier l’utilisateur sur tous les Abonnements. Dans l’image ci-dessus, “userA” a 5 Abonnements :

1. Mobile (iOS) créé après l’installation de l’application iOS. Appelez OneSignal.login pour définir l’ID externe et lier l’Abonnement à l’utilisateur.
2. SMS créé après la fourniture du numéro de téléphone dans l’application iOS. Voir Abonnements SMS ci-dessous pour plus de détails.
3. Web Push créé après l’abonnement aux notifications push sur le site web. Peut recevoir des notifications push.
4. E-mail créé après la fourniture de l’adresse e-mail. Pour envoyer des messages e-mail.
5. Mobile (Android) créé après l’installation de l’application Android. Peut recevoir des notifications push, des messages in-app et des live activities.

---

​

Propriétés des Abonnements

Chaque Abonnement possède les propriétés suivantes :

​

Statuts d’abonnement

Généralement, les Abonnements peuvent soit recevoir des messages (Abonné) soit ne pas pouvoir recevoir de messages (Désabonné). Les détails varient selon le canal :

---

​

notification_types

Indique la capacité de l’Abonnement à recevoir des messages, y compris les raisons des échecs. Mis à jour automatiquement via nos SDK frontend ou manuellement via l’API. Consultable via l’API View User ou Export CSV.

Définitions des types de notification.

1 ou nombre positif = Abonné.

• L’Abonnement peut recevoir des messages sur ce canal.
• Peut être utilisé avec la propriété enabled si vous activez les messages au nom de l’utilisateur. Pour les Abonnements push, un token valide doit toujours être défini pour recevoir les notifications push. Consultez nos docs de configuration SDK pour plus de détails.

0, -99 = Jamais Abonné.

• L’Abonnement ne s’est pas encore abonné au canal.

-2 = Désabonné.

• L’Abonnement ne peut pas recevoir de messages sur ce canal.
• Peut être utilisé avec la propriété enabled définie sur false si vous désactivez les messages au nom de l’utilisateur. Valeur recommandée lors de la désactivation des autorisations de message.
• Défini automatiquement lorsque l’utilisateur se désabonne.

-3, -5 = Android Erreur de bibliothèque de support.Ajoutez ou mettez à jour la bibliothèque de support Android de votre application.-4, -8, -11, -12 = Android Erreur de bibliothèque Google Play Services.

• Vérifiez le logcat. Voir Obtenir un journal de débogage.
• Mettez à niveau votre bibliothèque Google Play Services dans votre application et vérifiez le logcat de l’application pour les erreurs Google Play Services. Voir Obtenir un journal de débogage.

-6 = Android Numéro de projet Google invalide.

• L’ID d’expéditeur FCMv1 ne correspond pas à l’original auquel ce token appartient. Vérifiez le logcat de l’application. Voir Obtenir un journal de débogage.

-7, -9 = Android Application Google Play Services obsolète

• Mettez à jour ou activez l’application Google Play Services sur l’appareil.

-10 = Non Abonné.

• L’Abonnement push a désinstallé l’application ou s’est désabonné dans les paramètres de l’appareil.
• Le push web a bloqué les notifications, effacé toutes les données et les workers.

-13 = iOS missing_push_capability.

• Examinez les docs de configuration SDK pour vous assurer que toutes les étapes sont implémentées. Voir Configuration de canal.

-14, -16, -17 = iOS Erreurs APNS.

• L’appareil rencontre un problème de connexion à APNS. Consultez le guide Dépannage iOS et Obtenir un journal de débogage.

-15 = iOS Erreur de simulateur.

• Le simulateur iOS nécessite iOS 16.4+. Utilisez un simulateur ou un appareil différent.

-18 = Jamais Invité.

• L’Abonnement n’a jamais été invité à s’abonner. Cela suit uniquement l’invite d’autorisation requise et n’inclut pas les messages in-app.

-19 = Invité mais jamais répondu.

• L’Abonnement a été invité mais n’a pas fourni de réponse.

-20, -21 = temp_web_record. Web, autorisation pushSubscriptionchange révoquée-22 = Désabonné manuellement via le tableau de bord.

• L’autorisation a été révoquée.

-23, -24 = Web Erreur de Service Worker.

• Voir Dépannage du SDK Web.

-31 = Désactivé via l’API REST.-98 = Abonnement SMS en attente de double opt-in.

---

​

Abonnements mobiles

Les Abonnements mobiles représentent les appareils iOS, Android, Huawei ou Amazon et prennent en charge :

• Les notifications push
• Les messages in-app
• Les Live Activities

Ils sont créés automatiquement lorsqu’un utilisateur installe et ouvre votre application avec le SDK OneSignal.

​

Mise à jour des Abonnements mobiles

Il est recommandé de mettre à jour les propriétés des Abonnements mobiles via le SDK mobile OneSignal.

• Demander les autorisations push et observer les changements d’autorisation/Abonnement
• Connecter les utilisateurs pour définir l’External ID et les Alias
• Ajouter des Tags
• Définir la Langue

Vous pouvez mettre à jour les tags, la langue et d’autres propriétés via la fonctionnalité Import CSV. Les Abonnements mobiles peuvent également être créés et mis à jour via les APIs Users et Subscriptions, mais le SDK mobile est recommandé pour la plupart des cas d’utilisation.

​

Gestion des désinstallations, désabonnements et jetons push invalides

Les Abonnements mobiles cessent de recevoir des notifications push si l’utilisateur :

• Désinstalle l’application
• Désactive le push dans les paramètres de l’appareil et ne rouvre jamais l’application
• Le jeton push expire

Dans ces cas, le statut de l’Abonnement sera défini sur Désabonné lors de l’envoi de notifications push. Voir ci-dessous Quand les statuts d’abonnement push se mettent-ils à jour ? pour plus de détails.

• Si l’utilisateur réinstalle l’application sur le même appareil ou sur un nouvel appareil, un nouvel Abonnement sera créé et il devra se réabonner pour recevoir des messages.
• Si l’utilisateur réactive le push dans les paramètres de l’appareil, le statut de l’Abonnement sera défini sur Abonné et un jeton push sera mis à jour lorsqu’il ouvrira l’application.
• Si le jeton push expire, le statut de l’Abonnement et le nouveau jeton push seront mis à jour lorsque l’utilisateur ouvrira l’application sur le même appareil.

Suivez les changements via :

• Event Streams - détecte les désabonnements lors de l’envoi de push
• Rapports push - détecte les désabonnements lors de l’envoi de push
• Utilisez l’écouteur de changement d’Abonnement du SDK - détecte les désabonnements lorsque l’utilisateur désactive le push dans les paramètres de l’appareil puis ouvre l’application

---

​

Abonnements Web push

Les Abonnements Web push sont liés à un appareil, un navigateur et un profil de navigateur spécifiques. Un utilisateur qui s’abonne sur Chrome desktop ne recevra pas de push sur Chrome mobile à moins qu’il ne s’abonne également à votre site web depuis cet appareil mobile, créant ainsi un Abonnement web push distinct. De nouveaux Abonnements Web push sont créés dans ces scénarios :

• L’utilisateur s’abonne à votre site web en cliquant sur “Autoriser” sur l’invite d’autorisation native au niveau du système du navigateur. Cela génère un jeton push et un ID d’Abonnement uniques.
• L’utilisateur efface les données du navigateur (historique, cache, cookies, stockage local) et revisite votre site. Cela entraîne la création d’un nouvel ID d’Abonnement unique.

​

Mise à jour des Abonnements Web push

Il est recommandé de mettre à jour les propriétés des Abonnements Web push via le SDK web OneSignal.

• Demander les autorisations push et observer les changements d’autorisation/Abonnement
• Connecter les utilisateurs pour définir l’External ID et les Alias
• Ajouter des Tags
• Définir la Langue

Vous pouvez mettre à jour les tags, la langue et d’autres propriétés via la fonctionnalité Import CSV. Les Abonnements Web push ne peuvent pas être créés via l’API REST mais peuvent être mis à jour avec les APIs Users et Subscriptions, mais le SDK web est recommandé pour la plupart des cas d’utilisation.

​

Gestion des désabonnements et jetons push invalides

Les Abonnements Web push cessent de recevoir des notifications push si l’utilisateur :

• Efface les données du navigateur (historique, cache, cookies, stockage local)
• Désactive le push dans les paramètres système du navigateur
• Le jeton push expire

Dans ces cas, le statut de l’Abonnement sera défini sur Désabonné lors de l’envoi de notifications push. Voir ci-dessous Quand les statuts d’abonnement push se mettent-ils à jour ? pour plus de détails.

• Si l’utilisateur revient sur le site après avoir effacé les données du navigateur, un nouvel Abonnement sera créé et il sera automatiquement réabonné pour recevoir des messages si vous avez l’auto-réabonnement activé.
• Si l’utilisateur réactive le push dans les paramètres du navigateur, le statut de l’Abonnement sera défini sur Abonné lorsqu’il reviendra sur le site.
• Si le jeton push expire, le statut de l’Abonnement et le nouveau jeton push seront mis à jour lorsque l’utilisateur reviendra sur le site.

Suivez les changements via :

• Event Streams - détecte les désabonnements lors de l’envoi de push
• Rapports push - détecte les désabonnements lors de l’envoi de push
• Utilisez l’écouteur de changement d’Abonnement du SDK - détecte les désabonnements lorsque l’utilisateur désactive le push puis revient sur le site

---

​

Abonnements Email

Les Abonnements Email sont basés sur l’adresse e-mail et utilisés uniquement pour la livraison d’e-mails. Ceci est différent de la définition d’un Tag. Créez des Abonnements Email via :

1. La méthode SDK addEmail ou l’invite email - utilisez ces méthodes après avoir appelé OneSignal.login pour définir l’External ID et lier l’Abonnement à l’utilisateur.
2. L’API Create user ou l’API Create email
3. L’Importateur CSV du tableau de bord ou ajoutez manuellement des adresses e-mail

​

Gestion des Abonnements Email

Lier à un utilisateur Assurez-vous de définir l’external_id lors de la création d’Abonnements Email pour les lier à un User.

• En utilisant le SDK, appelez la méthode login avant d’appeler addEmail pour définir l’external_id et lier l’Abonnement email à l’utilisateur.
• En utilisant l’Importateur CSV ou l’API REST, définissez l’identifiant external_id avec l’e-mail.

Statuts d’Abonnement Les Abonnements Email nouvellement créés seront automatiquement définis sur Abonné sauf indication contraire. Les Abonnements Email peuvent devenir désabonnés lorsque :

• Lors de l’envoi d’e-mails, l’utilisateur se désabonne via le lien de désabonnement
• En définissant enabled sur false via l’API
• En utilisant le tableau de bord pour désabonner l’Abonnement via le bouton d’options Les Abonnements Email peuvent être réabonnés via :
• En définissant enabled sur true via l’API
• En utilisant le tableau de bord pour abonner l’Abonnement via le bouton d’options

Si un utilisateur se désabonne des e-mails, vous pouvez le garder comme désabonné mais lui envoyer des e-mails importants en envoyant aux e-mails désabonnés.

---

​

Abonnements SMS

Les Abonnements SMS sont liés aux numéros de téléphone au format E.164 (par ex., +14155551234). Créés via :

1. La méthode SDK addSms ou l’invite SMS — appelez d’abord OneSignal.login pour définir l’External ID et lier l’Abonnement à l’utilisateur.
2. L’API Create user ou l’API Create SMS
3. L’Importateur CSV du tableau de bord

​

Gestion des Abonnements SMS

Lier à un utilisateur Définissez l’external_id lors de la création d’Abonnements SMS pour les lier à un User.

• En utilisant le SDK, appelez la méthode login avant d’appeler addSms pour définir l’external_id et lier l’Abonnement SMS à l’utilisateur.
• En utilisant l’Importateur CSV ou l’API REST, définissez l’identifiant external_id avec le numéro de téléphone.

Statuts d’Abonnement Les Abonnements SMS nouvellement créés sont automatiquement définis sur Abonné sauf indication contraire. Les Abonnements SMS peuvent devenir désabonnés lorsque :

• L’utilisateur répond avec “STOP” ou un autre mot-clé de désabonnement
• Vous définissez enabled sur false via l’API
• Vous désabonnez l’Abonnement dans le tableau de bord via le bouton d’options

Les Abonnements SMS peuvent être réabonnés lorsque :

• L’utilisateur répond avec “START” ou un autre mot-clé d’abonnement
• Vous définissez enabled sur true via l’API
• Vous réabonnez l’Abonnement dans le tableau de bord via le bouton d’options

---

​

Importer ou migrer des Abonnements

Importez les jetons push, adresses e-mail et numéros de téléphone d’un autre fournisseur en utilisant :

• L’API Create user
• L’API Create Subscription

---

​

Supprimer des Abonnements

Les Abonnements peuvent être supprimés pour :

• La confidentialité des données
• Le nettoyage des enregistrements inactifs

---

​

FAQ

​

Quand les statuts d’abonnement push se mettent-ils à jour ?

Les statuts d’abonnement push se mettent à jour via deux mécanismes : 1. Lorsque l’utilisateur ouvre votre application ou votre site Le SDK OneSignal vérifie si le jeton push est valide et si les autorisations de notification sont toujours accordées, puis met à jour immédiatement le statut de l’abonnement. Par exemple, si un utilisateur désactive les notifications push dans les paramètres de son appareil puis rouvre votre application, le SDK détecte le changement et marque l’abonnement comme Désabonné immédiatement. Vous pouvez capturer ces changements avec l’Observateur d’Abonnement du SDK (mobile | web) pour synchroniser le statut avec votre propre base de données. 2. Lorsque vous envoyez des notifications push Si un utilisateur désinstalle votre application, efface les données du navigateur, ou désactive le push et ne revient jamais, OneSignal ne peut pas détecter le changement jusqu’à ce que vous envoyiez une notification. Le service push (FCM, APNs, HMS) signale le jeton comme invalide et OneSignal marque l’abonnement comme Désabonné. Cette détection nécessite généralement 2 messages ou plus car le service push ne rejette pas immédiatement un jeton invalide : Utilisez Event Streams pour détecter les désabonnements en temps réel lors de l’envoi de messages.

​

Si un utilisateur désactive les notifications dans les paramètres de son appareil et ne rouvre jamais l’application, que se passe-t-il ?

L’abonnement reste marqué comme Abonné dans OneSignal jusqu’à ce que vous envoyiez une notification à cet appareil. Après 2 tentatives d’envoi ou plus, le service push signale le jeton comme invalide et OneSignal marque l’abonnement comme Désabonné. Voir Quand les statuts d’abonnement push se mettent-ils à jour ? ci-dessus pour la séquence complète.

---

​

Pages connexes