SMS-statistieken
De pagina Metrics in het Bird-dashboard laat zien hoeveel SMS-verkeer toestellen bereikte en hoe je faalpercentage verandert. Deze gids legt elke waarde uit en wanneer je actie moet ondernemen.
Statistieken zijn het geaggregeerde overzicht van alles wat je werkruimte verstuurt. Tellingen gebruiken geschatte distinct-message-aggregatie, dus gebruik bericht- en facturatierecords als je een exacte afstemming nodig hebt. Zie het SMS-log en de events voor de levenscyclus van één bericht (heeft dit nummer het ontvangen).
Je statistieken lezen
Open SMS > Metrics in het dashboard. De bereikkiezer biedt de laatste 24 uur of 7, 30 of 90 dagen. Waarden worden bijgewerkt zodra verzendingen en afleverbevestigingen binnenkomen.
Percentages gebruiken de verzendtijd van elk bericht. Een afleverbevestiging die vandaag binnenkomt voor een bericht dat gisteren is geaccepteerd, telt mee voor gisteren, samen met de eigen accepted van dat bericht. Elk bereik beschrijft dus de berichten die je erin hebt verzonden, van begin tot eind. accepted is de noemer voor beide percentagekaarten; het is het aantal berichten dat we in het bereik hebben toegelaten, en elk percentage wordt daaraan afgemeten.
Een bereik met recente verzendingen kan delivered tijdelijk te laag weergeven zolang bevestigingen nog binnenkomen. De telling stabiliseert zodra die berichten zijn afgerond.
De samenvattingstegels
De rij tegels bovenaan is je snelle gezondheidscheck:
- Afleverpercentage: afgeleverde berichten als aandeel van geaccepteerd. Het toont Healthy boven 95 %; daarop of daaronder bereikt iets de toestellen niet (slechte nummers, geblokkeerde inhoud of routeringsproblemen) en de faaluitsplitsing vertelt je wat. De tegel toont ook de verandering ten opzichte van de vorige periode.
- Faalpercentage: het aandeel geaccepteerde berichten dat eindigde als undelivered, failed of expired. De tegel toont je percentage tegen een limiet van 5 % met een voortgangsbalk; bij het bereiken ervan schakelt de tegel naar Risk. Een langdurig hoog faalpercentage duidt meestal op problemen met lijstkwaliteit of inhoud.
- Geaccepteerd: het ruwe aantal berichten dat in het bereik is geaccepteerd, met het aantal dat aan carriers is doorgegeven (sent) en de verandering ten opzichte van de vorige periode.
Het dashboard gebruikt de drempels van 95 % en 5 % voor de labels Healthy en Risk. Een Healthy-label betekent niet dat elk bericht is afgeleverd.
Aflevering in de tijd
De afleveringsgrafiek plot het volume accepted, delivered en failed over het bereik, zodat je trends en eenmalige pieken kunt herkennen: een slechte campagne, een fout bij het importeren van een nummerlijst, een verslechterde route. De failed-reeks bundelt hier elke niet-afleveruitkomst (undelivered, failed en expired) in één lijn. De bucketgrootte volgt het bereik (per uur voor 24 uur, per dag voor langere vensters).
Faalpercentage en oorzaken
De Metrics-pagina plot ook het faalpercentage per bucket en groepeert niet-afleveringen op oorzaak in een uitkomsthistogram:
- Undelivered: een niet-permanente niet-aflevering. Het toestel stond uit of was onbereikbaar.
- Failed: een permanente fout; het bericht kan niet worden afgeleverd.
- Expired: de carrier is gestopt met proberen en heeft het bericht als verlopen gemeld. Bird stelt zelf geen geldigheidsvenster in.
- Rejected: het bericht is geweigerd (een beleidscontrole, een mislukte afschrijving of een carrier die het heeft afgewezen) in plaats van geprobeerd en verloren.
Elke bucket toont het aantal, en alle behalve rejected tonen hun aandeel van geaccepteerde berichten. Bij het afstemmen van de cijfers: de tegel Failure rate telt undelivered, failed en expired, terwijl rejected in dit histogram wordt getoond maar buiten de faalpercentageberekening valt. Een geweigerd bericht is afgewezen in plaats van verloren bij aflevering, en wordt daarom apart bijgehouden.
Afleverlatentie
De latentietabel splitst de timing op in Processing, Delivery en Total. Processing loopt van acceptatie tot carrier-overdracht; Delivery loopt van overdracht tot de gemelde afleveruitkomst; Total beslaat acceptatie tot die uitkomst. Elke fase bevat p50-, p95- en p99-percentielen. Gebruik p95 en p99 om een trage carrier of bestemming te identificeren. Latentie bestrijkt het volledige venster, en een percentiel zonder data toont een streepje.
Programmatische toegang
De stats-API biedt dezelfde samenvatting, reeksen en uitsplitsingen als het dashboard. Uitsplitsingen omvatten land, carrier, afzender, categorie, status, foutcode en inkomende berichten. Waarden komen overeen met het dashboard voor hetzelfde bereik.
Voor afstemming per bericht in plaats van aggregaten, gebruik je webhook-events zodra ze plaatsvinden, of blader je door GET /v1/sms/messages.
Volgende stappen
Gebruik SMS-analytics om afleverrapportages te koppelen aan de bredere campagne- of applicatieworkflow.
- Stats-API: haal elke waarde op deze pagina op vanuit code.
- SMS-log: bekijk de berichten achter de aggregaten.
- Events: verwerk de events achter de statistieken.
- Sending SMS: bekijk categorieën, tags, segmenten en uitgaven.
Gerelateerde bronnen
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.