> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# SMS 消息报告
> 在 OneSignal 中查看 SMS 和 RCS 投递统计、点击率以及失败详情。涵盖所有消息指标、错误代码故障排除、数据保留以及如何导出数据。
SMS 消息报告为您发送的每条消息提供投递统计、互动指标以及收件人级别的详情。SMS/MMS 和 RCS 消息均提供报告。
***
## 指标参考
### 消息级别指标
| 指标 | 定义 |
| -------------------------------- | ------------------------------------------------------------------------------------------------- |
| **已发送（Sent）** | 从 OneSignal 发送的消息数量，包括成功发送到运营商的消息和失败的消息。 |
| **受众（Audience）** | 目标细分中的订阅数量。 |
| **剩余（Remaining）** | 目标受众中尚未收到消息的订阅数量（已排队或正在发送中）。显示在仪表盘投递报告中。 |
| **已投递（Delivered）** | 成功投递到运营商的消息数量。在报告中分别显示 SMS/MMS 和 RCS。 |
| **失败（Failed）** | 发送到运营商失败的消息数量。 |
| **已抑制（Suppressed）** | 由于订阅已选择退出接收来自发送方的消息而未发送的消息数量。 |
| **已拒绝（Rejected）** | 由于号码封锁、速度封锁或收件人封锁列表而未被运营商投递的消息数量。这是一个衍生指标：提供商错误（Provider Errored）和提供商未投递（Provider Undelivered）之和。 |
| **提供商错误（Provider Errored）** | 运营商未能发送消息的订阅数量。 |
| **提供商未投递（Provider Undelivered）** | 运营商已发送但未能投递消息的订阅数量。 |
| **已读（Read）** *(仅限 RCS)* | 阅读了 RCS 消息的订阅数量。由于 RCS 支持已读回执，因此该指标可用。 |
| **总点击数（Total Clicks）** | 消息中链接被点击的总次数，包括重复点击。 |
| **唯一点击数（Unique Clicks）** | 唯一链接点击的数量。每个订阅仅计一次。 |
| **已回复（Replied）** | 与自定义关键词匹配的入站回复数量。不包括同意关键词（STOP、HELP、START）。 |
| **已退订（Unsubscribed）** | 收到的入站退订关键词回复数量（例如 STOP）。 |
### 报告级别指标
| 指标 | 描述 |
| ------------------------------------ | ----------------------------------------------- |
| **投递率（Delivery rate）** | 成功投递的消息百分比。 |
| **失败和拒绝率（Failure & rejection rate）** | 未投递或被抑制的消息百分比。 |
| **点击率（CTR）** | 点击此消息中链接的收件人总数百分比。有关点击跟踪的更多详情，请参阅[链接](./links)。 |
有关所有渠道的指标定义，请参阅[指标术语表](./analytics-metrics-glossary)。
***
## 数据保留
SMS 消息和相关报告数据保留约 **30 天**。如果您需要长期记录，请导出消息或受众数据。请参阅[导出数据](./exporting-data)。
***
## 转化
即将推出：消息报告中的[转化指标](./conversion-metrics)。一旦可用，您将能够直接在每条消息的报告中看到归因转化和受影响转化。
***
## 了解 SMS 失败
在排查可投递性问题时，请查看受众活动（Audience Activity）中的**确切错误文本**。
| 错误文本 | 错误代码 | 通常含义 | 处理方法 |
| ----------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------- |
| **Message blocked** | [30004](https://www.twilio.com/docs/api/errors/30004) | 运营商或策略层阻止了消息。常见原因：运营商内容过滤、发送方信誉、10DLC/注册问题、收件人退订状态或区域规则（例如印度 DLT）。 | 确认选择加入和 STOP 处理。使内容与您注册的用例保持一致。在需要的地方完成 10DLC/品牌注册。避免类似垃圾信息的模式。 |
| **Unknown destination handset** | [30005](https://www.twilio.com/docs/api/errors/30005) | 号码未知、无效或不再有效（数字错误、线路已断开或国家代码输入错误）。 | 在发送前将号码验证并规范化为 E.164 格式。移除座机和无效号码。请参阅[受众验证](./sms-opt-in-and-collection#audience-validation)。 |
| **Unreachable destination handset** | [30003](https://www.twilio.com/docs/api/errors/30003) | 号码可能有效，但手机已关机、不在服务范围内，或以阻止 SMS 的方式漫游。 | 稍后重试。 |
可能会出现其他数字代码。请在 [Twilio 错误索引](https://www.twilio.com/docs/api/errors)中搜索受众活动中显示的代码。OneSignal SMS 使用 Twilio 基础设施，因此这些代码适用于两种设置。
### 没有错误文本的消息
当运营商或提供商未提供详细代码时，某些失败不返回错误文本或返回空的原因字段。在仪表盘中，这些通常归入 **Failed to Send**。建议的步骤：
1. 确认号码是有效的 E.164 格式，并且订阅符合 SMS 条件且未退订。
2. 延迟后重试，以防出现暂时性的提供商或运营商问题。
3. 如果问题普遍存在，请收集示例消息或投递 SID，并联系 OneSignal 支持团队。
***
## 计费
### OneSignal SMS 客户
在 **Settings > Usage > SMS > See breakdown** 下查看您的用量。明细按消息类型显示发送的段（segment，而非消息），可按国家/地区筛选。明细每天更新。
计数包括所有出站段，包括为响应同意关键词（STOP、HELP、START）或其他自定义关键词回复而发送的自动回复。失败的消息不计入段计数。
### Twilio 集成客户
您直接向 Twilio 付费。有关计费问题，请查看您的 Twilio 仪表盘。
***
## 常见问题
### 为什么我的投递率低于预期？
常见原因包括无效电话号码、已退订的订阅者（显示为已抑制）、运营商端内容过滤或注册问题（显示为已拒绝或提供商错误）。请查看受众活动中的错误文本以了解具体原因。
### 失败（Failed）和已拒绝（Rejected）有什么区别？
失败意味着 OneSignal 根本无法将消息发送到运营商。已拒绝意味着运营商收到了消息但未投递，通常是由于号码封锁、速度限制或收件人在封锁列表中。
### 消息报告可保留多久？
SMS 消息报告和受众活动数据保留约 30 天。如果您需要更长的保留期，请导出您的数据。
### 我可以查看哪些个别订阅者收到了消息吗？
可以。每个消息报告的受众活动部分显示收件人级别的投递和互动详情，包括失败消息的任何错误代码。
### 为什么某些消息没有错误代码？
某些运营商和提供商不会为投递失败返回详细的错误代码。这些在受众活动中显示为空。如果您看到大量没有错误详情的失败，请收集消息 SID 并联系 OneSignal 支持团队。
***
## 相关页面
编码、段计算、MMS 限制以及内容如何影响计费。
受众验证和电话号码格式要求。
导出投递和互动数据用于长期保留。
OneSignal 如何在 SMS、MMS 和 RCS 消息中跟踪点击。