简介
目前,厂商会逐步对 App 开发者的通知消息根据分类进行限额限频,以此保证终端用户不被过度骚扰,不同的消息分类主要通过渠道 ID(ChannelID)进行区分。移动推送综合各厂商的分类能力,支持将消息分为两类:
公信消息(默认):适用于推送全员公告、运营活动、热点新闻等,多为用户普适性的内容,推送数量限制每日2/5条。
私信消息:适用于推送聊天消息、个人订单变化、交易提醒等与私人通知相关的内容,通知消息的推送数量不受限制。
消息分类支持在调用推送 API 时指定,同时管理台也支持消息分类。
魅族暂不支持消息分类,且不限额。
使用步骤
1. 若需要使用厂商通知消息,按以下说明申请或创建通知消息的 Channel ID:
说明
从 Android 8.0(API 级别 26)开始,弹出通知栏通知必须先为应用创建通知渠道,并为要弹出的通知分配渠道,否则通知将不会显示。通过将通知分配给特定的通知渠道,则该通知将以该通知渠道已被开启的行为功能展示在通知栏中。用户可以为应用的每个通知渠道进行个性化控制,而非直接管理应用的所有通知,例如控制每个渠道的开闭、视觉和听觉选项等。
一个应用可以有多个通知渠道,建议设置不超过7个通知渠道。应用的每个通知渠道按照通知渠道 ID(channel_id)区分,通知渠道以通知渠道名称(channel_name)定义的文本展示在应用的通知设置中。
通知渠道一旦创建,设备用户拥有完全控制权,开发者便无法更改通知行为。对同一个通知渠道 ID(channel_id)进行重复创建的代码调用,仅不同的通知渠道名称(channel_name)和渠道描述参数会生效,其他的视觉、听觉、重要性等选项无法改变。
2. 若需要使用厂商做渠道分类管理,自定义 Channel ID,从而做到根据 App 自身的业务消息类别进行消息分类,可根据不同厂商对应进行配置:
推送通道 | 配置说明 |
移动推送自建通道 | App 端,调用 Android SDK 创建 Channel ID 接口创建 Channel ID。 调用移动推送 服务端 API 时,指定对应的 Channel ID(不限额度)。 控制台创建推送任务时,选定TPNS消息类型标识传值。 |
华为/鸿蒙 | 在华为管理台 申请自分类权益,自分类权益生效后,应用的推送消息将根据 hw_category 字段进行归类。 调用移动推送 服务端 API 时,指定 hw_category 参数。 华为控制台创建推送任务时,选定华为消息类型标识参数传值。鸿蒙暂不支持控制台推送。 华为的 ChannelID 作为自定义的渠道策略展示消息提醒方式,不作消息分类。 |
小米 | 在小米开放平台管理台上申请 Channel ID 或通过小米服务端 API 创建。 调用移动推送 服务端 API 时,指定对应的 Channel ID。 控制台创建推送任务时,选定小米渠道ID参数传值。 |
OPPO | App 端,调用 Android SDK 创建 Channel ID。 在 OPPO 管理台申请登记该 Channel ID,保持一致性。 调用移动推送 服务端 API 时,指定对应的 Channel ID。 控制台创建推送任务时,选定OPPO渠道ID参数传值。 |
魅族 | 无 Channel 相关说明。 |
vivo | 支持配置使用 vivo 系统消息/运营消息,不支持自定义通知渠道 Channel 。 无需单独申请消息分类,可参见vivo消息分类场景直接使用。 调用移动推送 服务端 API 时,指定 vivo_category 参数并正确赋值。 控制台创建推送任务时,选定vivo_category 参数传值。 |
荣耀 | 支持配置使用 荣耀 服务通讯/资讯营销消息,不支持自定义通知渠道 Channel 。 无需单独申请消息分类,可参见荣耀消息分类场景直接使用。 调用移动推送 服务端 API 时,指定 hw_importance 参数正确赋值。 暂不支持控制台推送。 |
3. 若既不需要使用厂商通知消息,也不需要自定义 Channel ID,则无需做任何处理,移动推送会为 App 的所有消息指定一个默认的 Channel ID,消息归到默认类别中。
4. 在控制台创建推送任务需要使用渠道分类时,请打开厂商通道分类开关指定对应的渠道传值。
OPPO 通知渠道申请指南
OPPO 通知渠道介绍
OPush 平台上默认的是公信通道,目前在原有基础上新增“私信”通道,对单个用户推送个性化信息时,不再受推送数量限制。以下是“公信”和“私信”的对比:
类型 | 公信 | 私信 | |
推送内容 | | 热点新闻、新品推广、平台公告、社区话题、有奖活动等,多用户普适性的内容。 | 个人订单变化、快递通知、订阅内容更新、评论互动、会员积分变动等,与单个用户信息强相关的内容。 |
单用户推送限制(条/日) | 新闻类(三级分类为新闻类) | 5条 | 不限量。 |
| 其他应用类型 | 2条 | 不限量。 |
推送数量限制 | | 所有公信类通道共享推送次数,当日达到次数限制后,所有公信类通道将不能再推送消息,目前当日推送数量为:累计注册用户数 * 2 。未上架应用市场的测试权限仅提供1000条/日 | 不限量。 |
配置方式 | | 默认。 | 需要在 OPPO PUSH 运营平台上登记该通道,并将通道对应属性设置为“私信” 。 |
警告:
OPPO 官方提醒:切记!一定不要利用私信通道用于普适性消息推送(例如热点新闻、新品推广等),后台会实时监控,如违反运营规则,OPush 有权关闭您的私信通道权限。由此产生的后果,如调用接口异常,或使用私信通道发送的消息没到达用户等,由业务方自行承担。
OPPO 私信通道申请
1. 进入 OPPO 开放平台,在应用配置 > 新建通道中新建通道,通道 ID 与通道名称必填且需要与应用客户端保持一致,其他选项可不填。
OPPO 私信通道使用
1. 客户端创建通知渠道(必须与OPPO平台申请的渠道ID保持一致),请选择以下任意一种方式创建:
1.1 使用 Android API 创建通知渠道,详见 Android 官方文档 创建和管理通知渠道。
1.2 使用移动推送SDK(1.1.5.4及以上的版本)创建通知渠道,详见文档 创建通知渠道。
2. 支持 Rest API和控制台创建推送。
2.1 在 Rest API 请求参数 Android 结构体中设置
oppo_ch_id
参数,可实现根据渠道ID分类下发,具体参见 PushAPI 参数说明。
推送示例如下:{"audience_type": "token","token_list": ["005c28bf60e29f9a1c2052ce96f43019a0b7"],"message_type": "notify","message": {"title": "测试标题","content": "测试内容","android": {"oppo_ch_id": "私信通道id"}}}
2.2 控制台推送,打开厂商通道分类功能,选定OPPO渠道ID参数传值。
小米通知渠道申请指南
小米通知渠道介绍
公信消息适用于推送热点新闻、新品推广、平台公告、社区话题、有奖活动等,多为用户普适性的内容。
私信消息适用于推送聊天消息、个人订单变化、快递通知、交易提醒、IOT 系统通知等与私人通知相关的内容,通知消息的推送数量不受限制。
小米推送对推送消息数量、推送速率 QPS 进行了统一管理,详情请参见 小米推送消息限制说明。
公信消息与私信消息限制说明:
消息类型 | 消息内容 | 推送数量限制 | 用户接收数量限制 | 申请方式 |
公信消息 | 热点新闻、新品推广、平台公告、社区话题、有奖活动等,多用户普适性的内容。 | |||
私信消息 | 聊天消息、个人订单变化、快递通知、交易提醒、IoT系统通知等与私人通知相关的内容。 | 不限量 | 不限量 | |
小米额外提升推送量级申请
小米通知消息使用
支持 Rest API和 控制台创建推送。
1. 推送在 Rest API 请求参数
Android
结构体中设置xm_ch_id
参数,可实现小米通知渠道下发,详情请参见 PushAPI 参数说明。
推送示例如下:{"audience_type": "token","token_list": ["005c28bf60e29f9a***2052ce96f43019a0b7"],"message_type": "notify","message": {"title": "小米通知消息","content": "测试内容","android": {"xm_ch_id": "小米通知消息的channel_id"}}}
2.控制台推送,选定小米渠道ID参数传值。
vivo 系统消息申请指南
vivo 消息分类介绍
vivo 消息分类功能将推送消息类型分为运营消息和系统消息。
为提升用户消息通知体验,营造良好推送生态,vivo 推送服务于2023年4月3日起,针对不同应用类别的消息进行统一管理,开发者需根据自身应用的通知场景,将消息内容按照对应消息类别发送。详情请参见 vivo 的 推送消息限制说明。
消息类别 | 划分原则 | 允许发送的内容 | 应用类别 | 推送数量限制 | 用户接收数量限制 | 提醒方式 | 接入方式 |
系统消息 | 用户对收到此类消息有预期,并需要及时知道的消息,如果错过可能会导致不良影响。 | 即时消息 账号与资产 日程待办 设备信息 订单与物流 订阅提醒 | / | 无限制 | 悬浮 锁屏 响铃 震动 | ||
运营消息 | 用户对收到此类消息无预期,关注程度较低。 | 新闻 内容推荐 运营活动 社交动态 | 新闻资讯类 | 3倍通知开启有效用户数 | 5条 | 无提醒,仅在下拉通知栏展示 | |
| | | 其他类 | 2倍通知开启有效用户数 | 2条 | | |
推送数量超过当日限制时,返回错误码10070或10073:
10070:运营消息发送量总量超出限制。
10073:系统消息发送量总量超出限制,如需要申请无限量推送可参考的vivo系统消息申请。
说明
2020年6月1日前,无论是否接入消息分类,频控规则不变,均按每个应用单用户“公共类消息(全推,群推,标签推)”每天接收上限为5条,不限制单推条数。2020年6月1日起,频控规则变更为按每个应用单用户“运营消息”接收条数上限5条进行频控,若出现用户体验类投诉,将会根据实际情况调整条数。
Funtouch OS_10 及以上版本没有消息盒子,应用不存活时窄条展示,具体样式以实际为准。
若消息内容满足订阅类消息条件,可按特殊场景消息归档模板提供相应材料向 vivo 申请,申请方法详见下方 vivo 系统消息申请。
若某 vivo 用户当前接收运营消息超过2/5条,则当天触发限额后的运营消息均会通过移动推送自建通道下发,不再通过 vivo 通道下发。
为避免造成用户打扰,目前vivo手机接收的消息为7:00-23:00,服务器允许推送时间为7:00-23:00,系统消息不受此时间限制,系统消息申请详情请参见 vivo 系统消息申请指南。
vivo消息分类不需要另外申请,可直接使用。
警告:
vivo 系统消息使用
支持 Rest API和 控制台创建推送。
1.如在 Rest API 请求参数
Android
结构体中设置 vivo_category
参数为"IM",可实现 vivo 系统消息下发,具体参见 PushAPI 参数说明 参数说明。说明
2023年4月3日起由
vivo_ch_id
调整为 vivo_category
字段,若您在二级分类方案调整前,已经使用 vivo_ch_id 进行消息分类,请您尽快完成新方案的适配,补充 vivo_category 的传值。按以上表格申请 vivo 二级分类新方案 vivo 系统消息申请。推送示例如下:
{"audience_type": "token","token_list": ["005c28bf60e29f9a***2052ce96f43019a0b7"],"message_type": "notify","message": {"title": "vivo系统通知","content": "测试内容","android": {"vivo_category": "IM"}}}
2.控制台推送,指定 vivo_category 参数并正确赋值。
华为/鸿蒙消息分类使用指南
华为/鸿蒙消息分类介绍
华为推送从 EMUI 10.0版本开始将通知消息智能分成两个级别:服务与通讯和资讯营销。EMUI 10.0之前的版本没有对通知消息进行分类,只有一个级别,消息全部通过“默认通知”渠道展示,等价于 EMUI 10.0的服务与通讯。资讯营销类消息的每日推送数量自2023年01月05日起根据应用类型对推送数量进行上限管理,服务与通讯类消息每日推送数量不受限。
华为/鸿蒙回执 256 表示当日的发送量超出资讯营销类消息的限制,请您调整发送策略,各消息类型详情请参见华为的 推送数量关系细则。
如图所示:
不同消息级别呈现样式对比:
消息分类 | 提醒方式 | 类型说明 | 推送数量限制 | |
服务与通讯消息 | 锁屏、铃声、振动 | 社交通讯:即时聊天,音频、视频通话。
服务提醒:订阅,出行,健康,工作事项提醒,账号动态,订单&物流,财务,设备提醒,系统提示,邮件,闹钟/计时器,秒表,进度,位置共享。
具体类别请参见服务与通讯类消息场景说明。 | 无限制。 | |
资讯营销消息 | 静默通知,仅在通知栏展示消息 | 新闻类(需具备《互联网新闻信息服务许可证》) | 5条 | |
| | | 其他类 | 2条 |
警告:
华为自分类消息权益申请
注意
若应用没有自分类权益,则应用的推送消息将通过智能分类进行自动归类。
若应用有自分类权益,将信任开发者提供的分类信息,消息不经过智能分类。
华为和鸿蒙消息分类申请流程一样。
华为/鸿蒙自分类消息使用
支持 Rest API和 控制台创建推送。
注意:
hw_category字段取值为大写的英文单词且仅可填写在分类权益页面中已在华为平台审批通过的category值。
推送示例如下:
{"audience_type": "token","token_list": ["005c28bf60e29f9a***2052ce96f43019a0b7"],"message_type": "notify","message": {"title": "账号下线:","content": "您的账号出现异地登录,已经下线。","android": {"hw_category":"VOIP"}}}
2.华为自分类控制台推送,指定 hw_category 参数并正确赋值,鸿蒙暂不支持控制台推送。
华为通知渠道创建
华为推送支持应用自定义通知渠道分组,客户端创建通知渠道,请选择以下任意一种方式创建:
1. 使用 Android API 创建通知渠道,详情请参见 Android 官方文档 创建和管理通知渠道。
2. 使用移动推送 SDK(1.1.5.4及以上的版本)创建通知渠道,详情请参见文档 创建通知渠道。
华为通知渠道使用
目前自定义渠道只能通过 Rest API 进行下发,控制台暂不支持,在您创建完成通知渠道后,可通过以下方式使用:
注意
如果您的应用在华为推送控制台申请开通华为推送服务时,选择的数据处理位置为中国区,自定义渠道功能将不再适用于您的应用。您的推送消息将按照智能分类系统或消息自分类权益确认的消息级别,归类为服务与通讯类或资讯营销类消息。详见 自定义通知渠道。
自定义渠道功能需要您的应用具有消息自分类权益,请参见上文进行申请。
推送示例如下:
{"audience_type": "token","token_list": ["005c28bf60e29f9a***2052ce96f43019a0b7"],"message_type": "notify","message": {"title": "华为通知消息","content": "测试内容","android": {"hw_ch_id": "华为通知消息的channel_id"}}}
荣耀消息分类使用指南
荣耀消息分类介绍
荣耀推送服务将根据应用类型、消息内容和消息发送场景,将推送消息分成服务通讯和资讯营销两大类别,资讯营销类消息的每日推送数量根据应用类型对推送数量进行上限管理,服务与通讯类消息每日推送数量不受限,详细说明请参见 荣耀推送数量管理细则。
根据消息分类,对不同类别消息的默认展示方式、推送数量限制、消息样式进行差异化管理,具体如下:
消息分类 | 提醒方式 |
类型说明
| 推送数量限制 | |
服务与通讯消息 | 锁屏展示+下拉通知栏展示,支持铃声、震动 | 无限制。 | | |
资讯营销消息 | 静默通知,仅在下拉通知栏展示 | 新闻类(需具备《互联网新闻信息服务许可证》) | 5条 | |
| | | 其他类 | 2条 |
警告:
importance 字段值为“1”时:表示消息为资讯营销类,默认展示方式为静默通知,仅在下拉通知栏展示。
importance 字段值为“2”时:表示消息为服务通讯类,默认展示方式为锁屏展示+下拉通知栏展示。
分类规则:
消息智能分类
智能算法将根据 App 类型和消息内容等维度,自动将您的消息按照分类标准进行归类。
消息自分类
允许开发者根据消息分类规范,自行对消息进行分类。
目前,所有消息默认通过消息自分类方式进行分类处理,荣耀推送服务将充分信任开发者提供的分类结果,并展示对应信息。随着荣耀推送服务能力的不断补充和演进,分类方式也会逐渐更新与升级,请参见 荣耀最新分类说明。
说明:
hw_importance 字段值为“1”时:表示消息为资讯营销类(限额),默认展示方式为静默通知,仅在下拉通知栏展示。
hw_importance 字段值为“2”时:表示消息为服务通讯类(无限额),默认展示方式为锁屏展示+下拉通知栏展示。
荣耀消息分类不需要另外申请,可直接使用。
荣耀自分类消息使用
自分类消息仅支持 API 进行下发,控制台暂不支持,可通过以下方式使用:
推送示例如下:
{"audience_type": "token","token_list": ["005c28bf60e29f9a***2052ce96f43019a0b7"],"message_type": "notify","message": {"title": "荣耀:","content": "自分类推送。","android": {"hw_importance":2}}}