SMS-Metriken
Die Seite Metrics im Bird-Dashboard zeigt, wie viel SMS-Traffic Endgeräte erreicht hat und wie sich Ihre Fehlerrate verändert. Diese Anleitung erklärt jeden Wert und wann Sie ihn untersuchen sollten.
Metriken sind die aggregierte Ansicht über alles, was Ihr Workspace versendet. Zählungen verwenden eine approximative Distinct-Message-Aggregation – nutzen Sie daher Nachrichten- und Abrechnungsdatensätze, wenn eine exakte Abstimmung erforderlich ist. Für den Lebenszyklus einer einzelnen Nachricht (hat diese Nummer sie erhalten) siehe das SMS-Log und die Events.
Metriken lesen
Öffnen Sie SMS > Metrics im Dashboard. Die Zeitraumauswahl bietet die letzten 24 Stunden oder 7, 30 oder 90 Tage. Werte aktualisieren sich, sobald Sendungen und Zustellbestätigungen eintreffen.
Raten verwenden den Sendezeitpunkt jeder Nachricht. Eine Zustellbestätigung, die heute für eine gestern akzeptierte Nachricht eintrifft, zählt zu gestern – zusammen mit dem accepted dieser Nachricht. Jeder Zeitraum beschreibt also die darin gesendeten Nachrichten von Anfang bis Ende. accepted ist der Nenner für beide Ratenkarten; es ist die Anzahl der im Zeitraum angenommenen Nachrichten, und jede Rate wird daran gemessen.
Ein Zeitraum, der kürzliche Sendungen enthält, kann delivered vorübergehend zu niedrig ausweisen, solange noch Zustellbestätigungen eintreffen. Der Wert stabilisiert sich, sobald diese Nachrichten abgeschlossen sind.
Die Übersichtskacheln
Die Kachelreihe am oberen Rand ist Ihr Schnell-Check:
- Zustellrate: zugestellte Nachrichten als Anteil der akzeptierten. Sie zeigt Healthy über 95 % an; bei oder unter diesem Wert erreicht etwas die Endgeräte nicht (ungültige Nummern, blockierte Inhalte oder Routing-Probleme), und die Fehleraufschlüsselung zeigt Ihnen, was. Die Kachel zeigt außerdem die Veränderung gegenüber dem Vorzeitraum.
- Fehlerrate: der Anteil akzeptierter Nachrichten, die mit undelivered, failed oder expired endeten. Die Kachel zeigt Ihre Rate gegen ein 5-%-Limit mit einem Fortschrittsbalken; wird es erreicht, wechselt die Kachel auf Risk. Eine dauerhaft hohe Fehlerrate deutet meist auf Probleme mit der Listenqualität oder dem Inhalt hin.
- Accepted: die Gesamtzahl der im Zeitraum akzeptierten Nachrichten, mit der an Carrier weitergeleiteten Anzahl (sent) und der Veränderung gegenüber dem Vorzeitraum.
Das Dashboard verwendet die Schwellenwerte von 95 % und 5 % für seine Labels Healthy und Risk. Ein Healthy-Label bedeutet nicht, dass jede Nachricht zugestellt wurde.
Zustellung im Zeitverlauf
Das Zustelldiagramm zeigt accepted, delivered und failed als Volumen über den Zeitraum, damit Sie Trends und einmalige Ausreißer erkennen: eine fehlerhafte Kampagne, ein misslungener Nummernlisten-Import, eine verschlechterte Route. Die failed-Reihe fasst hier jedes Nicht-Zustell-Ergebnis (undelivered, failed und expired) in einer Linie zusammen. Die Bucket-Größe folgt dem Zeitraum (stündlich für 24 Stunden, täglich für längere Fenster).
Fehlerrate und ihre Ursachen
Die Metrics-Seite zeigt außerdem die Fehlerrate pro Bucket und gruppiert Nicht-Zustellungen nach Ursache in einem Ergebnis-Histogramm:
- Undelivered: eine nicht-permanente Nicht-Zustellung. Das Endgerät war ausgeschaltet oder nicht erreichbar.
- Failed: ein permanenter Fehler; die Nachricht kann nicht zugestellt werden.
- Expired: der Carrier hat die Zustellung aufgegeben und die Nachricht als abgelaufen gemeldet. Bird setzt kein eigenes Gültigkeitsfenster.
- Rejected: die Nachricht wurde abgewiesen (eine Richtlinienprüfung, eine fehlgeschlagene Belastung oder ein Carrier, der sie zurückgewiesen hat) – nicht versucht und verloren.
Jeder Bucket zeigt seine Anzahl, und alle außer rejected zeigen ihren Anteil an den akzeptierten Nachrichten. Zur Abstimmung der Zahlen: Die Kachel Failure rate zählt undelivered, failed und expired, während rejected in diesem Histogramm angezeigt wird, aber außerhalb der Fehlerrate-Berechnung liegt. Eine abgewiesene Nachricht wurde verweigert, nicht bei der Zustellung verloren, und wird daher getrennt von Zustellfehlern erfasst.
Zustelllatenz
Die Latenztabelle unterteilt die Zeitmessung in Processing, Delivery und Total. Processing läuft von der Annahme bis zur Carrier-Übergabe; Delivery läuft von der Übergabe bis zum gemeldeten Zustell-Ergebnis; Total umfasst die Annahme bis zu diesem Ergebnis. Jede Stufe enthält die Perzentile p50, p95 und p99. Verwenden Sie p95 und p99, um einen langsamen Carrier oder ein langsames Ziel zu identifizieren. Die Latenz deckt das gesamte Fenster ab, und ein Perzentil ohne Daten zeigt einen Strich.
Programmatischer Zugriff
Die Stats-API stellt dieselbe Zusammenfassung, Zeitreihen und Aufschlüsselungen wie das Dashboard bereit. Aufschlüsselungen umfassen Land, Carrier, Absender, Kategorie, Status, Fehlercode und eingehende Nachrichten. Die Werte stimmen für denselben Zeitraum mit dem Dashboard überein.
Für eine Abstimmung pro Nachricht statt Aggregaten konsumieren Sie Webhook-Events, sobald sie auftreten, oder blättern Sie durch GET /v1/sms/messages.
Nächste Schritte
Verwenden Sie SMS-Analytics, um Zustellberichte mit dem übergeordneten Kampagnen- oder Anwendungs-Workflow zu verbinden.
- Stats-API: alle Werte auf dieser Seite per Code abrufen.
- SMS-Log: die Nachrichten hinter den Aggregaten untersuchen.
- Events: die Events hinter den Metriken konsumieren.
- Sending SMS: Kategorien, Tags, Segmente und Kosten prüfen.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Das Konzept verstehenWhat does a delivery receipt tell you?Dem Lernpfad folgenOperate messaging reliably
Implementierungs-Briefing erhalten