Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, ouvrez un ticket sur GitHub.
Tableau de bord de diagnostic des messages
Le tableau de bord Messaging Diagnostics fournit une vue d’ensemble des résultats d’envoi de messages, vous permettant de repérer les tendances et de diagnostiquer les problèmes potentiels dans votre configuration d’envoi de messages. Ce tableau de bord peut vous aider à comprendre pourquoi les messages de vos campagnes ou Canvas n’ont peut-être pas été envoyés comme prévu.
Important:
Le tableau de bord Messaging Diagnostics est actuellement en accès anticipé. Contactez votre gestionnaire de la satisfaction client si vous souhaitez participer à l’accès anticipé.
Concepts clés
Envoyé et distribué
Il est essentiel de comprendre que ce tableau de bord rend compte de la manière dont Braze a traité un message en interne, et non de l’état final de distribution du message.
Un message marqué comme « envoyé » dans ce tableau de bord signifie que Braze l’a traité et expédié avec succès. Pour la plupart des canaux, cela signifie que Braze a transmis le message au partenaire d’envoi tiers concerné. Cependant, cela ne garantit pas la distribution finale sur l’appareil de l’utilisateur.
Lorsque Braze « envoie » un message, la distribution finale peut dépendre de services externes. Voici quelques exemples pour chaque canal.
| Canal | Exemple de distribution finale |
|---|---|
| Cartes de contenu | La carte a été envoyée et peut être consultée. |
| Braze transmet le message à un fournisseur de services d’e-mailing (ESP). L’ESP est ensuite responsable de la distribution finale. Cet ESP peut, par exemple, signaler un « rebond » si l’adresse e-mail est invalide ou si la boîte de réception est pleine. | |
| Messages in-app | Le message a été affiché à l’utilisateur. |
| LINE | Le message a été transmis avec succès à un partenaire d’envoi. |
| Push | Braze transmet le message au service de notification push approprié (comme Apple Push Notification service pour iOS ou Firebase Cloud Messaging pour Android). Ce service est responsable de la distribution finale de la notification sur l’appareil. |
| SMS/MMS/RCS | Braze transmet le message à une passerelle SMS (comme Twilio). Cette passerelle est responsable de la distribution finale à l’opérateur mobile. |
| Webhooks | La requête webhook a été effectuée avec succès, renvoyant une réponse 2xx. |
| Le message a été transmis avec succès à un partenaire d’envoi. |
Fraîcheur des données
La fréquence de mise à jour des données de ce tableau de bord peut varier en fonction de la charge du système. Bien que la fréquence de mise à jour ne soit pas garantie, elle est généralement inférieure à une heure dans la plupart des cas.
Configuration du tableau de bord
Vous pouvez accéder au tableau de bord de diagnostic en allant dans Analytics > Générateur de tableaux de bord et en sélectionnant Messaging Diagnostics dans la liste des tableaux de bord créés par Braze.
Pour exécuter le tableau de bord et afficher vos données :
- Choisissez Campaigns ou Canvases comme source pour les rapports de votre tableau de bord.
- Sélectionnez une ou plusieurs campagnes ou Canvas.
- Sélectionnez Run Dashboard pour charger les données correspondant aux filtres sélectionnés.
Interprétation des données
Remarque:
Le tableau de bord affiche uniquement les données des sept derniers jours. Tous les horodatages sont affichés dans le fuseau horaire de votre espace de travail.
Tuiles récapitulatives
En haut de la page, des tuiles récapitulatives clés pour la période sélectionnée affichent :
- Total Aborts : Le nombre total de messages abandonnés. Cela inclut les membres de l’audience du Canvas qui n’ont pas intégré le Canvas ou qui en sont sortis parce qu’ils ont rencontré un échec d’étape ou rempli les critères de sortie lors de l’exécution d’un événement de sortie.
- Message Sends : Le nombre total de messages que Braze a traités et envoyés avec succès.
- E-mail, SMS/MMS/RCS, WhatsApp, LINE et push : Le message a été transmis avec succès à un partenaire d’envoi.
- Webhooks : La requête webhook a été effectuée avec succès, renvoyant une réponse
2xx. - Cartes de contenu : La carte a été envoyée et peut être consultée.
- Messages in-app : Le message a été affiché à l’utilisateur.
Résultats des messages au fil du temps
Ce graphique en série temporelle montre une ventilation jour par jour des différentes raisons pour lesquelles un message a été abandonné ou un utilisateur a été retiré d’un Canvas. Ce graphique n’affiche pas le nombre d’envois.
Remarque:
Pour garder le graphique lisible, toute raison d’abandon ou de retrait ayant zéro occurrence dans la période sélectionnée n’apparaît pas sur le graphique.
Ventilation des résultats des messages
Ce graphique montre la ventilation de tous les résultats des messages dans la période sélectionnée. Il fournit une vue complète de :
- Le nombre total d’envois en proportion de tous les résultats.
- La ventilation proportionnelle de chaque raison d’abandon et de retrait. Cela vous aide à identifier rapidement les raisons les plus courantes pour lesquelles les messages ne sont pas envoyés.
Résultats d’abandon
Les définitions suivantes expliquent les résultats d’abandon affichés sur le tableau de bord. Les résultats sont regroupés par catégorie pour faciliter la recherche de celui que vous examinez.
Contenu et rendu
| Résultat d’abandon | Explication |
|---|---|
| Carte de contenu expirée | La carte de contenu a expiré avant que l’utilisateur ne la voie. |
| Carte de contenu invalide | La carte de contenu contenait des erreurs et n’a pas été envoyée à l’utilisateur. Voici quelques raisons courantes :
|
| Échec du contenu connecté | Braze a tenté d’envoyer le message, mais le contenu connecté a échoué après le nombre maximal de tentatives (cinq par défaut). Remarque : Ce nombre représente le nombre de messages abandonnés en raison de l’atteinte du nombre maximal de tentatives, et non le nombre total de requêtes de contenu connecté ayant échoué. |
| Délai d’expiration du rendu du message in-app | Après plusieurs tentatives, le Liquid n’a pas pu être rendu et a expiré. |
| Abandon Liquid | L’étiquette Liquid abort_message a été appelée, l’envoi a donc été annulé. |
| Délai d’expiration du rendu Liquid | Le rendu du modèle Liquid a pris trop de temps. Cela se produit le plus souvent pour les bannières, les messages in-app et les e-mails. |
| Erreur de syntaxe Liquid | Le modèle Liquid contenait une erreur d’analyse, le message a donc été annulé. |
État de la campagne et du Canvas
| Résultat d’abandon | Explication |
|---|---|
| Échec de l’étape de délai | L’étape de délai a échoué, provoquant la sortie de l’utilisateur du Canvas. Cet échec peut se produire lorsque :
|
| Événement d’exception ou de sortie | L’utilisateur était précédemment éligible pour recevoir le message, mais
|
| Campagne inactive | La campagne a été arrêtée alors que le message était en cours de traitement, il a donc été abandonné. |
| Canvas inactif | Le Canvas a été arrêté avant que l’utilisateur n’entre dans le parcours. |
| Étape du Canvas inactive | Cela peut se produire dans le Canvas si :
|
| Limite de volume atteinte | La campagne a atteint la limite de volume définie, l’envoi a donc été annulé. |
Limite de débit et timing
| Résultat d’abandon | Explication |
|---|---|
| Limite de fréquence atteinte | L’utilisateur a déjà reçu le nombre maximal de messages autorisé selon les règles de limite de fréquence de votre espace de travail, l’envoi a donc été annulé. |
| Abandon pour heures calmes | Les heures calmes étaient activées pour la campagne ou l’étape du Canvas avec l’option de repli définie sur Abort message. L’utilisateur a déclenché la campagne ou est entré dans l’étape Message du Canvas pendant les heures calmes, le message a donc été abandonné. Cependant, cela ne fait pas sortir l’utilisateur du Canvas. |
| Limite de débit dépassée pendant plus de 72 heures | Le message a été limité pendant plus de 72 heures en raison des limites de débit de vitesse de distribution, l’envoi a donc été abandonné. |
Éligibilité de l’utilisateur et profil
| Résultat d’abandon | Explication |
|---|---|
| Identifiant utilisateur en double | Plusieurs utilisateurs avec un identifiant correspondant (comme un ID externe, une adresse e-mail ou un numéro de téléphone) étaient éligibles pour recevoir ce message. Pour éviter les envois en double au même utilisateur, ce message a été abandonné. |
| L’utilisateur a échoué à la pré-vérification de l’étape Message | Cette pré-vérification s’exécute avant les validations de distribution. Lorsque cela se produit, l’utilisateur n’a pas satisfait la pré-vérification de base pour cette étape Message (utilisateur introuvable ou non éligible pour le canal de l’étape Message). Remarque : Pour une étape Message multicanal, cela signifie que l’utilisateur n’a pas été trouvé ; l’éligibilité au canal n’est vérifiée ici que pour les étapes Message à canal unique. |
| L’utilisateur a échoué à la pré-vérification du message déclenché | Pour un message déclenché, Braze exécute un premier ensemble de pré-vérifications de base concernant l’éligibilité de l’audience, la rééligibilité et l’éligibilité au canal avant de créer un message à envoyer à partir de ce déclencheur. |
| L’utilisateur n’est plus éligible | L’utilisateur faisait initialement partie de l’audience cible, mais ne correspondait plus aux critères de l’audience avant que Braze n’envoie le message ou n’intègre l’utilisateur dans le Canvas. Le délai entre le moment où l’utilisateur a initialement satisfait les critères de l’audience et celui où il en est sorti peut être dû à :
|
| L’utilisateur n’est pas éligible pour l’étape | L’utilisateur est sorti du Canvas parce qu’il ne satisfaisait pas les validations de distribution définies pour l’étape Message ou parce qu’il faisait partie d’une liste de suppression. |
| L’utilisateur n’est pas rééligible | L’utilisateur était éligible pour recevoir le message ou entrer dans le Canvas, mais l’envoi a été annulé en raison des paramètres de rééligibilité ou de réentrée. Cela peut se produire si l’utilisateur a déjà reçu la campagne ou est entré dans le Canvas trop récemment, si un autre envoi pour la même campagne est déjà en cours pour cet utilisateur, ou si la rééligibilité ou la réentrée est désactivée. |
| Profil utilisateur introuvable | L’utilisateur n’a jamais existé ou n’existe plus dans Braze. Voici quelques cas courants :
|
Canal et distribution
| Résultat d’abandon | Explication |
|---|---|
| Délai d’expiration de la distribution par le partenaire | Braze a tenté d’envoyer ce message à votre partenaire de distribution pendant 24 heures, mais le partenaire a renvoyé des erreurs temporaires pendant toute la durée de cette fenêtre. |
| Identifiants push invalides | Les identifiants push pour cette application sont manquants ou invalides, l’envoi a donc été annulé. Mettez à jour vos identifiants dans Paramètres des applications. |
| L’utilisateur n’est pas activé pour les notifications push Android, l’application ou l’appareil | La notification push ne peut pas être envoyée à cet utilisateur. Voici quelques raisons courantes :
|
| L’utilisateur n’est pas activé pour les notifications push iOS, l’application ou l’appareil | Identique au résultat d’abandon « L’utilisateur n’est pas activé pour les notifications push Android, l’application ou l’appareil ». |
| L’utilisateur n’est pas activé pour les notifications push Kindle, l’application ou l’appareil | Identique au résultat d’abandon « L’utilisateur n’est pas activé pour les notifications push Android, l’application ou l’appareil ». |
| L’utilisateur n’est pas activé pour les notifications push Web, l’application ou l’appareil | Identique au résultat d’abandon « L’utilisateur n’est pas activé pour les notifications push Android, l’application ou l’appareil ». |
| L’utilisateur n’est pas activé pour les cartes de contenu | L’utilisateur n’a utilisé aucune application incluant cette carte de contenu. |
| L’utilisateur n’est pas activé pour l’e-mail | Les e-mails ne peuvent pas être envoyés à cet utilisateur. Voici quelques raisons courantes :
|
| L’utilisateur n’est pas activé pour LINE | Les messages LINE ne peuvent pas être envoyés à cet utilisateur. Voici quelques raisons courantes :
|
| L’utilisateur n’est pas activé pour SMS/MMS/RCS | Les messages SMS ne peuvent pas être envoyés à cet utilisateur. Voici quelques raisons courantes :
|
| L’utilisateur n’est pas activé pour WhatsApp | Les messages WhatsApp ne peuvent pas être envoyés à cet utilisateur. Voici quelques raisons courantes :
|
| Échec du webhook | Le webhook a reçu un code de réponse non réussi (non-2xx). Consultez le Journal d’activité des messages pour plus de détails. Les journaux de plus de 60 heures sont nettoyés et ne sont plus accessibles ; les erreurs de webhook sont échantillonnées jusqu’à 20 journaux par heure. |
Questions fréquentes
Que signifie un échec de « pré-vérification » ?
Une « pré-vérification » désigne un contrôle de validation rapide et groupé qui s’exécute au tout début d’une étape du pipeline (comme le déclenchement d’un message ou l’envoi d’une étape Message du Canvas). Considérez-la comme une sortie anticipée conçue pour une vitesse maximale. Au lieu d’exécuter de nombreuses vérifications séparées et gourmandes en ressources (comme la validation de chaque détail du profil d’un utilisateur), Braze regroupe plusieurs validations de base en un seul « premier passage ».
Si un utilisateur échoue à cette vérification groupée unique, il est immédiatement retiré. Cette approche groupée permet à Braze de traiter des volumes massifs de messages à grande vitesse et peut contribuer à des performances plus rapides et plus stables pour vos campagnes et Canvas en réduisant la latence de traitement de chaque message.
Que signifie un résultat d’abandon « autre » ?
Il s’agit d’abandons qui ne correspondent à aucune des catégories préexistantes de Braze. Si vous constatez une proportion importante d’abandons avec ce résultat, contactez l’assistance Braze pour obtenir de l’aide.
Pourquoi la somme de Total Aborts et Message Sends est-elle inférieure à la taille d’audience attendue ?
Cela peut se produire pour plusieurs raisons :
- Critères d’audience : Moins d’utilisateurs que prévu ont pu satisfaire les critères d’audience (par exemple, ils n’étaient pas dans le segment ou ne possédaient pas les attributs nécessaires) au moment du lancement de la campagne ou du Canvas.
- Traitement en cours : Les messages peuvent encore être en cours de traitement. Les utilisateurs peuvent encore se trouver dans des étapes antérieures du Canvas et ne pas avoir atteint les étapes Message.
- Fraîcheur des données : Les données du tableau de bord sont mises à jour environ toutes les 15 minutes, mais cela n’est pas garanti. Les données les plus récentes pour cette campagne ou ce Canvas peuvent ne pas encore être disponibles dans le tableau de bord.
- Cas limites : Il existe une faible probabilité que vous rencontriez un cas limite qui n’est pas pris en compte dans ce tableau de bord pour le moment. Si vous pensez que c’est le cas, contactez l’assistance Braze.
Pourquoi la somme de Total Aborts et Message Sends est-elle supérieure à l’audience d’une campagne ou d’un Canvas ?
Cela peut se produire pour les raisons suivantes :
- Messages multicanaux : La campagne ou l’étape du Canvas était configurée pour envoyer sur plusieurs canaux (comme SMS et e-mail). Un même utilisateur peut recevoir un résultat « envoyé » pour un canal (comme l’e-mail) et un résultat « abandonné » pour un autre (comme « L’utilisateur n’est pas activé pour SMS/MMS/RCS »). Dans ce cas, cet utilisateur serait compté deux fois dans le graphique : une fois comme « envoyé » et une fois comme « abandonné ».
- Exemple : Vous envoyez une campagne push à 100 utilisateurs, ciblant à la fois iOS et Android. Si un utilisateur ne possède qu’un appareil iOS, il reçoit la notification push iOS (« envoyé ») mais déclenche également un abandon pour la notification push Android (« L’utilisateur n’est pas activé pour les notifications push Android, l’application ou l’appareil »).
- Étapes Message multiples (Canvas uniquement) : Votre Canvas peut comporter plusieurs étapes Message dans un parcours donné. Ce tableau de bord agrège tous les résultats, un même utilisateur peut donc être compté plusieurs fois s’il passe par plusieurs étapes Message dans la période sélectionnée.
- Messages de test : Les envois de test (qui sont comptabilisés dans le tableau de bord) font augmenter les totaux au-delà de la taille de l’audience.
New Stuff!