Résolution des problèmes des notifications push

Utilisez cette page pour résoudre les problèmes liés au canal de communication des notifications push.

Notifications push manquantes

Vous rencontrez des difficultés de distribution avec les notifications push ? Voici un certain nombre d’étapes que vous pouvez suivre pour résoudre ce problème en vérifiant :

• Le statut d’abonnement aux notifications push
• Le segment
• Les plafonds de notifications push
• Les limites de débit
• Le statut du groupe de contrôle
• Le jeton de notification push valide
• Le type de notification push
• L’application actuelle

Statut d’abonnement aux notifications push

Les notifications push ne peuvent être envoyées qu’aux utilisateurs abonnés ou ayant donné leur consentement explicite. Vérifiez votre profil utilisateur dans l’onglet Engagement de la section User Profile pour confirmer que vous êtes bien enregistré pour les notifications push dans l’espace de travail que vous testez. Si vous êtes enregistré pour plusieurs applications, elles apparaîtront dans le champ Push Registered For :

Vous pouvez également exporter les profils utilisateurs à l’aide des endpoints d’exportation de Braze :

• Utilisateurs par identifiant
• Utilisateurs par segment

Ces deux endpoints renvoient un objet de jeton de notification push qui inclut les informations d’activation des notifications push par appareil.

Segment

Assurez-vous que vous faites partie du segment que vous ciblez (s’il s’agit d’une campagne en production et non d’un test). Dans le User Profile, vous verrez la liste des segments auxquels l’utilisateur appartient actuellement. N’oubliez pas qu’il s’agit d’une variable en constante évolution, car la segmentation est mise à jour en temps réel.

Vous pouvez également confirmer que l’utilisateur fait partie du segment en utilisant User Lookup lors de la création d’un segment.

Plafonds de notifications push

Vérifiez les limites de fréquence globales. Il est possible que vous n’ayez pas reçu la notification push parce que votre espace de travail dispose d’une limite de fréquence globale et que vous avez déjà atteint votre plafond de notifications push pour la période spécifiée.

Vous pouvez vérifier cela en consultant la limite de fréquence globale dans le tableau de bord. Si la campagne est configurée pour respecter les règles de limite de fréquence, un certain nombre d’utilisateurs seront impactés par ces paramètres.

Limites de débit

Si vous avez défini une limite de débit pour votre campagne ou Canvas, il est possible que vous ne receviez pas le message en raison du dépassement de cette limite. Pour plus d’informations, consultez Limitation du débit.

Statut du groupe de contrôle

S’il s’agit d’une campagne à canal unique ou d’un Canvas avec un groupe de contrôle, il est possible que vous fassiez partie du groupe de contrôle.

1. Vérifiez la distribution des variantes pour voir s’il existe un groupe de contrôle.
2. Si c’est le cas, créez un segment filtrant par dans le groupe de contrôle de la campagne, puis exportez le segment et vérifiez si votre ID utilisateur figure dans cette liste.

Jeton de notification push valide

Un jeton de notification push est un identifiant que les expéditeurs utilisent pour cibler des appareils spécifiques avec une notification push. Ainsi, si l’appareil ne dispose pas d’un jeton de notification push valide, il n’y a aucun moyen de lui envoyer une notification push.

Type de notification push

Vérifiez que vous utilisez le bon type de notification push. Par exemple, si vous souhaitez cibler un FireTV, vous devez utiliser une notification push Kindle, et non une campagne push Android. De même, si vous souhaitez cibler un appareil Android, utilisez une notification push Android et non une campagne push iOS. Consultez les articles suivants pour en savoir plus sur le flux de travail Braze pour :

• Apple Push Notification
• Firebase Cloud Messaging

Application actuelle

Lorsque vous testez l’envoi de notifications push avec des utilisateurs internes, assurez-vous que l’utilisateur qui doit recevoir la notification push est actuellement connecté à l’application concernée. Cela peut amener l’utilisateur à ne pas recevoir de notification push ou à recevoir une notification push pour laquelle vous pensez qu’il n’est pas segmenté.

Cliquer sur une notification push n’ouvre pas l’application

Si cliquer sur une notification push n’ouvre pas votre application, vérifiez les points suivants en fonction de votre plateforme.

Android

1. Vérifiez le comportement au clic : Confirmez que la campagne est configurée pour ouvrir l’application lorsqu’on clique dessus.
2. Vérifiez la gestion des liens profonds : Dans votre fichier braze.xml, vérifiez si com_braze_handle_push_deep_links_automatically est défini sur true ou false.
   • S’il est défini sur true, le SDK Braze gère les liens profonds directement et l’application devrait s’ouvrir comme prévu.
   • S’il est défini sur false, votre application a besoin d’un récepteur de diffusion pour écouter et gérer les intentions de réception et d’ouverture des notifications push. Vérifiez que ce récepteur est correctement implémenté.
3. Collectez les journaux détaillés : Activez la journalisation détaillée, reproduisez le problème et fournissez les journaux ainsi que vos fichiers braze.xml et AndroidManifest.xml au support Braze.

iOS

1. Vérifiez le comportement au clic : Confirmez que la campagne est configurée pour ouvrir l’application lorsqu’on clique dessus.
2. Vérifiez l’intégration push : La création de liens profonds depuis une notification push vers l’application est automatiquement gérée par l’intégration push standard de Braze. Confirmez que l’intégration est correctement implémentée, y compris toute gestion de délégué personnalisée.
3. Collectez les journaux détaillés : Activez la journalisation détaillée, reproduisez le problème et fournissez les journaux au support Braze.

Les clics sur les notifications push ouvrent de manière inattendue dans l’application

Si vous rencontrez des problèmes avec des liens dans les notifications push qui s’ouvrent de manière inattendue dans votre application au lieu de votre navigateur web, il peut y avoir un problème avec la configuration de votre campagne ou l’implémentation du SDK. Consultez ces étapes pour obtenir de l’aide.

Vérifiez le comportement au clic

Dans votre campagne ou étape Canvas, vérifiez que Open web URL inside mobile app n’est pas sélectionné. Si c’est le cas, désélectionnez l’option et relancez.

L’interaction par défaut pour le comportement au clic « Open web URL » diffère selon la version du SDK. Pour les versions du SDK iOS 2.29.0 et Android 2.0.0 et supérieures, cette option est sélectionnée par défaut et les URL web s’ouvrent dans une vue web au sein de l’application. Avant ces versions, cette option est désélectionnée par défaut et les URL web s’ouvrent dans le navigateur web par défaut de l’appareil.

Si ce n’est pas le problème, il peut y avoir un souci avec votre implémentation push.

Revérifiez l’intégration push

Si les liens dans vos notifications push s’ouvrent de manière inattendue dans l’application, cela peut être dû à des problèmes avec votre intégration de notifications push ou vos paramètres de personnalisation. Suivez ces étapes pour résoudre le problème :

1. Examinez l’implémentation du délégué push : Assurez-vous que le délégué push de Braze est correctement implémenté. Pour des instructions détaillées, consultez le guide d’intégration des notifications push pour votre plateforme.
2. Inspectez la gestion personnalisée des liens : Vérifiez si l’application inclut une gestion personnalisée pour tous les liens https://. Les configurations personnalisées peuvent remplacer les comportements par défaut. Collaborez avec votre équipe de développement pour examiner et ajuster ces paramètres si nécessaire.
3. Vérifiez l’enregistrement push iOS : Pour iOS, revisitez l’étape 1 du guide d’intégration push sur l’enregistrement des notifications push auprès d’APNs. Assurez-vous que votre objet délégué est assigné de manière synchrone avant que l’application ne termine son lancement. Cette étape doit être effectuée dans la méthode application:didFinishLaunchingWithOptions:.
4. Testez votre intégration : Après avoir effectué les ajustements, testez le comportement des notifications push sur les appareils iOS et Android pour confirmer que le problème est résolu.

Migrer vers une clé d’authentification .p8

Les clés d’authentification Apple .p8 sont l’approche requise pour les notifications push APNs dans Braze. Contrairement aux types de fichiers de certificat hérités, les clés .p8 n’expirent pas et prennent en charge toutes vos applications sous une seule clé, éliminant ainsi le besoin de renouvellements annuels de certificats et réduisant le risque d’échecs de distribution des notifications push.

Si vous utilisez actuellement un certificat .p12 ou .pem, migrez vers une clé .p8 dès que possible. Pour les instructions sur la création et le téléchargement d’une clé .p8, consultez Télécharger votre certificat push APNs. Pour les recommandations d’Apple sur la génération d’une clé .p8 depuis votre compte développeur, consultez Communicate with APNs using authentication tokens.

Les notifications push web ne fonctionnent pas comme prévu

Si vous rencontrez des problèmes avec les notifications push dans votre navigateur, vous devrez peut-être réinitialiser les autorisations de notification de votre site et effacer le stockage de votre site. Consultez ces étapes pour obtenir de l’aide.

• chrome
• firefox
• safari

Messages d’erreur push

Pour des informations détaillées sur les messages d’erreur push courants (tels que DEVICE_UNREGISTERED, Unregistered, NotRegistered et autres), consultez Messages d’erreur push courants.

Vous avez encore besoin d’aide ? Ouvrez un ticket de support.