Metriche SMS
La pagina Metrics nella dashboard Bird mostra quanto traffico SMS ha raggiunto i dispositivi e come varia il tasso di errore. Questa guida spiega ogni valore e quando indagare.
Le metriche sono la vista aggregata di tutto ciò che il tuo spazio di lavoro invia. I conteggi usano un'aggregazione approssimata per messaggi distinti, quindi usa i record dei messaggi e di fatturazione quando serve una riconciliazione esatta. Per il ciclo di vita di un singolo messaggio (questo numero lo ha ricevuto?), consulta il log SMS e gli eventi.
Leggere le metriche
Apri SMS > Metrics nella dashboard. Il selettore di intervallo offre le ultime 24 ore oppure 7, 30 o 90 giorni. I valori si aggiornano man mano che gli invii e le ricevute di consegna arrivano.
I tassi usano l'orario di invio di ogni messaggio. Una ricevuta di consegna che arriva oggi per un messaggio accettato ieri viene contata nel giorno di ieri, insieme al relativo accepted di quel messaggio. Ogni intervallo descrive quindi i messaggi inviati al suo interno, dall'inizio alla fine. accepted è il denominatore per entrambe le schede dei tassi: è il conteggio dei messaggi ammessi nell'intervallo, e ogni tasso è calcolato rispetto a esso.
Un intervallo che include invii recenti può temporaneamente sottostimare delivered mentre le ricevute stanno ancora arrivando. Il conteggio si stabilizza quando quei messaggi terminano.
I riquadri di riepilogo
La riga di riquadri in alto è il tuo controllo rapido dello stato:
- Delivery rate: messaggi consegnati come percentuale degli accettati. Indica Healthy sopra il 95 %; al di sotto, qualcosa non riesce a raggiungere i dispositivi (numeri errati, contenuti bloccati o problemi di instradamento) e il dettaglio degli errori indica quale. Il riquadro mostra anche la variazione rispetto al periodo precedente.
- Failure rate: la percentuale di messaggi accettati che hanno avuto esito undelivered, failed o expired. Il riquadro mostra il tuo tasso rispetto a un limite del 5 % con una barra di avanzamento; raggiungendolo il riquadro passa a Risk. Un tasso di errore costantemente alto di solito indica problemi di qualità delle liste o dei contenuti.
- Accepted: il conteggio grezzo dei messaggi accettati nell'intervallo, con il numero consegnato agli operatori (sent) e la variazione rispetto al periodo precedente.
La dashboard usa le soglie del 95 % e del 5 % per le etichette Healthy e Risk. Un'etichetta Healthy non significa che ogni messaggio sia stato consegnato.
Consegna nel tempo
Il grafico di consegna traccia il volume di messaggi accettati, consegnati e con errore nell'intervallo, così puoi individuare tendenze e picchi isolati: una campagna problematica, un'importazione di numeri andata male, una rotta degradata. La serie failed raggruppa qui ogni esito di mancata consegna (non consegnato, fallito e scaduto) in un'unica linea. La dimensione del bucket segue l'intervallo (oraria per 24 ore, giornaliera per finestre più lunghe).
Tasso di errore e relative cause
La pagina Metrics traccia anche il tasso di errore per bucket e raggruppa le mancate consegne per causa in un istogramma degli esiti:
- Undelivered: una mancata consegna non permanente. Il dispositivo era spento o irraggiungibile.
- Failed: un errore permanente; il messaggio non può essere consegnato.
- Expired: l'operatore ha smesso di tentare e ha segnalato il messaggio come scaduto. Bird non imposta una propria finestra di validità.
- Rejected: il messaggio è stato rifiutato (un controllo di policy, un addebito non riuscito o un operatore che lo ha respinto) anziché tentato e perso.
Ogni bucket mostra il proprio conteggio, e tutti tranne rejected mostrano la loro quota sui messaggi accettati. Per la riconciliazione dei numeri: il riquadro Failure rate conta undelivered, failed e expired, mentre rejected è mostrato in questo istogramma ma resta fuori dal calcolo del tasso di errore. Un messaggio rifiutato è stato respinto, non perso durante la consegna, perciò viene tracciato separatamente dagli errori di consegna.
Latenza di consegna
La tabella di latenza suddivide i tempi in Processing, Delivery e Total. Processing va dall'accettazione alla consegna all'operatore; Delivery va dalla consegna all'operatore all'esito di consegna riportato; Total copre dall'accettazione a quell'esito. Ogni fase include i percentili p50, p95 e p99. Usa p95 e p99 per identificare un operatore o una destinazione lenta. La latenza copre l'intera finestra e un percentile senza dati mostra un trattino.
Accesso programmatico
L'API stats espone gli stessi riepiloghi, serie e dettagli della dashboard. I dettagli coprono paese, operatore, mittente, categoria, stato, codice di errore e messaggi in entrata. I valori corrispondono alla dashboard per lo stesso intervallo.
Per la riconciliazione per singolo messaggio anziché per aggregati, consuma gli eventi webhook in tempo reale oppure scorri le pagine di GET /v1/sms/messages.
Prossimi passi
Usa le analytics SMS per collegare i report di consegna al flusso di lavoro più ampio della campagna o dell'applicazione.
- Stats API: recupera da codice ogni valore presente in questa pagina.
- Log SMS: ispeziona i messaggi dietro gli aggregati.
- Eventi: consuma gli eventi dietro le metriche.
- Sending SMS: verifica categorie, tag, segmenti e spesa.
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Comprendi il concettoWhat does a delivery receipt tell you?Segui il percorso di apprendimentoOperate messaging reliably
Ottieni un brief di implementazione