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.
Le tableau de bord Messaging Diagnostics est disponible de manière générale. Contactez votre gestionnaire du succès des clients si vous souhaitez obtenir l’accès à cette fonctionnalité.
Pour accéder au tableau de bord Messaging Diagnostics, vous devez disposer de la permission utilisateur « View Dashboard Reports » pour votre espace de travail.
Concepts clés
Envoyé et distribué
Il est crucial de comprendre que ce tableau de bord rend compte de la façon dont Braze a traité un message en interne, et non de l’état de distribution finale du message.
Un message marqué comme « envoyé » dans ce tableau de bord signifie que Braze a traité et expédié le message 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. Considérez les exemples suivants pour chaque canal.
| Canal | Exemple de distribution finale |
|---|---|
| Content Cards | La carte a été envoyée et est éligible à la consultation. |
| Braze transmet le message à un fournisseur de services d’e-mail marketing (fournisseur de services d’e-mailing). L’fournisseur de services d’e-mailing est ensuite responsable de la distribution finale. Cet fournisseur de services d’e-mailing, par exemple, peut signaler un « bounce » si l’adresse e-mail est invalide ou si la boîte de réception est pleine. | |
| In-App Messages | Le message a été consulté par l’utilisateur et une impression a été enregistrée. |
| LINE | Le message a été transmis avec succès à un partenaire d’envoi. |
| Notification 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 vers 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 à laquelle les données de ce tableau de bord sont mises à jour peut varier en fonction de la charge du système. Bien que la fréquence de mise à jour ne soit pas garantie, elle est probablement inférieure à une heure dans la plupart des cas.
Configuration du tableau de bord
Vous pouvez accéder au tableau de bord de diagnostics en allant dans Analytics > Dashboard Builder 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 Canvas comme source pour vos rapports de tableau de bord.
- Sélectionnez une ou plusieurs Campaigns ou Canvas.
- Sélectionnez Run Dashboard pour charger les données correspondant aux filtres sélectionnés.
Interpréter les données
Le tableau de bord affiche uniquement les sept derniers jours de données au maximum. Tous les horodatages s’affichent dans le fuseau horaire de votre espace de travail.
Vignettes récapitulatives
En haut de la page, des vignettes récapitulatives clés pour la période sélectionnée indiquent :
- Envoyés : Le nombre total de messages que Braze a traités et envoyés avec succès.
- E-mail, SMS/MMS/RCS, WhatsApp, LINE et notification 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. - Content Cards : La carte a été envoyée et est éligible à la consultation.
- In-App Messages : Le message a été affiché à l’utilisateur.
- Non envoyés : Le nombre total de messages qui ont été abandonnés. Cela inclut les membres de l’audience du Canvas qui ne sont pas entrés dans le Canvas ou 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.
Résultats des messages au fil du temps
Ce graphique de série temporelle montre une ventilation horaire des raisons pour lesquelles un message a été abandonné ou un utilisateur a été retiré d’un Canvas. Les libellés de résultats dans ce graphique sont des libellés normalisés du tableau de bord, et non les valeurs brutes de la charge utile de l’événement. Ce graphique n’affiche pas le nombre d’envois.
Journal granulaire des résultats des messages
Le tableau de bord affiche un tableau granulaire des résultats individuels des messages pour les filtres et la plage de temps sélectionnés. Utilisez ce tableau pour examiner des enregistrements spécifiques, y compris l’horodatage, l’ID utilisateur, l’étape du Canvas, le résultat, les détails et le canal.
Vous pouvez filtrer le tableau pour vous concentrer sur des enregistrements spécifiques :
- Filtrer par résultat : Sélectionnez un résultat dans le filtre de résultat pour afficher uniquement les lignes avec ce résultat (par exemple,
Frequency cappedouUser not eligible for channel). - Rechercher par ID utilisateur : Saisissez un ID utilisateur dans le champ de recherche pour afficher les lignes de cet utilisateur spécifique.
Lorsque vous appliquez les deux filtres, le tableau renvoie les lignes qui correspondent à la fois au résultat sélectionné et à l’ID utilisateur saisi.
Sélectionnez une ligne dans le tableau pour ouvrir le panneau de détails. Le panneau de détails fournit un contexte supplémentaire sur ce résultat, et Ask Operator fournit des recommandations de remédiation pour vous aider à résoudre le problème sous-jacent.
Les filtres de canal s’appliquent aux résultats liés à un canal de communication spécifique. Certains résultats sont indépendants du canal, ils peuvent donc apparaître dans les vues agrégées même lorsque vous appliquez un filtre de canal.
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.
Les résultats d’abandon dans le Diagnostic de messagerie sont des libellés lisibles du tableau de bord. Dans les événements d’engagement des messages Currents, les informations d’abandon sont représentées par des champs tels que abort_type et abort_log. Comme ces jeux de données ont des représentations et des chemins de traitement différents, les comptages ou les dénominations peuvent différer entre Currents et le Diagnostic de messagerie.
Contenu et rendu
| Résultat d’abandon | Explication |
|---|---|
| Content Card expirée | La Content Card a expiré avant que l’utilisateur ne la voie. |
| Content Card invalide | La Content Card 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 maximum de tentatives (cinq par défaut). Remarque : Ce comptage représente le nombre de messages abandonnés en raison de l’atteinte du nombre maximum 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é. |
| Échec de l’URL média | Braze n’a pas pu traiter l’URL média dans le message. Cela peut se produire lorsque l’URL est bloquée, invalide, expire, renvoie un statut HTTP invalide ou échoue à la validation SSL. |
État de la Campaign et du Canvas
| Résultat d’abandon | Explication |
|---|---|
| Échec de l’étape de délai | L’étape de délai a échoué, ce qui a provoqué 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 a soit
|
| Campaign inactive | La Campaign a été arrêtée alors que le message était en cours d’envoi, 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 Campaign a atteint la limite de volume définie, l’envoi a donc été annulé. |
Limitation du débit et timing
| Résultat d’abandon | Explication |
|---|---|
| Limite de fréquence atteinte | L’utilisateur a déjà reçu le nombre maximum de messages autorisé par 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 Campaign ou l’étape du Canvas avec l’option de repli définie sur Abandonner le message. L’utilisateur a déclenché la Campaign ou est entré dans l’étape de message du Canvas pendant les heures calmes, le message a donc été abandonné. Toutefois, cela ne fait pas sortir l’utilisateur du Canvas. |
| Limitation du débit au-delà de 72 heures | Le message a été ralenti pendant plus de 72 heures en raison des limites de débit de vitesse de distribution, l’envoi a donc été abandonné. |
Éligibilité et profil de l’utilisateur
| Résultat d’abandon | Explication |
|---|---|
| Identifiant utilisateur en doublon | Plusieurs utilisateurs avec un identifiant correspondant (tel qu’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 n’a pas passé la pré-vérification de l’étape de message | Braze effectue un premier ensemble de pré-vérifications de base portant sur l’éligibilité de l’audience, la rééligibilité et l’éligibilité au canal avant les validations complètes de distribution pour une étape de message du Canvas. Ce résultat signifie que l’utilisateur ou le message n’a pas passé l’une de ces vérifications, le message a donc été abandonné pour cette étape. |
| L’utilisateur n’a pas passé la pré-vérification du message déclenché | Braze effectue un premier ensemble de pré-vérifications de base portant sur 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. Ce résultat signifie que l’utilisateur ou le message n’a pas passé l’une de ces vérifications, le message a donc été abandonné. |
| L’utilisateur n’est plus éligible | L’utilisateur faisait initialement partie de l’audience cible, mais ne correspondait plus aux critères d’audience avant que Braze n’envoie le message ou ne fasse entrer l’utilisateur dans le Canvas. Le délai entre le moment où l’utilisateur a initialement rempli les critères d’audience et le moment où il en est sorti peut être dû à des retards liés à :
|
| L’utilisateur n’est pas éligible pour l’étape | L’utilisateur n’a pas rempli les validations de distribution définies pour l’étape de message ou faisait partie d’une liste de suppression. Selon les paramètres de Validations de distribution, l’utilisateur peut avoir quitté le Canvas ou être passé à l’étape suivante. |
| 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 Campaign ou est entré dans le Canvas trop récemment, si un autre envoi pour la même Campaign 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 |
|---|---|
| Erreur de distribution du 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. |
| 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 de l’application. |
| Échec du groupe d’abonnement | Le message n’a pas pu être envoyé en raison de problèmes de configuration du groupe d’abonnement ou du service de messagerie. Les raisons courantes incluent des numéros d’envoi manquants pour les SMS ou WhatsApp, ou un MMS non pris en charge sur le service de messagerie configuré. |
| L’utilisateur n’est pas éligible pour le canal | L’utilisateur n’est pas éligible pour recevoir ce message sur le canal sélectionné. Les raisons courantes incluent des identifiants de canal manquants ou invalides, l’absence de jetons push éligibles, des restrictions d’état d’abonnement, une capacité de canal non prise en charge ou des pays bloqués pour les canaux téléphoniques. |
| Échec du webhook | Le webhook a reçu un code de réponse infructueux (non 2xx). Les codes d’erreur courants peuvent être des erreurs client 4XX, des erreurs serveur ou délais d’expiration 5XX, ou 598 Host Unhealthy ou des requêtes brièvement interrompues. |
Questions fréquemment posées
Que signifie un échec de « pré-vérification » ?
Une « pré-vérification » désigne un contrôle de validation groupé à haute vitesse qui s’exécute tout au début d’une étape du pipeline (par exemple, le déclenchement d’un message ou l’envoi d’une étape de message Canvas). Considérez-la comme une sortie anticipée conçue pour une vitesse maximale. Au lieu d’effectuer 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 exclu. 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 Campaigns 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 existantes du tableau de bord. Si vous constatez toujours une grande proportion d’abandons avec la mention « Autre », contactez le support Braze pour obtenir une assistance supplémentaire.
Pourquoi la somme de Non envoyé et Envoyé 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 Campaign 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 d’étapes de 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 Campaign 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 le support Braze.
Pourquoi la somme de Non envoyé et Envoyé est-elle supérieure à l’audience d’une Campaign et d’un Canvas ?
Cela peut se produire pour les raisons suivantes :
- Messages multicanaux : la Campaign ou l’étape Canvas était configurée pour envoyer sur plusieurs canaux (tels que 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 « abandon » pour un autre (comme « Utilisateur non éligible pour le canal »). Dans ce cas, cet utilisateur unique serait comptabilisé deux fois dans le graphique : une fois comme « envoyé » et une fois comme « abandon ».
- Exemple : vous envoyez une Campaign 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 (« Utilisateur non éligible pour le canal »).
- Plusieurs étapes de message (Canvas uniquement) : votre Canvas peut comporter plus d’une étape de message dans un parcours donné. Ce tableau de bord agrège tous les résultats, de sorte qu’un même utilisateur pourrait être comptabilisé plusieurs fois s’il passe par plusieurs étapes de message dans la période sélectionnée.
- Messages de test : les envois de test (qui sont comptabilisés dans le tableau de bord) augmentent le total au-delà de la taille de l’audience.