Si vous rencontrez des problèmes avec votre site web et aucune application mobile, consultez notre guide de dépannage du push web.
Étapes de dépannage
1. Consultez les instructions de configuration et mettez à jour le SDK OneSignal
Nos instructions de configuration du SDK mobile sont conçues pour aider à prévenir les problèmes courants et tester l’intégration. 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. Si vous rencontrez des problèmes, assurez-vous d’abord que vous utilisez notre dernière version du SDK et que vous avez suivi les instructions de configuration.2. Guides de dépannage courants
Notifications non affichées ou retardées
Envoi de notifications push qui ne s’affichent pas sur l’appareil ou sont retardées.
Images de notification non affichées
Les images de notification ne s’affichent 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 sont affichées plusieurs fois.
Dépannage des messages in-app
Dépannez les problèmes courants avec les messages in-app.
3. Testez le projet d’exemple pour votre SDK
Vérifiez si votre problème est reproductible en utilisant la version créée par notre équipe d’ingénierie pour chaque SDK.- Projet d’exemple iOS
- Projet d’exemple Android
- Projet d’exemple variantes Cordova
- Projet d’exemple React Native
- Projet d’exemple Flutter
- Projet d’exemple Unity
- Projet d’exemple .NET Maui
4. Vérifiez les journaux d’erreurs
Avant de diagnostiquer les problèmes, il est important de collecter les données de journalisation :- Suivez notre 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.
5. Contactez le support
Si vous rencontrez toujours des problèmes :- Contactez
support@onesignal.comavec :- Votre ID d’application OneSignal.
- Votre ID externe et/ou ID d’abonnement de l’appareil sur lequel vous rencontrez le problème.
- L’ID de notification ou un lien vers la notification dans le tableau de bord OneSignal, le cas échéant.
- Un journal de débogage de l’appareil reproduisant le problème si possible.
Erreurs courantes
APNS Delegate never fired
Les erreurs APNS comme “Apns Delegate Never Fired” et “APNS 3000” sont des messages de timeout fournis par Apple indiquant que l’appareil n’a pas pu établir de connexion avec les serveurs APNS d’Apple requis pour les notifications push. Cela est plus courant lorsque :- Test sur des environnements de développement APNS
- Si vous utilisez plusieurs dépendances de notification push ou des API push iOS natives avec OneSignal
- Erreur temporaire qui se résout d’elle-même la prochaine fois que l’utilisateur démarre une nouvelle session (application mise hors focus pendant 30+ secondes, puis rouverte).
- Supprimez toutes les autres dépendances de notification push ou API push iOS natives et utilisez uniquement OneSignal. Une fois l’erreur résolue, vous pouvez essayer de rajouter l’autre code et contacter
support@onesignal.compour les meilleures pratiques. - Vérifiez le journal de débogage de l’appareil pour plus de détails.
- Si l’erreur persiste, suivez ces étapes pour contacter le support.
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 :- https://support.apple.com/en-us/HT203609
- https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall