产品 FAQ
本文从产品能力、业务场景、合规限制三个角度整理极光推送常见问题，帮助您快速判断“应该用什么能力、适合什么场景、需要注意哪些限制”。
如果您正在做能力选型或业务方案设计，建议先看本文；如果已经遇到错误码、收不到推送、厂商通道不生效等问题，请查看 技术与排查 FAQ。
快速定位
| 如果您想了解 | 建议查看 |
|---|---|
| 通知、自定义消息、Registration ID 等基础概念 | 基础概念 |
| 订单、物流、交易、安全等重要消息怎么发 | 重要消息应该怎么发 |
| 活动、推荐、公告等运营消息怎么控制打扰 | 运营消息应该怎么发 |
| App 在线走业务协议，离线仍需提醒用户 | 自定义消息转厂商通知 |
| 用户关闭通知权限后如何触达 | 通知权限关闭用户触达 |
| 消息覆盖、撤回、短信补充、VIP 权益 | 场景能力选择 |
| 合规、敏感消息、消息长度、厂商限量 | 限制与合规 |
基础概念
什么是 Registration ID？
客户端初始化 JPush 成功后，JPush 服务端会分配一个 Registration ID，作为当前 App 在当前设备上的推送标识。同一台手机上的不同 App，Registration ID 不同。
Registration ID 常用于单设备测试、问题排查和精准推送。获取方式参考 Android 获取 RegistrationID API 和 iOS 获取 RegistrationID API。
通知与自定义消息有什么区别？
通知（Notification） 会展示在手机通知栏，主要用于提醒用户，例如订单状态、活动通知、版本更新、内容提醒等。
自定义消息（Message） 默认不会展示在通知栏，极光只负责透传给客户端 SDK，展示形式和业务处理逻辑由开发者自行实现，适合 App 内业务协议、状态同步、特殊展示等场景。
如果希望 App 在线时走自定义消息，离线时仍通过通知提醒用户，可以使用 自定义消息转厂商通知。
如何查看服务端推送记录？
进入【消息推送】-【推送管理】-【推送记录】，可以查看通知消息、自定义消息、应用内消息、实时活动消息和 A/B 测试记录。
如果需要查看 API 推送记录，可在推送记录中筛选推送方式为“API”。推送记录中的 Message ID 可用于后续统计和排查。
推送统计和折损原因是什么意思？
推送统计用于查看发送、送达、展示、点击等数据；折损原因用于定位推送链路中不同阶段的流失情况，例如目标无效、通道失败、未送达、未展示等。
详情参考 推送统计与折损说明。
场景能力选择
订单、物流、交易、账号安全等重要消息应该怎么发？
这类消息与用户强相关，建议优先使用通知消息，并按厂商规则配置系统消息、服务与通讯类消息、私信消息等重要消息分类。
推荐做法：
- Android 侧完成厂商通道集成，提升离线到达能力。
- API 下发时设置准确的
options.classification，重要消息通常使用1。 - 根据业务有效期设置离线保留时长，避免用户短暂离线导致消息丢失。
- 对必须触达的场景配置短信补充兜底。
- 接入推送统计、回执和排查工具，持续观察送达、点击和未达原因。
相关文档：
活动、内容推荐、平台公告等运营消息应该怎么发？
运营消息通常不应占用重要消息分类。建议使用运营消息分类、分群、频控和可接受时间段，减少用户打扰。
推荐做法：
- API 下发时使用
options.classification=0；不传时默认也是运营消息。 - 使用标签、别名、用户属性或分群筛选目标用户。
- 开启单设备每日频控和可接受时间段。
- Android 厂商通道需配置厂商运营消息策略，遵守厂商单设备条数、配额和 QPS 限制。
- 对低价值内容优先考虑应用内消息、站内信或不发送。
相关文档：
App 在线时想走业务协议，离线时还想提醒用户，应该用什么能力？
可以使用“自定义消息转厂商通知”。App 在线时通过 message 透传业务协议；App 长连接不在线时，通过 notification_3rd 转为厂商通知提醒用户。
适合场景：
- IM、工单、待办、告警等原本依赖自定义消息的业务。
- 在线时由 App 内部逻辑处理，离线时需要通知栏提醒。
- Android、iOS、HarmonyOS 多平台都需要尽量触达。
注意事项：
- 推荐使用
notification_3rd_ver=v2。 notification和notification_3rd不能同时有内容。- 转成厂商通知后仍需遵守通知权限、厂商分类和运营消息频控规则。
相关文档：
用户关闭通知权限后，还能触达吗？
可以，但不建议继续只依赖通知栏。应根据消息重要程度选择应用内提醒、短信补充、站内信或权限引导。
推荐做法：
- 对仍在 App 内活跃的用户，使用应用内提醒或站内消息。
- 对交易、账号安全、订单异常等必须触达消息，使用短信补充兜底。
- 对普通运营消息，降低频率，不建议用短信兜底。
- 在用户理解价值的节点引导开启通知权限，例如订阅提醒、下单、预约、账号安全设置后。
相关文档：
一条业务状态持续更新，怎么避免用户收到多条历史通知？
建议使用消息覆盖能力，让用户只看到同一业务事件的最新状态。
实现方式：
- Android 使用
options.override_msg_id覆盖上一条推送。 - iOS 使用
options.apns_collapse_id更新通知中心内相同标识的通知。 - 落地页仍需按业务 ID 查询最新状态，避免展示过期内容。
相关文档：
误发、过期或不应继续展示的通知怎么办？
可以使用推送撤销 API 尝试撤回消息，并在业务落地页增加状态校验。
推荐做法：
- 误发后尽快调用推送撤销 API。
- 对已展示但未点击的通知，SDK 会在支持范围内尝试设备端撤销。
- 对活动、券、任务、订单等业务，落地页必须校验当前状态，避免用户点击历史通知继续访问。
相关文档：
免费用户和 VIP 用户在场景能力上怎么选择？
免费用户可使用基础推送能力，但厂商通道能力和部分高级能力会有资源限制。VIP 用户通常能获得更稳定的厂商通道资源、更高推送速度和更多高级能力支持。
建议：
- 普通通知、低频运营通知可先使用基础能力。
- 对离线到达率、实时性、大规模推送有高要求时，建议评估 VIP 服务。
- 对强到达业务，可结合厂商通道、短信补充、回执和统计做完整链路。
相关文档：
限制与合规
使用极光推送服务有哪些核心合规要求？
为保障用户隐私和数据安全，建议优先推送非涉密、非隐私类常规消息，例如运维公告、版本升级、活动通知等。
涉及隐私、涉密或高敏感内容时，应避免在通知栏直接展示明文详情，并结合业务鉴权、加密和合规要求进行设计。
敏感消息可以直接放在通知内容里吗？
不建议。涉及用户隐私或业务涉密的内容，例如账户信息、实名资料、私密会话等，不应以明文直接推送。
推荐做法：
- 通知栏只展示非敏感摘要，例如“您有一条新的账户提醒”。
- 敏感详情在 App 内通过登录态和业务权限校验后展示。
- 如确需推送敏感内容，开发者需自行完成端到端加密、密钥管理和解密闭环。
相关文档：
消息长度是否有限制？
- Android 平台 Notification + Message 长度限制为 4000 字节。
- iOS Notification 中
"ios": {}及大括号内的总体长度不超过 2000 字节，包括自定义参数和符号。 - iOS Message 部分长度不超过 4000 字节。
资讯营销类消息为什么会有频次和单设备数量限制？
厂商会对消息进行分类管理。默认类型通常是运营消息，单设备单日可接收的运营消息数量有限，一般为 2-5 条，且可能没有声音或弹框。
建议按照 厂商消息分类使用指南 区分系统消息和运营消息，并结合 运营推送频控与用户打扰控制最佳实践 进行频控。
应用在黑名单中，提示禁止发送消息是什么意思？
此错误通常表示应用暂未上架小米应用市场。小米官方要求应用上架后，才可以通过小米通道下发消息。各厂商上架说明参考 厂商通道参数申请指南。
推送 SDK 消耗多少电量和流量？
实际电量和流量消耗与网络状况、设备状态和业务使用方式有关。不考虑推送内容本身，理论平均值约为：流量消耗 20 KB/天，电量消耗 30 mAh/天。
推送服务关闭状态是什么意思？
此状态通常表示客户端调用了 stopPush 停止推送服务。需要调用 resumePush 恢复推送服务，详情参考 SDK API 文档。
推送限制相关名词在哪里查看？
极光推送限制相关名词说明参考 推送名词说明。
