Résolution des problèmes des notifications push
Utilisez cette page pour diagnostiquer les problèmes de distribution et d’affichage des notifications push sur un appareil. Pour les vérifications de distribution côté tableau de bord (statut d’abonnement, segments, plafonds), consultez Résolution des problèmes des notifications push.
Avant de déboguer, ajoutez-vous en tant qu’utilisateur test et consultez Envoi de messages de test.
Commencez ici : identifiez votre symptôme
Trouvez le comportement que vous observez dans le tableau, puis suivez les étapes de la section correspondante. Si vous ne savez pas quelle section s’applique, utilisez le parcours d’investigation standard.
| Symptôme | Aller à |
|---|---|
| Notification push non reçue sur une plateforme | Sélectionnez l’onglet de votre SDK dans Résolution des problèmes spécifiques à la plateforme |
| Les sauts de ligne autour des étiquettes Liquid semblent incorrects lors de l’enregistrement | Sauts de ligne dans les notifications push |
| Vérifications de distribution dans le tableau de bord (abonnement, segment, plafonds) | Résolution des problèmes des notifications push |
| Le deep link d’une notification push ne s’ouvre pas correctement | Résolution des problèmes de deep linking |
| Codes d’erreur courants des notifications push | Messages d’erreur courants des notifications push |
Parcours d’investigation standard
Utilisez ce flux de travail pour chaque incident de notification push. Commencez à l’étape 1.
- Confirmez que l’appareil dispose d’un jeton push valide et que l’autorisation push est accordée dans les paramètres de l’appareil.
- Dans le tableau de bord, confirmez que l’utilisateur test correspond au Segment de la Campaign ou du Canvas et qu’il ne fait pas partie du groupe de contrôle.
- Envoyez une notification push de test à l’appareil de test.
- Activez la journalisation détaillée, reproduisez le problème et consultez les conseils spécifiques à la plateforme dans votre onglet SDK.
- Si le problème persiste, contactez l’Assistance Braze en fournissant les journaux détaillés, la plateforme, la version du SDK et l’ID de la Campaign ou du Canvas.
Les clics push ne sont pas enregistrés
- Assurez-vous d’avoir suivi les étapes d’intégration push.
- Braze ne gère pas les notifications push reçues silencieusement au premier plan (comportement push au premier plan par défaut avant le framework
UserNotifications). Cela signifie que les liens ne seront pas ouverts et que les clics push ne seront pas enregistrés. Si votre application n’a pas encore intégré le frameworkUserNotifications, Braze ne gérera pas les notifications push lorsque l’état de l’application estUIApplicationStateActive. Assurez-vous que votre application ne retarde pas les appels aux méthodes de gestion push ; sinon, le SDK Swift pourrait traiter les notifications push comme des événements push silencieux au premier plan et ne pas les gérer.
Sauts de ligne dans les notifications push
Lors de la rédaction de notifications push avec des étiquettes Liquid, les sauts de ligne adjacents aux étiquettes Liquid sont automatiquement supprimés avant l’envoi du message. Dans le compositeur de notifications push, ces sauts de ligne sont réajoutés afin que votre message reste lisible pendant la modification. Si vous remarquez des sauts de ligne autour des étiquettes Liquid lors de l’enregistrement de votre message, il s’agit d’un comportement attendu.