Résolution des problèmes de la fonctionnalité Push

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

Notifications push manquantes

Vous rencontrez des difficultés de distribution avec vos notifications push ? Plusieurs étapes vous permettent de résoudre ce problème en vérifiant :

• Statut d’abonnement aux push
• Segment
• Limites de notification push
• Limites de débit
• Statut du groupe de contrôle
• Jeton push valide
• Type de notification push
• Application actuelle

Statut d’abonnement aux push

Les notifications push ne peuvent être envoyées qu’aux utilisateurs abonnés ou ayant explicitement donné leur accord. Vérifiez votre profil utilisateur dans l’onglet Engagement de la section Profil utilisateur pour confirmer que vous êtes activement inscrit aux push pour l’espace de travail que vous testez. Si vous êtes inscrit à plusieurs applications, vous les trouverez dans le champ Push Registered For :

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

• Utilisateurs par identifiant
• Utilisateurs par segment

Chaque endpoint renvoie un objet de jeton de notification push qui inclut des informations d’activation push par appareil.

Segment

Assurez-vous de faire partie du segment que vous ciblez (s’il s’agit d’une campagne en production et non d’un test). Dans le Profil utilisateur, 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 la Recherche d’utilisateurs lors de la création d’un segment.

Limites de notification push

Vérifiez les limites de fréquence globales. Il est possible que vous n’ayez pas reçu la notification push car votre espace de travail applique 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.

Pour cela, vérifiez 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 affecté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 les messages en raison du dépassement de cette limite. Pour plus d’informations, consultez la section 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 groupe de contrôle de la campagne, puis exportez le segment et vérifiez si votre ID utilisateur figure dans cette liste.

Jeton 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 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 les flux de travail dans Braze pour :

• Apple Push Notification
• Firebase Cloud Messaging

Application actuelle

Lorsque vous testez les envois push avec des utilisateurs internes, assurez-vous que l’utilisateur qui doit recevoir la notification push est actuellement connecté à l’application concernée. Dans le cas contraire, l’utilisateur pourrait ne pas recevoir la 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 directement les liens profonds et l’application devrait s’ouvrir normalement.
   • 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 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 à l’assistance 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 un 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 personnalisée des délégués.
3. Collectez les journaux détaillés : Activez la journalisation détaillée, reproduisez le problème et fournissez les journaux à l’assistance Braze.

Les clics push s’ouvrent de manière inattendue dans l’application

Si les liens de vos notifications push 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. Suivez ces étapes pour obtenir de l’aide.

Vérifier le comportement au clic

Dans votre campagne ou étape du canvas, vérifiez que l’option Ouvrir l’URL web dans l’application mobile n’est pas sélectionnée. Si c’est le cas, décochez-la et relancez.

L’interaction par défaut pour le comportement au clic « Ouvrir l’URL web » diffère selon la version du SDK. Pour les versions du SDK iOS 2.29.0 et Android 2.0.0 et ulté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ésactivé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 se peut qu’il y ait un souci avec votre implémentation push.

Revérifier l’intégration push

Si les liens de vos notifications push s’ouvrent dans l’application de manière inattendue, cela peut être dû à des problèmes liés à votre intégration des 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. Vérifiez la gestion personnalisée des liens : Vérifiez si l’application inclut un traitement personnalisé 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, revenez à l’étape 1 du guide d’intégration push concernant l’enregistrement des notifications push avec les APN. Assurez-vous que votre objet délégué est assigné de manière synchrone avant que l’application ne finisse de se lancer. Cette étape doit être réalisé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.

Le titre du push est tronqué sur iOS mais s’affiche correctement sur Android

Si le titre de votre notification push contient une personnalisation Liquid et apparaît complet sur Android mais tronqué sur iOS, cela est dû à la manière dont chaque plateforme gère les caractères de retour à la ligne (\n) dans la chaîne de caractères du titre.

Android supprime automatiquement les espaces, tabulations et retours à la ligne des chaînes de caractères de titre push. iOS ne le fait pas : si une variable Liquid se résout en une valeur contenant un retour à la ligne final, iOS traite ce retour à la ligne comme la fin du titre et coupe le texte restant.

Par exemple, un titre comme Regarding your flight from {{${city_from}}} to {{${city_to}}} pourrait afficher Regarding your flight from sur iOS si la variable city_from inclut un retour à la ligne final.

Pour corriger cela, appliquez le filtre Liquid strip_newlines et encapsulez l’ensemble du titre dans un bloc capture :

1
2
{% capture title %}Regarding your flight from {{${city_from}}} to {{${city_to}}}{% endcapture %}
{{ title | strip_newlines }}

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. Suivez 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 toujours besoin d’aide ? Ouvrez un ticket d’assistance.