厂商通道限额&QPS说明

一、厂商推送限额说明

（一）、各厂商消息分类限额、提醒方式情况

1.1 场景描述

为了改善终端用户推送体验、营造良好可持续的通知生态，华为、荣耀、小米、OPPO、vivo各厂商的推送对推送消息分类进行管理。

厂商消息分类，是厂商为了帮助手机终端用户分辨重要消息和普通消息，优化用户对消息通知的体验而提供的解决方案。

在APP使用厂商通道推送的过程中，各厂商要求APP实现消息分类，并根据不同类型的消息进行差异化配置，例如配置不同的提醒方式、展示样式、推送额度等，以减少运营消息对用户的打扰，优化手机端用户的体验。

1.2 名词解释

各厂商通常将消息分为重要等级和普通等级，且不同厂商对消息分类的名称各有不同，比如重要消息一般分类为：重要、系统、私信、服务与通讯类，普通消息一般分类为：普通、运营、公信、营销资讯类。

APP开发者可根据自身应用的通知场景，将消息分为重要和普通消息两大类，以实现不同级别的消息推送。

华为

根据消息分类标准，华为推送服务将通知消息分为资讯营销、服务与通讯两大类别。

荣耀

根据消息分类标准，荣耀推送服务将通知消息分为资讯营销、服务与通讯两大类别

小米

根据《小米推送消息分类新规》，小米推送将消息分为“私信消息”和“公信消息”两个类别，若应用选择不接入私信或公信，则会接入默认通道。

oppo

OPPO PUSH新消息分类分为 内容与营销 和 通讯与服务 两类。

vivo

根据用户对推送内容的关注程度，划分为“系统消息”、“运营消息”两个消息类别。

二、厂商限额解决方案-消息分类实现

2.1 华为消息分类

（1）申请华为消息自分类权益功能。

消息分类标准以及自分类权益申请流程 https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-classification-0000001149358835 。

（2）服务端将华为服务端字段调整为申请审核成功的category，请在2023年3月31日前完成补充category的传值。

• category字段的传值可以查看 消息发送方案 https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-priority-0000001181716924 。
• 个推服务端接口设置华为自分类消息：https://docs.getui.com/getui/server/rest_v2/third_party/?id=doc-title-5

"options": { 
  "HW": { 
    "/message/android/category": "填写华为侧的category取值"
  } 
}

• 在平台上推送时配置消息分类参数，填写“扩展字段”参数如下：
  ”华为“ 、”/message/android/category”、”字符串“ 、”填写华为侧的category取值

（3）验证消息分类：推送华为离线消息，收到消息后左滑->设置->更多设置可以看出消息类型。

（4）常见问题

Q1：华为设置消息分类参数后后不生效原因

A：华为自分类权益申请成功后首次使用还需要激活下才生效

Q2：对单设备多发是否会返回错误码？若有返回码是在下发给服务器的时候就报错返回错误码？还是说通过抵达回执告知错误码？

A：多发不会返回错误，会通过回执码：256 返回告知，详细参考华为服务端消息回执 。

2.2 荣耀消息分类

（1）在荣耀平台，申请荣耀 消息自分类权益 功能。

（2）荣耀审核通过后，通过个推服务端接口设置【荣耀】消息分类 。

自分类权益生效后，应用的推送消息将根据 message.android.notification.importance 字段进行归类（未接入消息自分类的应用，消息通知类型将会默认归为资讯营销类消息）

• importance字段值为 LOW 时，表示消息为资讯营销类，默认展示方式为静默通知，仅在下拉通知栏展示。
• importance字段值为 NORMAL 时，表示消息为服务通讯类，默认展示方式为锁屏展示+下拉通知栏展示。

"options": {
  "HO": {
    "/android/notification/importance": "NORMAL" //importance字段值为LOW：资讯营销类消息 ;importance字段值为NORMAL：服务与通讯类消息
  } 
}

• 在平台上推送时配置消息分类参数，填写“扩展字段”参数如下：
  “荣耀” 、“/android/notification/importance”、“字符串” 、“NORMAL”

2.3 小米消息分类

（1）申请小米公私信渠道id https://dev.mi.com/console/doc/detail?pId=2422#_2

（2）个推服务端接口设置消息分类渠道id https://docs.getui.com/getui/server/rest_v2/third_party/?id=doc-title-12

"options": {
  "XM": {
    "/extra.channel_id": "填写小米平台申请的渠道id"
  }
}

• 在平台上推送时配置消息分类参数，填写“扩展字段”参数如下：
  “小米” 、“/extra.channel_id”、“字符串” 、“填写小米平台申请的渠道id”
  

2.4 OPPO消息分类

注意：新消息分类能力当前支持系统版本OS13及以上，后续会逐步向OS12及以下覆盖；请结合您应用的情况，去实现消息分类

2024 年 11月20日之前，新开启opush的应用可自主选择接入新消息分类方式或原有自建通道（旧消息分类）方式。建议实现新消息分类，并同时设置旧消息分类，来兼顾低版本用户的触达。
2024 年 11月20日开始，新开启opush的应用仅能使用新消息分类能力，OS13及以上 不再支持自建通道。必须实现新消息分类 ，建议也同时设置旧消息分类，来兼顾低版本用户的触达。

旧消息分类

（1）申请 OPPO PUSH 私信 通道权限。

注意：需要等 oppo 邮件答复私信模板审核结果通过后，申请的 oppo 私信通道才会生效

（2）客户端 创建私信通道 ，需要和申请的私信通道 channel_id 保持一致。

（3）调用 个推服务端接口 推送时，设置 OPPO 消息分类。

• 注意：OPPO 私信 消息仅支持调用单推接口。在平台页面推送的默认都是批量推接口，所以 不支持在平台页面推送。

"options": { 
  "OP": { 
    "/channel_id": "填写OPPO平台登记的渠道ID"
  }
}

新消息分类

（1）申请OPPO PUSH【通讯与服务】通道权限。

（2）调用 个推服务端接口 推送时，设置 OPPO 消息分类。

• 已经申请过旧消息分类的应用，使用了新消息分类能力时：建议同时填写category、notify_level 和 原有自建通道的 channel_id，来兼顾低版本用户的触达。
• notify_level：2、16 ，必须完成 4. 【通讯与服务】通道权限申请说明 后才能使用。

"options": { 
  "OP": { 
    "/channel_id": "填写OPPO平台登记的渠道ID",
    "/category": "填写Opush消息类别category",
    "/notify_level": 1 //通知栏消息提醒等级取值定义。1：通知栏，2：通知栏+锁屏，16：通知栏+锁屏+横幅+震动+铃声。使用notify_level参数时，category参数必传。
  }
}

（4）常见问题

Q1：对单设备多发是否会返回错误码？若有返回码是在下发给服务器的时候就报错返回错误码？还是说通过抵达回执告知错误码？

A：多发不会返回错误，也不会通过回执返回，服务器会在推送时直接过滤掉且不占公信额度，请开发者按照规则推送

Q2：单用户限额更新频率

A：每日

Q3：是否影响应用推送总量？

A：不影响应用日推送总量

Q4：是否有缓冲期限？

A：暂无

Q5：付费的增长PUSH是否受影响？

A：不受影响

2.5 vivo消息分类

（1）vivo推送服务允许开发者根据vivo推送消息分类规范，自行对消息进行分类，不需要进行申请权限。新的消息分类于2023年4月3日起 开始生效。由于vivo侧会定期巡查消息内容，请按照分类标准发送消息；

（2）vivo增加二级分类category字段，并根据不同二级分类配置不同推送速度，请您尽快确认好category场景并在在6月30日前完成传值。具体请参考《推送消息分类说明》

（3）个推服务端接口设置消息分类为系统消息类型 https://docs.getui.com/getui/server/rest_v2/third_party/?id=doc-title-28

"options": {
  "VV": {
    "/category":"填写对应的ID" //二级分类
  }
}

• 在平台上推送时配置消息分类参数，填写“扩展字段”参数如下：
  “vivo” 、“/category”、“字符串” 、“填写vivo侧对应的category值”
  
  （4）常见问题

Q1：对单设备多发是否会返回错误码？若有返回码是在下发给服务器的时候就报错返回错误码？还是说通过抵达回执告知错误码？

A：多发不会返回错误，会通过子回执码：12000 返回告知，详细参考vivo服务端消息回执 。

三、厂商QPS限制说明

华为平台限制

• 发送速率（QPS）= App 在华为渠道 MAU x 应用类别权重系数 x 0.00072 ；具体请参考 华为侧QPS说明
• 如您的应用通过QPS公式计算所得的值不足6000，将执行默认6000的QPS；同时，全网流量较高时，也会出现系统级流控（流控对应的状态码为HTTP 503）
• 提升途径：可以联系华为官方进行调整 QPS，申请邮件：hwpush@huawei.com

名词解释

• MAU：在华为渠道推送应用的每月最后一个自然日的值作为当月的 MAU。
• 分类规则：依据在华为应用市场上架的应用分类。

荣耀平台限制

• 推送速率限制：单应用QPS统一限制为3000

• 建议应用：

  1）降低并发请求量，将每秒请求数控制在QPS配额内。

  2）优化发送效率，在一次请求中携带更多token。

• QPS（Quantity per second）：每秒推送请求数。每次请求最多可携带1000个token。

小米平台限制

• 小米推送对推送速率（QPS）的分配主要依据 App 的 MIUI 日联网设备数进行分级计算。
• QPS：表示1秒可调用的请求数。1个请求里最多可以携带1000个目标设备。例如：3000 QPS时，1秒内最多可推送300万设备。
• 提升途径：暂不开放申请。
• 不同量级的MIUI日联网设备数分配不同的QPS：

OPPO平台限制

• 限制规则 OPPO推送对QPS的分配主要依据应用的累计用户数，应用类别权重和平台推送系数三个值进行加权计算。具体请参考OPPO侧QPS说明
• 累计用户数 在OPUSH平台上的查询路径是OPPO PUSH推送运营平台—我要推送消息—应用列表中的累计用户数。
• 计算公式
  应用QPS = 推送QPS参考值 应用类别权重 平台推送系数
  例如：针对应用维度，30000 QPS表示1秒内本应用最多可推送给30000个用户（所有接口共享应用维度限速上限总值）。
  具体的QPS对应值如下：

备注：QPS(Quantity per second)表示1秒可调用OPPO PUSH的请求数。

• 提升途径：暂不开放申请。

魅族平台限制

• 默认 App 是 500 条/秒
• 提升途径：可以联系魅族官方进行调整 QPS，申请邮件：push_support@meizu.com

VIVO平台限制

vivo推送QPS根据通知开启的有效用户数自动调整，默认最低3000/秒，最高5000/秒。
QPS定义：表示1秒可发送的推送消息数。例如：3000 QPS时，1秒内最多可推送3000条消息。

• 通知开启的有效用户数：0-500W；推送速度： 3000/秒 ；
• 通知开启的有效用户数：500W-800W；推送速度：4000/秒；
• 通知开启的有效用户数：800W以上；推送速度：5000/秒。

FCM平台限制

• 连接到 FCM XMPP 服务器的速率限制为400次/分钟，FCM 允许存在 2500 个并行连接。
• 提升途径：暂不开放申请。