Observabilité de la messagerie
L’observabilité de la messagerie 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 de messagerie. Ce tableau de bord peut vous aider à comprendre pourquoi les messages de vos Campaigns ou Canvas n’ont peut-être pas été envoyés comme prévu.
Pour accéder à l’observabilité de la messagerie, vous devez disposer de la permission utilisateur « View Dashboard Reports » pour votre espace de travail.
Concepts clés
Envoyé et distribué
Ce tableau de bord rapporte la manière dont Braze a traité un message en interne, et non le statut final de distribution 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 à l’affichage. |
| Braze transmet le message à un fournisseur de services d’e-mailing (ESP). L’ESP est ensuite responsable de la distribution finale. Cet ESP, par exemple, peut signaler un « rebond » si l’adresse e-mail est invalide ou si la boîte de réception est pleine. | |
| In-App Messages | Le message a été vu par l’utilisateur et une impression a été enregistrée. |
| LINE | Le message a été transmis avec succès à un partenaire d’envoi. |
| Push | Braze transmet le message au service de notification push approprié (tel qu’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, retournant 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 probablement inférieure à une heure dans la plupart des cas.
Configuration du tableau de bord
Vous pouvez accéder à l’observabilité de la messagerie en allant dans Analytics > Dashboard Builder et en sélectionnant Messaging Observability dans la liste des tableaux de bord créés par Braze.
Pour exécuter le tableau de bord et afficher vos données :
- Choisissez soit Campaigns, soit 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 à vos filtres sélectionnés.
Interprétation des données
Le tableau de bord affiche uniquement les sept derniers jours de données au maximum. Tous les horodatages sont affichés dans le fuseau horaire de votre espace de travail.
Tuiles de synthèse
En haut de la page, des tuiles de synthèse clés pour la période sélectionnée affichent :
- Envoyé : 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, retournant une réponse
2xx. - Content Cards : La carte a été envoyée et est éligible à l’affichage.
- In-App Messages : Le message a été affiché à l’utilisateur.
- Non envoyé : Le nombre total de messages qui ont été annulés. Cela inclut les membres de l’audience du Canvas qui n’ont pas accédé au Canvas ou qui en sont sortis parce qu’ils ont rencontré un échec d’étape ou rempli les critères de sortie en effectuant un événement de sortie.
Résultats des messages au fil du temps
Ce graphique de séries temporelles affiche une ventilation horaire des raisons pour lesquelles un message a été annulé ou pourquoi 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 des valeurs brutes du payload d’événement. Ce graphique n’affiche pas le nombre d’envois.
Journal détaillé des résultats de messages
Le tableau de bord affiche un tableau détaillé des résultats individuels de messages pour les filtres et la période 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ésultats 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 correspondant à 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 propose des conseils 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 toujours apparaître dans les vues agrégées même lorsque vous appliquez un filtre de canal.
Résultats d’annulation
Les définitions suivantes expliquent les résultats d’annulation 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’annulation dans l’observabilité de la messagerie sont des libellés de tableau de bord lisibles par l’humain. Dans les événements d’engagement liés aux messages de Currents, les informations d’annulation 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 noms peuvent différer entre Currents et l’observabilité de la messagerie.
Contenu et rendu
| Résultat d’annulation | Explication |
|---|---|
| Content Card expirée | La Content Card a expiré avant que l’utilisateur ne la voie. |
| Content Card invalide | La Content Card comportait des erreurs et n’a pas été envoyée à l’utilisateur. Parmi les 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 comptage représente le nombre de messages annulés en raison du nombre maximal de tentatives atteint, et non le nombre total de requêtes de contenu connecté ayant échoué. |
| Expiration du rendu du message in-app | Après plusieurs tentatives, le Liquid n’a pas pu être rendu et a expiré. |
| Annulation Liquid | L’étiquette Liquid abort_message a été appelée, l’envoi a donc été annulé. |
| 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 comportait une erreur d’analyse, le message a donc été annulé. |
| Échec de l’URL du média | Braze n’a pas pu traiter l’URL du 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’annulation | 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 auparavant éligible pour recevoir le message, mais soit :
|
| Campaign inactive | La Campaign a été arrêtée alors que le message était en cours de traitement, il a donc été annulé. |
| 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 de débit et timing
| Résultat d’annulation | 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é. |
| Annulation due aux heures calmes | Les heures calmes étaient activées pour la Campaign ou l’étape du Canvas avec l’option de repli définie sur Annuler 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é annulé. Cependant, cela ne fait pas sortir l’utilisateur du Canvas. |
| Limitation de débit au-delà de 72 heures | Le message a été limité pendant plus de 72 heures en raison des limites de vitesse de distribution, l’envoi a donc été annulé. |
Éligibilité de l’utilisateur et profil
| Résultat d’annulation | Explication |
|---|---|
| Identifiant utilisateur en double | 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é annulé. |
| L’utilisateur a échoué au pré-contrôle pour l’étape de message | Braze exécute une première série de pré-contrôles de base pour l’éligibilité de l’audience, la rééligibilité et l’éligibilité du canal avant les validations de distribution complètes pour une étape de message du Canvas. Ce résultat signifie que l’utilisateur ou le message a échoué à l’un de ces contrôles, le message a donc été annulé pour cette étape. |
| L’utilisateur a échoué au pré-contrôle pour le message déclenché | Braze exécute une première série de pré-contrôles de base pour l’éligibilité de l’audience, la rééligibilité et l’éligibilité du canal avant de créer un message à envoyer à partir de ce déclencheur. Ce résultat signifie que l’utilisateur ou le message a échoué à l’un de ces contrôles, le message a donc été annulé. |
| 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 temps entre le moment où l’utilisateur remplit initialement les critères d’audience et celui où il en sort peut être dû à des délais liés à :
|
| L’utilisateur n’est pas éligible pour l’étape | L’utilisateur n’a pas satisfait aux validations de distribution définies pour l’étape de message ou faisait partie d’une liste de suppression. Selon les paramètres des 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 déjà 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. Parmi les cas courants :
|
Canal et distribution
| Résultat d’annulation | 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 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 App Settings. |
| É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 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 liées à l’état d’abonnement, des capacités de canal non prises en charge ou des pays bloqués pour les canaux basés sur le téléphone. |
| Échec du webhook | Le webhook a reçu un code de réponse non réussi (non 2xx). Les codes d’erreur courants peuvent être des erreurs client 4XX, des erreurs serveur ou délai d’attente 5XX, ou 598 Host Unhealthy ou des requêtes brièvement interrompues. |
Foire aux questions
Que signifie un échec de « pré-contrôle » ?
Un « pré-contrôle » désigne une vérification de validation rapide et groupée 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 de message du Canvas). Considérez-le comme une sortie anticipée conçue pour une vitesse maximale. Au lieu d’exécuter de nombreuses vérifications distinctes et coûteuses en ressources (comme la validation de chaque détail du profil d’un utilisateur), Braze regroupe plusieurs validations de base en une seule « première passe ».
Si un utilisateur échoue à cette vérification groupée, il est retiré immédiatement. 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’annulation « autre » ?
Il s’agit d’annulations qui ne correspondent pas aux catégories existantes du tableau de bord. Si vous constatez une proportion importante d’annulations avec le résultat « 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) lorsque la Campaign ou le Canvas a été lancé.
- Traitement en cours : Des messages peuvent encore être en cours de traitement. Des 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 se mettent à 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 particuliers : Il existe une faible possibilité que vous rencontriez un cas particulier qui n’est pas capturé dans ce tableau de bord à l’heure actuelle. 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 ou d’un Canvas ?
Cela peut se produire pour les raisons suivantes :
- Messages multicanaux : La Campaign ou l’étape du Canvas a été configurée pour envoyer sur plusieurs canaux (tels que SMS et e-mail). Un seul utilisateur peut recevoir un résultat « envoyé » pour un canal (comme l’e-mail) et un résultat « annulation » pour un autre (comme « L’utilisateur n’est pas éligible pour le canal »). Dans ce cas, cet utilisateur serait compté deux fois dans le graphique : une fois comme « envoyé » et une fois comme « annulation ».
- 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 une annulation pour la notification push Android (« L’utilisateur n’est pas éligible pour le canal »).
- Étapes de message multiples (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, un seul utilisateur pourrait donc être compté 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) font augmenter les totaux au-delà de la taille de l’audience.