Métriques SMS
La page Metrics du tableau de bord Bird indique quelle part du trafic SMS a atteint les terminaux et comment votre taux d'échec évolue. Ce guide explique chaque valeur et quand l'examiner.
Les métriques offrent une vue agrégée de tout ce que votre espace de travail envoie. Les compteurs utilisent une agrégation approximative par message distinct : servez-vous des enregistrements de messages et de facturation lorsqu'un rapprochement exact est nécessaire. Pour le cycle de vie d'un message individuel (ce numéro l'a-t-il bien reçu ?), consultez le journal SMS et les événements.
Lire vos métriques
Ouvrez SMS > Metrics dans le tableau de bord. Le sélecteur de période propose les dernières 24 heures ou 7, 30 ou 90 jours. Les valeurs se mettent à jour à mesure que les envois et les accusés de réception arrivent.
Les taux se basent sur l'heure d'envoi de chaque message. Un accusé de réception qui arrive aujourd'hui pour un message accepté hier est comptabilisé sur la journée d'hier, aux côtés du propre accepted de ce message. Chaque période décrit donc les messages que vous avez envoyés pendant celle-ci, du début à la fin. accepted est le dénominateur des deux cartes de taux : c'est le nombre de messages admis dans la période, et chaque taux est mesuré par rapport à lui.
Une période qui inclut des envois récents peut temporairement sous-déclarer les delivered tant que les accusés de réception continuent d'arriver. Le compteur se stabilise une fois ces messages terminés.
Les tuiles de résumé
La rangée de tuiles en haut constitue votre bilan de santé en un coup d'œil :
- Delivery rate : les messages livrés en proportion des messages acceptés. La tuile affiche Healthy au-dessus de 95 % ; en dessous ou à ce seuil, quelque chose empêche les messages d'atteindre les terminaux (numéros invalides, contenu bloqué ou problèmes de routage) et la répartition des échecs vous indique lesquels. La tuile affiche également la variation par rapport à la période précédente.
- Failure rate : la part des messages acceptés terminés en undelivered, failed ou expired. La tuile affiche votre taux par rapport à une limite de 5 % avec une barre de progression ; l'atteindre fait basculer la tuile sur Risk. Un taux d'échec élevé et soutenu signifie généralement des problèmes de qualité de liste ou de contenu.
- Accepted : le nombre brut de messages acceptés dans la période, avec le nombre transmis aux opérateurs (sent) et la variation par rapport à la période précédente.
Le tableau de bord utilise les seuils de 95 % et 5 % pour ses libellés Healthy et Risk. Un libellé Healthy ne signifie pas que chaque message a été livré.
Livraison dans le temps
Le graphique de livraison trace les volumes accepted, delivered et failed sur la période pour repérer les tendances et les pics ponctuels : une mauvaise campagne, un import de liste de numéros défectueux, une route dégradée. La série failed regroupe ici tous les résultats de non-livraison (undelivered, failed et expired) en une seule ligne. La granularité suit la période (horaire pour 24 heures, quotidienne pour les fenêtres plus longues).
Taux d'échec et ses causes
La page Metrics trace également le taux d'échec par intervalle et regroupe les non-livraisons par cause dans un histogramme de résultats :
- Undelivered : une non-livraison non permanente. Le terminal était éteint ou injoignable.
- Failed : un échec permanent ; le message ne peut pas être livré.
- Expired : l'opérateur a cessé de réessayer et a signalé le message comme expiré. Bird ne définit pas de fenêtre de validité propre.
- Rejected : le message a été refusé (vérification de politique, facturation échouée ou opérateur l'ayant rejeté) plutôt que tenté et perdu.
Chaque intervalle affiche son compteur, et tous sauf rejected affichent leur part des messages acceptés. Pour le rapprochement des chiffres : la tuile Failure rate compte undelivered, failed et expired, tandis que rejected apparaît dans cet histogramme mais ne rentre pas dans le calcul du taux d'échec. Un message rejeté a été refusé plutôt que perdu lors de la livraison : il est donc suivi séparément des échecs de livraison.
Latence de livraison
Le tableau de latence décompose les temps en Processing, Delivery et Total. Processing couvre de l'acceptation à la transmission à l'opérateur ; Delivery couvre de la transmission au résultat de livraison signalé ; Total couvre de l'acceptation à ce résultat. Chaque étape inclut les percentiles p50, p95 et p99. Utilisez p95 et p99 pour identifier un opérateur ou une destination lente. La latence couvre la fenêtre entière, et un percentile sans données affiche un tiret.
Accès programmatique
L'API de statistiques expose les mêmes résumés, séries et répartitions que le tableau de bord. Les répartitions couvrent le pays, l'opérateur, l'expéditeur, la catégorie, le statut, le code d'erreur et les messages entrants. Les valeurs correspondent au tableau de bord pour la même période.
Pour un rapprochement par message plutôt que par agrégats, consommez les événements webhook au fil de l'eau, ou parcourez les GET /v1/sms/messages.
Étapes suivantes
Utilisez les analytiques SMS pour relier les rapports de livraison au flux de campagne ou d'application global.
- Stats API : récupérez chaque valeur de cette page depuis le code.
- Journal SMS : inspectez les messages derrière les agrégats.
- Events : consommez les événements derrière les métriques.
- Sending SMS : consultez les catégories, tags, segments et dépenses.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Comprendre le conceptWhat does a delivery receipt tell you?Suivre le parcours d'apprentissageOperate messaging reliably
Obtenir un guide d'implémentation