Metryki SMS

Strona Metrics w panelu Bird pokazuje, jaka część ruchu SMS dotarła do urządzeń i jak zmienia się wskaźnik błędów. Ten przewodnik objaśnia każdą wartość i kiedy warto ją zbadać.

Metryki to widok zagregowany obejmujący wszystko, co wysyła Twój obszar roboczy. Liczniki używają przybliżonej agregacji unikalnych wiadomości, więc do dokładnego uzgadniania korzystaj z rekordów wiadomości i rozliczeń. Aby prześledzić cykl życia pojedynczej wiadomości (czy ten numer ją otrzymał), zobacz log SMS i zdarzenia.

Odczytywanie metryk

Otwórz SMS > Metrics w panelu. Selektor zakresu oferuje ostatnie 24 godziny lub 7, 30 albo 90 dni. Wartości aktualizują się w miarę napływania wysyłek i potwierdzeń dostarczenia.

Wskaźniki opierają się na czasie wysyłki każdej wiadomości. Potwierdzenie dostarczenia, które przychodzi dziś dla wiadomości przyjętej wczoraj, zalicza się do wczoraj, razem z jej własnym accepted. Każdy zakres opisuje więc wiadomości wysłane w jego ramach, od początku do końca. accepted jest mianownikiem obu kart wskaźników: to liczba wiadomości przyjętych w danym zakresie, a każdy wskaźnik jest mierzony względem niej.

Zakres obejmujący ostatnie wysyłki może tymczasowo zaniżać delivered, dopóki potwierdzenia wciąż napływają. Licznik stabilizuje się po zakończeniu przetwarzania tych wiadomości.

Kafelki podsumowania

Rząd kafelków u góry to szybka kontrola stanu:

Delivery rate: dostarczane wiadomości jako udział w przyjętych. Wyświetla Healthy powyżej 95%; przy tej wartości lub niżej coś nie dociera do urządzeń (złe numery, zablokowana treść lub problemy z trasowaniem), a podział błędów wskazuje przyczynę. Kafelek pokazuje też zmianę w stosunku do poprzedniego okresu.
Failure rate: udział przyjętych wiadomości, które zakończyły się statusem undelivered, failed lub expired. Kafelek pokazuje wskaźnik względem limitu 5% z paskiem postępu; osiągnięcie go przełącza kafelek na Risk. Utrzymujący się wysoki wskaźnik błędów zwykle oznacza problemy z jakością listy lub treścią.
Accepted: surowa liczba wiadomości przyjętych w danym zakresie, z liczbą przekazanych do operatorów (sent) i zmianą w stosunku do poprzedniego okresu.

Panel używa progów 95% i 5% dla etykiet Healthy i Risk. Etykieta Healthy nie oznacza, że każda wiadomość została dostarczona.

Dostarczalność w czasie

Wykres dostarczalności pokazuje wolumen accepted, delivered i failed w wybranym zakresie, dzięki czemu można wyłapać trendy i jednorazowe skoki: nieudana kampania, źle zaimportowana lista numerów, degradacja trasy. Seria failed łączy tu wszystkie wyniki niedostarczenia (undelivered, failed i expired) w jedną linię. Rozmiar przedziału zależy od zakresu (godzinowy dla 24 godzin, dzienny dla dłuższych okien).

Wskaźnik błędów i jego przyczyny

Strona Metrics przedstawia też wskaźnik błędów w poszczególnych przedziałach i grupuje niedostarczenia według przyczyny na histogramie wyników:

Undelivered: nietrwałe niedostarczenie. Urządzenie było wyłączone lub nieosiągalne.
Failed: trwały błąd; wiadomość nie może zostać dostarczona.
Expired: operator zaprzestał prób i zgłosił wiadomość jako wygasłą. Bird nie ustawia własnego okna ważności.
Rejected: wiadomość została odrzucona (kontrola polityki, nieudane obciążenie lub operator, który ją odrzucił) zamiast podjęcia próby dostarczenia i utracenia jej.

Każdy przedział pokazuje swoją liczbę, a wszystkie poza rejected pokazują swój udział w przyjętych wiadomościach. Przy uzgadnianiu liczb: kafelek Failure rate zlicza undelivered, failed i expired, podczas gdy rejected jest widoczny na histogramie, ale nie wchodzi do obliczeń wskaźnika błędów. Odrzucona wiadomość została odmówiona, a nie utracona podczas dostarczania, dlatego jest śledzona oddzielnie od błędów dostarczania.

Opóźnienie dostarczania

Tabela opóźnień dzieli czas na Processing, Delivery i Total. Processing obejmuje okres od przyjęcia do przekazania operatorowi; Delivery biegnie od przekazania do zgłoszonego wyniku dostarczenia; Total rozciąga się od przyjęcia do tego wyniku. Każdy etap zawiera percentyle p50, p95 i p99. Użyj p95 i p99, aby zidentyfikować wolnego operatora lub cel. Opóźnienie obejmuje pełne okno, a percentyl bez danych wyświetla myślnik.

Dolna połowa strony Metrics SMS w panelu Bird: histogram wyników błędów (liczby undelivered, failed, expired i rejected) nad tabelą opóźnień dostarczania z kolumnami p50, p95 i p99 dla etapów processing, delivery i total

Dostęp programistyczny

Stats API udostępnia te same podsumowania, serie i podziały co panel. Podziały obejmują kraj, operatora, nadawcę, kategorię, status, kod błędu i wiadomości przychodzące. Wartości pokrywają się z panelem dla tego samego zakresu.

Aby uzgadniać poszczególne wiadomości zamiast agregatów, konsumuj zdarzenia webhook na bieżąco lub stronicuj przez GET /v1/sms/messages.

Następne kroki

Użyj analityki SMS, aby połączyć raportowanie dostarczalności z szerszym przepływem kampanii lub aplikacji.

Stats API: pobierz każdą wartość z tej strony z kodu.
Log SMS: sprawdź wiadomości kryjące się za agregatami.
Zdarzenia: konsumuj zdarzenia stojące za metrykami.
Wysyłki SMS: przeglądaj kategorie, tagi, segmenty i wydatki.

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Zrozum koncepcjęWhat does a delivery receipt tell you?Podążaj ścieżką naukiOperate messaging reliably

Uzyskaj brief wdrożeniowy