Sign inGet started

SMS 指标

Bird 仪表板中的指标页面展示了有多少 SMS 流量到达终端以及失败率的变化趋势。本指南说明每个数值的含义以及何时需要排查。
指标是工作区所有发送的汇总视图。计数使用近似去重聚合,因此需要精确对账时请使用消息和计费记录。要查看单条消息的生命周期(某个 号码是否收到了该消息),请参阅 SMS 日志事件

查看指标

在仪表板中打开 SMS > Metrics。时间范围选择器提供最近 24 小时或 7、30、90 天。数值会随着发送和送达回执的到达而更新。
费率使用每条消息的发送时间。今天到达的送达回执如果对应的是昨天受理的消息,则计入昨天,与该消息自身的 accepted 归属一致。因此每个时间范围完整描述了该范围内发送的消息。accepted 是两个费率卡片的分母,即该范围内我们受理的消息数量,所有比率都以此为基准。
包含近期发送的时间范围可能会暂时低报 delivered,因为回执仍在到达中。随着这些消息处理完毕,计数会趋于稳定。

摘要卡片

页面顶部的一排卡片提供一览式健康检查:
  • 送达率:已送达消息占已受理消息的比例。高于 95% 显示为 Healthy;等于或低于该值时,说明某些消息未能到达终端(号码无效、内容被拦截或路由问题),失败明细会告诉你具体原因。卡片还显示与上一周期相比的变化。
  • 失败率:已受理消息中以 undeliveredfailedexpired 结束的比例。卡片以进度条形式显示你的比率与 5% 上限的关系;达到该上限时卡片会切换为 Risk。持续的高失败率通常意味着号码列表质量或内容问题。
  • 已受理:该时间范围内受理的消息原始数量,以及转交给运营商的数量(sent)和与上一周期相比的变化。
仪表板使用 95% 和 5% 阈值来显示 HealthyRisk 标签。Healthy 标签并不意味着每条消息都已送达。

送达趋势

送达图表绘制了该时间范围内已受理已送达失败的数量,便于你发现趋势和单次异常峰值:一次有问题的营销活动、一次错误的号码列表导入、一条降级的路由。failed 系列将所有未送达结果(未送达、失败和过期)合并为一条线。分桶粒度跟随时间范围(24 小时为每小时,更长窗口为每天)。

失败率及其原因

指标页面还绘制了每个分桶的失败率,并在结果直方图中按原因分组显示未送达消息:
  • 未送达:非永久性未送达。终端已关机或不可达。
  • 失败:永久性失败;消息无法送达。
  • 过期:运营商停止尝试并将消息报告为过期。Bird 不设置自己的有效期窗口。
  • 拒绝:消息被拒绝(策略检查、扣费失败或运营商拒收),而非尝试发送后丢失。
每个分桶显示其计数,除 rejected 外均显示占已受理消息的比例。对账时请注意:失败率卡片计入 undeliveredfailedexpired,而 rejected 虽然显示在此直方图中,但不纳入失败率计算。被拒绝的消息是被拒收而非在投递中丢失,因此与投递失败分开统计。

送达延迟

延迟表格将耗时拆分为 ProcessingDeliveryTotal 三个阶段。Processing 从受理到运营商交接;Delivery 从交接到报告的送达结果;Total 跨越从受理到该结果的全程。每个阶段包含 p50、p95 和 p99 百分位数。使用 p95 和 p99 来识别慢速运营商或目的地。延迟覆盖完整的时间窗口,无数据的百分位数显示为短横线。
Bird 仪表板中 SMS 指标页面的下半部分:失败结果直方图(未送达、失败、过期和拒绝的计数)位于送达延迟表格上方,表格包含 processing、delivery 和 total 阶段的 p50、p95 和 p99 列

编程访问

统计 API 提供与仪表板相同的摘要、时序和明细数据。明细维度涵盖国家、运营商、发送号码、类别、状态、错误码和入站消息。在相同时间范围下,数值与仪表板一致。
如需按单条消息对账而非查看汇总数据,可实时消费 webhook 事件,或分页查询 GET /v1/sms/messages

后续步骤

使用 SMS 分析将送达报告与更广泛的营销活动或应用工作流关联起来。
  • 统计 API:通过代码获取本页面的所有数值。
  • SMS 日志:检查汇总数据背后的具体消息。
  • 事件:消费指标背后的事件。
  • 发送 SMS:查看类别、标签、分段和花费。

相关资源

继续查阅此主题的文档、指南和示例。资源为英文。

获取实施简报