Passer au contenu principal
Si vous rencontrez des problèmes avec votre site web, consultez le guide de dépannage du push web.

​
Étapes de dépannage

​
Consultez les instructions de configuration et mettez à jour le SDK

Nous publions fréquemment des mises à jour avec des corrections de bugs, des améliorations et la prise en charge des derniers changements du système d’exploitation. Assurez-vous d’utiliser la dernière version du SDK et d’avoir suivi les instructions de configuration.

Configuration du SDK mobile

Instructions de configuration conçues pour aider à prévenir les problèmes courants et tester l’intégration.

​
Consultez les guides de dépannage courants

Notifications non affichées ou retardées

Les notifications push n’apparaissent pas sur l’appareil ou sont retardées.

Images de notification non affichées

Les images n’apparaissent pas dans la vue développée de la notification.

CTR des notifications

Faible taux de clics ou absence de clics sur les notifications.

Notifications en double

Les notifications apparaissent plusieurs fois sur l’appareil.

Dépannage des messages in-app

Les messages in-app ne s’affichent pas ou ne se comportent pas comme prévu.

​
Vérifiez les problèmes courants dans votre app

​
Méthodes OneSignal qui bloquent l’affichage des push

Vérifiez si votre app contient des méthodes comme optOut(), par exemple OneSignal.User.pushSubscription.optOut(), ou si vous avez défini enabled: false via nos REST APIs. Cela définit le statut de l’abonnement push sur unsubscribed. Consultez la référence du SDK mobile pour plus de détails. Si l’app est ouverte pendant l’envoi du push, vous pouvez empêcher l’affichage du push via la méthode preventDefault(). Cela est généralement défini dans le Listener d’Événements en Avant-Plan ou l’Extension de Service de Notification Android.

​
Conflits avec Firebase Messaging ou d’autres SDKs

Si votre app inclut également le Firebase Messaging SDK ou d’autres SDKs de notifications push, vérifiez qu’ils n’interceptent pas les messages avant que OneSignal puisse les traiter. Ce problème se produit souvent quand :
  • Les notifications apparaissent comme Livrées dans OneSignal mais n’apparaissent jamais sur l’appareil.
  • L’app inclut à la fois OneSignal et firebase_messaging (ou un FirebaseMessagingService personnalisé).
  • Le push fonctionne quand Firebase Messaging est supprimé, mais échoue quand les deux SDKs sont présents.
  1. Vérifiez votre AndroidManifest.xml pour les récepteurs Firebase legacy comme com.google.firebase.iid.FirebaseInstanceIdReceiver et supprimez-les/excluez-les conditionnellement si OneSignal est responsable de la livraison push.
  2. Vérifiez les implémentations personnalisées de FirebaseMessagingService (ou les bibliothèques comme firebase_messaging dans Flutter) qui remplacent onMessageReceived. Si un autre service traite ou supprime complètement les messages, il peut consommer le payload FCM avant que OneSignal puisse afficher la notification.
  3. Évitez d’appeler les APIs de gestion des tokens Firebase comme : FirebaseMessaging.getToken() ou FirebaseMessaging.deleteToken().
Si OneSignal est responsable de la livraison push, il doit être le seul SDK gérant le cycle de vie du token push. Récupérer ou gérer le token FCM directement peut entraîner des conflits de propriété du token et un comportement de livraison incohérent. Si vous avez besoin du token push de l’appareil pour d’autres systèmes, lisez-le depuis OneSignal (par exemple, User.pushSubscription.token) et écoutez les changements d’abonnement/token en utilisant les APIs d’observateur du SDK.

​
Testez le projet d’exemple pour votre SDK

Vérifiez si votre problème est reproductible en utilisant le projet d’exemple maintenu par notre équipe d’ingénierie pour chaque SDK.

​
Vérifiez les journaux d’erreurs

Collectez les données de journalisation avant de diagnostiquer davantage :
  • Suivez le guide sur la capture d’un journal de débogage.
  • Recherchez les erreurs, les avertissements ou les avis de dépréciation qui pourraient expliquer le comportement.

Capture d'un journal de débogage

Comment activer la journalisation détaillée et capturer la sortie du SDK pour le dépannage.

​
Contactez le support

Si vous rencontrez toujours des problèmes, contactez support@onesignal.com avec :
  • Votre ID d’application OneSignal
  • L’ID externe et/ou l’ID d’abonnement de l’appareil affecté
  • L’ID de notification ou un lien vers la notification dans le tableau de bord (le cas échéant)
  • Un journal de débogage de l’appareil reproduisant le problème

​
Erreurs courantes

​
APNS Delegate never fired

Les erreurs comme « APNS Delegate Never Fired » et « APNS 3000 » sont des messages de timeout d’Apple indiquant que l’appareil n’a pas pu se connecter aux serveurs APNS d’Apple. Cela est plus courant lorsque :
  • Test sur des environnements de développement APNS
  • Utilisation de plusieurs dépendances de notification push ou d’APIs push iOS natives avec OneSignal
  • Un problème de connectivité temporaire — cela se résout souvent lors de la prochaine fois que l’utilisateur démarre une nouvelle session (application en arrière-plan pendant 30+ secondes, puis rouverte)
Étapes pour résoudre :
  1. Supprimez toutes les autres dépendances de notification push ou APIs push iOS natives et utilisez uniquement OneSignal. Une fois l’erreur résolue, vous pouvez rajouter l’autre code. Contactez support@onesignal.com pour les meilleures pratiques de coexistence.
  2. Vérifiez le journal de débogage de l’appareil pour plus de détails.
  3. Si l’erreur persiste, contactez le support.

​
L’application ne s’ouvre pas lorsqu’elle est fermée de force et qu’on clique sur une notification

Assurez-vous de ne pas tester sur une version Debug. Par exemple, pour les applications Flutter, vous pouvez :
  • Utiliser une version release via Flutter, par exemple flutter run --release (nécessite un appareil physique)
  • Mettre à jour le schéma Xcode en Release au lieu de Debug

​
Pages connexes

Configuration du SDK mobile

Instructions de configuration pour tous les SDKs mobiles et cross-platform pris en charge.

Capture d'un journal de débogage

Comment capturer les journaux du SDK pour le dépannage.

Dépannage du push web

Dépannez les problèmes de notifications push web.

Référence du SDK mobile

Référence complète de l’API pour les SDKs mobiles OneSignal.

​
FAQ

​
Que se passe-t-il si je change mon ID d’application OneSignal dans mon application ?

Changer l’ID d’application OneSignal dans le code d’initialisation de votre application créera un tout nouvel utilisateur et un abonnement push sous le nouvel ID d’application lorsque l’utilisateur met à jour et ouvre l’application vers la dernière version. Si votre ID de bundle iOS et/ou ID de package Android sont les mêmes, alors l’appareil continuera avec le même statut d’abonnement push. Les données utilisateur seront toutes neuves, c’est-à-dire que vous devrez ajouter à nouveau vos alias, tags, adresse email, numéro de téléphone sur le nouvel enregistrement. Si l’ID de bundle iOS ou l’ID de package Android sont différents, alors c’est une toute nouvelle application et devrait avoir des certificats/clés push différents.

​
OneSignal peut-il envoyer des notifications push dans un réseau fermé sur site ?

Cela peut fonctionner tant que les ordinateurs de votre réseau fermé ont accès aux serveurs de passerelle push que vous souhaitez prendre en charge : Si le réseau est complètement déconnecté d’Internet, les notifications push ne peuvent pas être livrées via les services standard du système d’exploitation/navigateur, ce qui est ce que nous prenons en charge.