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 :

• E-mail – pour envoyer des messages e-mail
• SMS – pour envoyer des messages texte
• Web Push – pour les notifications push via les navigateurs web
• Mobile – pour les notifications push, les messages in-app et les Live Activities sur les appareils mobiles

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

---

​

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é). Cependant, il existe quelques exceptions : Abonnements mobiles

• Abonné : L’utilisateur a accordé la permission de recevoir des notifications push.
  • Si vous avez activé le push provisionnel iOS, alors tous les Abonnements mobiles iOS sont Abonnés jusqu’à ce qu’ils soient désactivés par l’utilisateur.
• Désabonné : L’Abonnement ne peut pas recevoir de notifications push mais peut recevoir des messages in-app.
  • Voir Gestion des désinstallations, désabonnements et jetons push invalides pour plus de détails.
• Jamais Abonné – L’utilisateur n’a jamais accordé la permission (identique à désabonné).

Abonnements Web

• Abonné : L’utilisateur a accordé la permission de recevoir des notifications push.
• Désabonné : L’Abonnement ne peut pas recevoir de notifications push.
  • Voir Gestion des désabonnements et jetons push invalides ci-dessous pour plus de détails.

Abonnements E-mail

• Abonné : L’utilisateur devrait avoir fourni son consentement pour recevoir des messages e-mail et l’adresse e-mail est valide.
• Désabonné : L’utilisateur s’est désabonné de la réception d’e-mails mais cela peut être contourné si nécessaire.
  • Voir Abonnements E-mail ci-dessous pour plus de détails.

Abonnements SMS

• Abonné : L’utilisateur devrait avoir fourni son consentement pour recevoir des messages SMS et le numéro de téléphone est valide.
• Désabonné : L’utilisateur s’est désabonné de la réception de messages SMS.
  • Voir Abonnements SMS ci-dessous pour plus de détails.

---

​

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. Créés via :

1. La méthode SDK addSms ou l’invite SMS - 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 SMS
3. L’Importateur CSV

​

Gestion des Abonnements SMS

• L’utilisateur se désabonne en répondant avec “STOP” ou d’autres mots-clés de consentement SMS
  • L’utilisateur peut également se réabonner en répondant avec “START” ou d’autres mots-clés de consentement SMS
• Mettez à jour l’Abonnement via la propriété enabled de l’API

---

​

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

Voir Supprimer des utilisateurs pour plus de détails.

---

​

FAQ

​

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

Les statuts d’Abonnement push sont mis à jour :

1. Lorsque l’utilisateur ouvre l’application, le SDK OneSignal vérifiera si le jeton push est valide et si les autorisations de notification sont accordées, puis mettra à jour le statut de l’Abonnement en conséquence.

• Vous pouvez capturer cet événement avec nos méthodes d’observation d’Abonnement SDK et l’envoyer à votre base de données.

2. Après l’envoi de 2+ notifications à l’Abonnement. Utilisez Event Streams pour détecter les désabonnements lors de l’envoi de messages.

Exemple :

• Message 1 : Livré. L’utilisateur le reçoit sur l’appareil, puis l’utilisateur se désabonne dans les paramètres de l’appareil.
• Message 2 : Livré (mais l’appareil ne le reçoit pas).
• Message 3 : Échoue (marqué comme désabonné)
• Message 4 : Non envoyé à l’Abonnement.

​

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 ?

Lorsque les utilisateurs désactivent les notifications dans les paramètres de l’appareil, ils ne peuvent plus recevoir de notifications push sur cet appareil. Ils seront marqués comme désabonnés après l’envoi de notifications à l’appareil. Voir Quand les statuts d’Abonnement push se mettent-ils à jour ? pour plus de détails.

---