厂商消息分类使用指南
消息分类说明
从 Android 8.0(API 级别 26)开始,所有消息都必须通过相应的渠道 ID(ChannelID)进行下发。目前,为了改善终端用户推送体验、营造良好可持续的通知生态,各厂商会根据消息的内容对推送消息进行分类管理,不同的消息分类主要通过渠道 ID(ChannelID)进行区分。目前消息主要分为以下两类:
消息类型 | 重要级别消息 | 普通级别消息 |
---|---|---|
推送内容 | 即时通讯消息、个人关注动态提醒、个人事项提醒、个人订单状态变化、个人财务提醒、等个人重要通知提醒。 | 热点新闻、新品推广、平台公告、社区话题、有奖活动等,多为用户普适性的内容。 |
极光通道消息分类使用
若您需要根据推送内容对消息进行分类管理,可以自定义 Channel ID。
- 创建客户端自定义渠道。
- 推送时下发对应的渠道 ID。
channel_id 参数在 notification 的 android 字段下。
关键字 | 类型 | 选项 | 含义 | 说明 |
---|---|---|---|---|
channel_id | string | 可选 | android 通知 channel_id | 不超过1000字节,这里根据 Channel ID 来指定通知栏展示效果。 |
示例如下:
{
"platform": "all",
"audience": {
"registration_id": [
"1104a8979278ae64e75"
]
},
"notification": {
"android": {
"alert": "message alert",
"channel_id": "your channel_id"
}
}
}
- 若您需要下发厂商通道重要级别消息,请参考下文各个厂商消息分类的使用指南。
小米消息分类使用指南
小米消息分类说明
根据《小米推送消息分类新规》,小米推送将消息分为“私信消息”和“公信消息”两个类别,若应用选择不接入私信或公信,则消息推送会失败。
消息类型 | 公信消息 | 私信消息 |
---|---|---|
推送内容 | 热点新闻、新品推广、平台公告、社区话题、有奖活动等,多用户普适性的内容。 | 聊天消息、个人订单变化、快递通知、交易提醒、IoT 系统通知等与私人通知相关的内容。 |
提醒方式 | 无 | 响铃、振动 |
推送数量限制 | 2-3 倍,具体规则请参见“公信限制规则。 | 不限量 |
用户接收数量限制 | 单个应用单个设备单日 5-8 条 | 不限量 |
申请方式 | 需在小米推送平台申请,详情请参见 channel 申请及接入方式。 | |
API 调用 | - | 极光会按照消息分类自动判断是否需要扣除配额,建议使用 API 下发时,设置 options.classification 为 1,详见 REST API 文档。 |
注意:根据 小米推送消息分类新规,已经没有默认消息分类了,开发者必须根据官方新规接入消息分类,迁移至新channel下发。也就是说,推送时必须传递 channel_id 字段,否则厂商会返回推送失败错误,极光会当「参数错误」类型,阶段2的折损处理。
小米重要级别消息申请
申请方式请参见小米官方文档 channel 申请及接入方法。
注意:必须要收到审核通过的邮件才能使用私信功能!且在推送时,您必须传递 channel_id 字段,否则厂商会返回推送失败错误,极光会当「参数错误」类型,阶段2的折损处理。
小米消息分类使用
服务端使用
channel_id 参数在 options 的 third_party_channel 字段下。
关键字 | 类型 | 选项 | 含义 | 父项目 | 说明 |
---|---|---|---|---|---|
classification | int | 可选 | 消息类型分类 | options | 极光不对指定的消息类型进行判断或校准,会以开发者自行指定的消息类型适配 Android 厂商通道。不填默认为 0。 |
channel_id | string | 可选 | android 通知 channel_id | options.third_party_channel.xiaomi |
示例如下:
{
"options": {
"classification":1,
"third_party_channel": {
"xiaomi": {
"channel_id": "小米推送平台登记的 channel id"
}
}
}
}
控制台使用
- 私信消息需要选择“系统消息”。
- 填写小米推送平台登记的 channel id。
华为消息分类使用指南
华为消息分类说明
根据消息内容,华为推送将通知分类为服务与通讯、资讯营销两大类别,并对不同类别消息的提醒方式、消息样式进行差异化管理,具体如下:
消息类型 | 服务与通讯 | 资讯营销 |
---|---|---|
推送内容 | 包括社交通讯类消息和服务提醒类消息。 | 包括资讯类消息和营销类消息,指的是运营人员向用户发送的活动信息、内容推荐、资讯等。 |
提醒方式(EMUI 10.0及以上) | 锁屏、铃声、振动 | 静默通知,仅在下拉通知栏展示消息 |
消息样式 | 文本+小图 | 仅有文本 |
推送数量 | 不限量 | 自 2023 年 01 月 05 日 起,资讯营销类消息根据应用类型对每日推送数量进行上限管理,具体要求参见 不同应用类别的推送数量上限要求。 |
配置方式 | 需要向华为申请自分类权益,审核通过后将信任开发者提供的分类信息,消息不经过智能分类。 | 默认 |
华为消息分类方式
华为分类标准
从2023年9月15日开始,华为推送服务将基于《华为消息分类标准》将通知分为「云端通知」和「本地通知」,具体参考 华为消息分类管理方案。
华为消息分类「云端通知」使用方式
「云端通知」服务端使用
消息分类的申请审核通过后,即可指定 importance 进行下发,
该参数在 options 可选参数的 third_party_channel 字段下。
关键字 | 类型 | 选项 | 含义 | 父项目 | 说明 |
---|---|---|---|---|---|
classification | int | 可选 | 消息类型分类 | options | 极光不对指定的消息类型进行判断或校准,会以开发者自行指定的消息类型适配 Android 厂商通道。不填默认为 0。 |
importance | string | 可选 | 华为通知栏消息智能分类 | options.third_party_channel.huawei | |
category | string | 可选 | 华为厂商消息场景标识 | options.third_party_channel.huawei | 为了适配华为手机厂商消息,完成自分类权益申请 后,用于标识消息类型,确定消息提醒方式,对特定类型消息加快发送。对应值及其说明参考 category 值说明。 |
代码示例如下:
{
"options": {
"classification":1,
"third_party_channel": {
"huawei": {
"importance": "NORMAL",
"category":"IM"
}
}
}
}
「云端通知」控制台使用
- 服务与通讯消息需要选择“系统消息”。
华为消息分类「本地通知」使用方式
「本地通知」服务端使用
指定 category 进行下发,
该参数是 notification.android 可选参数。
关键字 | 类型 | 选项 | 含义 | 父项目 | 说明 |
---|---|---|---|---|---|
category | string | 可选 | 通知栏消息分类条目 | notification.android | |
priority | string | 可选 | 通知栏展示优先级 | notification.android |
代码示例如下:
{
"notification": {
"android": {
"alert": "Hi, JPush!",
"title": "Send to Android",
"category": "CATEGORY_NAVIGATION",
"priority": "0"
}
}
}
「本地通知」控制台使用
华为消息分类对应表
随着应用的消息发送场景不断变化,华为推送的分类标准会不断演进和补充,请及时留意华为官方文档最新的分类说明,参考 消息分类标准 查询。
云端通知 importance 取值规则可参考上文 “华为消息分类「云端通知」使用方式” 中 importance 字段说明。
消息类型/一级分类 | 消息类型/二级分类 | 消息类型/三级分类 | 云端通知category取值 | 本地通知category取值 | 本地通知importance取值 |
---|---|---|---|---|---|
服务与通讯类 | 社交通讯 | 即时聊天 | IM | CATEGORY_MESSAGE | IMPORTANCE_DEFAULT |
服务与通讯类 | 社交通讯 | 音频、视频通话 | VOIP | CATEGORY_CALL | IMPORTANCE_DEFAULT |
服务与通讯类 | 服务提醒 | 订阅 | SUBSCRIPTION | - | - |
服务与通讯类 | 服务提醒 | 出行 | TRAVEL | CATEGORY_NAVIGATION | IMPORTANCE_DEFAULT |
服务与通讯类 | 服务提醒 | 健康 | HEALTH | - | - |
服务与通讯类 | 服务提醒 | 工作事项提醒 | WORK | CATEGORY_REMINDER | IMPORTANCE_DEFAULT |
服务与通讯类 | 服务提醒 | 帐号动态 | ACCOUNT | - | - |
服务与通讯类 | 服务提醒 | 订单&物流 | EXPRESS | - | - |
服务与通讯类 | 服务提醒 | 财务 | FINANCE | CATEGORY_SERVICE | IMPORTANCE_DEFAULT |
服务与通讯类 | 服务提醒 | 设备提醒 | DEVICE_REMINDER | - | - |
服务与通讯类 | 服务提醒 | 邮件 | CATEGORY_EMAIL | IMPORTANCE_DEFAULT | |
服务与通讯类 | 服务提醒 | 闹钟/计时器 | - | CATEGORY_ALARM | IMPORTANCE_DEFAULT |
服务与通讯类 | 服务提醒 | 秒表 | - | CATEGORY_STOPWATCH | IMPORTANCE_DEFAULT |
服务与通讯类 | 服务提醒 | 进度 | - | CATEGORY_PROGRESS | IMPORTANCE_DEFAULT |
服务与通讯类 | 服务提醒 | 位置共享 | - | CATEGORY_LOCATION_SHARING | IMPORTANCE_DEFAULT |
资讯营销类 | 内容资讯 | 内容推荐 | MARKETING | CATEGORY_RECOMMENDATION | IMPORTANCE_MIN |
资讯营销类 | 内容资讯 | 新闻 | MARKETING | CATEGORY_RECOMMENDATION | IMPORTANCE_MIN |
资讯营销类 | 内容资讯 | 财经动态 | MARKETING | CATEGORY_RECOMMENDATION | IMPORTANCE_MIN |
资讯营销类 | 内容资讯 | 生活资讯 | MARKETING | CATEGORY_RECOMMENDATION | IMPORTANCE_MIN |
资讯营销类 | 内容资讯 | 社交动态 | MARKETING | CATEGORY_SOCIAL | IMPORTANCE_MIN |
资讯营销类 | 内容资讯 | 调研 | MARKETING | CATEGORY_PROMO | IMPORTANCE_MIN |
资讯营销类 | 内容资讯 | 其他 | MARKETING | CATEGORY_PROMO | IMPORTANCE_MIN |
资讯营销类 | 营销活动 | 产品促销 | MARKETING | CATEGORY_PROMO | IMPORTANCE_MIN |
资讯营销类 | 营销活动 | 功能推荐 | MARKETING | CATEGORY_PROMO | IMPORTANCE_MIN |
资讯营销类 | 营销活动 | 运营活动 | MARKETING | CATEGORY_PROMO | IMPORTANCE_MIN |
荣耀消息分类使用指南
荣耀消息分类说明
根据消息内容,荣耀推送将通知分类为服务与通讯、资讯营销两大类别,并对不同类别消息的提醒方式、消息样式进行差异化管理,具体如下:
消息类型 | 服务与通讯 | 资讯营销 |
---|---|---|
推送内容 | 包括社交通讯类消息和服务提醒类消息。 | 包括资讯类消息和营销类消息,指的是运营人员向用户发送的活动信息、内容推荐、资讯等。 |
提醒方式 | 锁屏展示+下拉通知栏展示,支持铃声、震动 | 静默通知,仅在下拉通知栏展示消息 |
消息样式 | 文本+小图 | 仅有文本 |
推送数量 | 不限量 | 资讯营销类消息根据应用类型对每日推送数量进行上限管理, 具体要求参见 不同应用类别的推送数量上限要求。 |
REST API 配置 | 指定 importance 为 low |
荣耀消息分类方式
消息智能分类
智能算法将根据 APP 类型和消息内容等维度,自动将您的消息按照分类标准进行归类。
消息自分类
允许开发者根据消息分类规范,自行对消息进行分类。
目前,所有消息默认通过消息自分类方式进行分类处理,荣耀推送服务将充分信任您提供的分类结果,并且按您提供的分类结果展示对应信息。随着荣耀推送服务能力的不断补充和演进,分类方式也会逐渐更新与升级,请及时留意本文档最新的分类方式说明。
荣耀消息分类使用
服务端使用
指定 importance 进行下发,该参数在 options 可选参数的 third_party_channel 字段下。
关键字 | 类型 | 选项 | 含义 | 父项目 | 说明 |
---|---|---|---|---|---|
classification | int | 可选 | 消息类型分类 | options | 极光不对指定的消息类型进行判断或校准,会以开发者自行指定的消息类型适配 Android 厂商通道。不填默认为 0。 |
importance | string | 可选 | 荣耀通知栏消息智能分类 | options.third_party_channel.honor |
示例如下:
{
"options": {
"classification":1,
"third_party_channel": {
"honor": {
"importance": "NORMAL"
}
}
}
}
控制台使用
- 服务与通讯消息需要选择“系统消息”。
- 服务与通讯消息需要设置 importance 为 NORMAL。
OPPO 消息分类使用指南
OPPO 消息分类说明
- OPPO 厂商 2024.11.20 实施OPPO消息分类新规,消息分成「通讯与服务」、「内容与营销」两大类别,分别对应极光平台「系统消息」、「运营消息」,根据对不同类别消息的关注度,OPPO官方提供对应的权限如下:
消息类型 | 定义范围 | 推送内容方向 | 提醒方式 | 推送量级 |
---|---|---|---|---|
通讯与服务 | 1、用户间的聊天消息、通话等信息; 2、与用户自身息息相关的重要通知提醒,用户对接收此类消息有预期; |
1、用户间点对点聊天消息(或私信)、群聊天消息、视频语音提醒; 2、个人账号与资产变化;个人设备提醒;个人订单/物流状态变化等; |
默认为<通知栏、锁屏>;可升级为<通知栏、锁屏、横幅、铃声、震动>强提醒方式(需找OPPO官方申请); | 发送量级和接收量级均不限 |
内容与营销 | 开发者主动向用户发送的对内容或产品推广的通知 | 内容推荐、平台活动、社交动态等; | 仅下拉通知栏展示 | 限制每日推送量级与单用户接收条数,具体参考:《推送服务受限说明》 |
OPPO 推送数量限制
推送权限 | 消息分类 | 应用类别 | 推送总量 | 单设备推送条数限制 |
---|---|---|---|---|
正式权限 | 通讯与服务(原私信消息) | / | 不限量 | 不限量 |
内容与营销(原公信消息) | 新闻类(三级分类为新闻类) | 累计用户数 < 10000,总量按20000/日计算;累计用户数≥10000,总量=累计用户数*2/日; | 5条 | |
其他应用类型 | 2条 | |||
测试权限 | 通讯与服务(原私信消息) | / | 不支持 | |
内容与营销(原公信消息) | / | 1000 | 2条 |
OPPO 消息分类使用
- Step1:服务端关注(classification、channel_id、category、notify_level)4个字段,详细字段说明如下,或查看极光 Push API 文档。
- Step2:配置推送消息时携带以上字段,消息以对应提醒方式下发。
关键字 | 类型 | 选项 | 含义 | 父项目 | 说明 |
---|---|---|---|---|---|
classification | int | 可选 | 消息类型分类 | options | 极光不对指定的消息类型进行判断或校准,会以开发者自行指定的消息类型适配 Android 厂商通道。不填默认为 0。 |
channel_id | string | 可选 | android 通知 channel_id | options.third_party_channel.oppo | |
category | string | 可选 | 华为、vivo、OPPO 厂商消息场景标识 | options.third_party_channel.oppo | 为了适配华为、vivo、OPPO 手机厂商消息,用于标识「云端通知」消息类型,确定消息提醒方式,对特定类型消息加快发送。 |
notify_level | int | 可选 | OPPO通知栏消息提醒等级 | options.third_party_channel.oppo |
示例如下:
{
"options": {
"classification":1,
"third_party_channel": {
"oppo": {
"channel_id": "OPPO 官网登记的通道 ID"
"category": "IM"
"notify_level": 16
}
}
}
}
控制台使用
- 私信消息需要选择“系统消息”,具体请您根据实际情况正确选择。
- 填写 OPPO 消息分类参数,确保数据填写正确。
vivo 消息分类使用指南
vivo 消息分类说明
- 通知开启的有效用户:应用集成的 push-sdk 订阅成功,且设备近 14 天内有联网的通知权限开启用户。
- 通知开启有效用户数<10000,则运营消息量级默认为 10000。
- 通知开启的有效用户数及可发送运营消息量级,可在推送运营后台查询。
- 推送限额数以“到达量”计算,当日到达量超限则计入管控。
- 测试消息不受量级和频控限制。发送测试消息时注意填写 pushMode=1(0:正式推送;1:测试推送;不填默认为 0)。若未填写,则文案相同时,将被当做重复运营消息被去重。
消息类型 | 系统消息 | 运营消息 |
---|---|---|
推送内容 | 用户需要及时知道的消息,如:即时消息、邮件、用户设置的提醒、物流等通知。 | 用户关注程度较低的消息,如:内容推荐、活动推荐、社交动态等通知。 |
通知栏权限 | ||
推送数量限制 | 3 倍通知开启有效用户数(可邮件申请消息不限量权限,详见 推送消息限制说明)。 |
|
用户接收数量限制 | 无限制 | |
配置方式 | 设置 options.classification 为 1 | 默认 |
vivo 系统消息使用
1.通过 API 传入相应参数
特别注意:通过 API 接口支持消息分类,下发 classification 参数,该参数在 options 可选参数字段下。完整分类字段有2个,如下说明:
关键字 | 类型 | 选项 | 含义 | 父项目 | 说明 |
---|---|---|---|---|---|
classification | int | 可选 | 消息类型分类 | options | 极光不对指定的消息类型进行判断或校准,会以开发者自行指定的消息类型适配 Android 厂商通道。不填默认为 0。 |
category | string | 可选 | 厂商消息场景标识 | options.third_party_channel.vivo | 为了适配 vivo 手机厂商消息,用于标识消息类型,确定消息提醒方式,对特定类型消息加快发送。对应值及其说明参考:vivo 分类标准。 |
示例如下:
{
"options": {
"classification":1,
"third_party_channel": {
"vivo": {
"distribution": "secondary_push",
"category":"IM"
}
}
}
}
控制台使用
- 系统消息需要选择“系统消息”。
- 配置符合 vivo 分类标准的 category。
2.智能分类二次修正
- 参数传"0"代表运营消息,不经过智能分类二次修正,直接从运营消息总量扣除额度,并受用户接收条数限制的频控。
- 参数传"1"代表系统消息,经过智能分类二次修正,若智能分类识别出不是系统消息,会自动修正为运营消息,并扣除运营消息额度;若识别为系统消息,则从系统消息总量扣除额度。