推送服务接入指南
目录
- 小米推送
1.1.注册资料准备
1.2.认证操作流程
1.3.创建app
1.4.推送相关信息 - 华为推送
2.1.注册认证资料准备
2.2.认证资料流程
2.3.创建app
2.4.推送相关信息 - vivo推送
3.1.材料准备
3.2.注册认证流程
3.3.推送相关信息 - oppo推送
4.1.材料准备
4.2.注册认证流程
4.3.推送相关信息 - 魅族推送
5.1.注册认证材料准备
5.2.注册认证流程 - 极光推送
6.1.注册
6.2.认证
6.3.推送相关信息 - 信鸽推送
7.1.注册 - 推送渠道相关总括
小米推送
(文档地址:https://dev.mi.com/console/doc/detail?pId=848)
1.1 材料准备
个人开发者需提供 可接收验证码的手机号码、电子邮件地址、注册人本人手持身份证件照、未绑定小米支付银行借记卡(如认证为开发者账号的小米账号已同时绑定小米支付无需准备)
企业开发者需提供 手机号,邮箱地址,营业执照扫描件,未绑定小米支付银行借记卡(如开发者账号绑定的小米账号已被小米支付实名认证则无需准备)、如使用非企业域名邮箱注册需法人本人手持身份证件照
1.2 认证操作流程
个人开发者:
1.3.1 第一步,填写开发者名称。开发者名称会显示在应用信息中,用户可以根据开发者名称找到您开发的其他应用。(以下所有项目前有*标的都为必填项)
1.3.2 第二步,在详细资料页面完成联系人实名认证,并按要求上传身份证扫描件。
实名认证步骤:
- 联系人实名认证一项中,点击“添加银行卡认证”
- 点击“下一步”按钮
- 填写银行卡号,点击“下一步”按钮
- 输入银行卡对应信息
- 输入小米支付密码
- 输入短信验证码完成绑卡认证
- 已经实名认证成功页面,选择“联系人信息——联系人实名认证——查看详情”查看认证信息
注:实名认证目前仅支持绑定个人借记卡银行账户,暂不支持对公账户银行卡绑定。
企业开发者:
1.3.1 第一步,填写公司名称(可以是缩写. 简称)。
1.3.2 第二步,填写企业的相关信息,请点击“开始认证”跳转至企业管理员实名认证页面
1.3.3 第三步,使用手机扫码后进行企业管理员实名认证,成功后点击进入下一步,跳转至企业信息填写页面
1.3.4 第四步,填写相应的企业信息,完善后点击下一步系统会发送邮件和短信通知您已发起打款申请。通知发出后30分钟~3工作日内,将向您提供的银行账户打一笔小于1元的款项
1.3.5 第五步,在收到打款申请通知后的3个工作日内,请关注打款结果,收到打款后,登录小米开放平台进入“对公打款”输入打款金额并提交认证,系统审核后给出认证结果
1.3.6 第六步,完成实名认证后,填写联系人信息
1.3.7 第七步,选填相应的资质认证后,点击注册即可提交审核
1.3创建app
登陆小米开发者网站:https://dev.mi.com/console/,创建APP,获取AppId,AppSecret
1.4 推送相关信息
API推送限制:每次推送时,每一批推送的设备标识,和别名个数不能超过1000个。
推送消息回执:需要在运营后台配置回执的回调地址通知服务端。(具体回执包含的数据:未知,官方没明确给出)。
推送常见问题/运营平台使用说明(官方文档地址):https://dev.mi.com/console/doc/detail?pId=1292
华为推送
(文档地址:https://developer.huawei.com/consumer/cn/doc/20300)
2.1 注册认证资料
帐号类型 服务类型 所需资料
个人/企业 注册 可接收验证码的手机号码或电子邮件地址
个人 人工审核 1.身份证原件正反面扫描件
2.手持身份证正面照片
个人银行卡认证 个人银行卡号
企业 人工审核 1.营业执照原件扫描件
2.法人手持身份证正反面照片
打款认证 企业对公帐号
2.2 认证操作流程
个人开发者认证
2.2.1 第一步 在开发者实名认证页面,选择“个人开发者”,进入个人认证方式选择页面。
2.2.2 第二步 请根据上架应用的敏感性,选择认证方式
(1)如上架的是敏感应用,请选择“是”,点击“下一步”进入个人银行卡实名认证页面。(如需上架的应用是敏感应用,只能通过个人银行卡认证方式进行实名认证)
1. 完善银行卡信息,如您填写的信息正确,点击“下一步”跳转到完善信息页面。
2.完善个人信息,签署《华为开发者联盟与隐私的声明》和《华为开发者服务协议》,点击“提交”按钮,完成认证。(标有红色星号(*)的项目是必填项)
(2)如上架的是非敏感应用,请选择“否”,点击“下一步”进入实名认证方式选择页面。(如需上架的应用是非敏感应用,可选择个人银行卡认证或身份证人工审核认证的其中一种认证方式进行认证)
1.完善个人信息,签署《华为开发者联盟与隐私的声明》和《华为开发者服务协议》,点击“提交”按钮,等待审核,审核结果会在1-2个工作日发送至联系人邮箱。(标有红色星号(*)的项目是必填项)
企业开发者认证
2.2.1 第一步 在开发者实名认证页面,选择“企业开发者”,进入企业认证方式选择页面。
2.2.2 第二步 请根据上架应用的敏感性,选择认证方式
-
对公银行打款认证(敏感类应用)
-
完善企业信息,点击“下一步”,系统会发送邮件和短信通知您已发起打款申请。通知发出后30分钟~3工作日内,联盟尾号为0505的账户将向您提供的银行账户打一笔小于1元的款项。
-
在收到打款申请通知后的3个工作日内,收到打款后,登录开发者联盟进入“管理中心”输入打款金额并提交认证,系统审核后给出认证结果。
-
企业资料人工审核认证方式(非敏感类应用)
-
完善企业信息,点击“提交”按钮,等待审核,审核结果会在1-2个工作日发送至联系人邮箱。(标有红色星号(*)的项目是必填项
2.3 创建app
登陆华为开发者网站:https://developer.huawei.com/consumer/cn/,创建APP,获取AppId,AppSecret
2.4 推送相关信息
API推送限制:消息体最大不能超过4096Bytes(不包括token);最大Token数不能超过1000个;以及订阅的topic主题的Token列表,最大不能超过1000个。
推送消息回执:需要在运营后台配置回执的回调地址通知服务端。(具体回执包含的数据:未知,官方没明确给出)。
推送常见问题/运营平台使用说明(官方文档地址):https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/push-introduction
vivo推送
(文档地址:https://dev.vivo.com.cn/documentCenter/doc/281)
3.1 材料准备
企业开发者注册请准备以下资质(二选一):
(1)营业执照、组织机构代码证、税务登记证、法人手持身份证照片
(2)营业执照(三证合一)、法人手持身份证照片
3.2 注册认证操作流程
3.2.1 第一步 vivo开放平台(https://dev.vivo.com.cn/home)填写注册信息
3.2.2 第二步 填写账户资料,上传企业资质,提交审核
3.3 推送相关信息
API推送限制:regIds或者aliases的个数必须大于等于2,小于等于1000。
推送消息回执:需要在运营后台配置回执的回调地址通知服务端。(具体回执包含的数据:未知,官方没明确给出)。
推送常见问题/运营平台使用说明(官方文档地址):https://dev.vivo.com.cn/documentCenter/doc/156
oppo推送
(文档地址:https://open.oppomobile.com/wiki/doc#id=10446)
4.1 材料准备
手机号/企业邮箱,营业执照、营业执照注册号
4.2 注册认证操作流程
4.2.1 第一步 访问oppo开放平台(https://open.oppomobile.com/)填写注册信息
4.2.2 第二步 登录账号,选择认证主体类型
1)个人身份认证,根据页面上提示填写开发者信息并提交审核
2)企业身份认证,根据页面上提示填写开发者信息并提交审核
4.3 推送相关信息
API推送限制:registration_id与别名数最大不能超过1000个。
推送消息回执:没有回执消息同步。只能在运营后台中查看。
推送常见问题/运营平台使用说明(官方文档地址):https://open.oppomobile.com/wiki/doc#id=10198
魅族推送
(文档地址:http://open-wiki.flyme.cn/doc-wiki/index#id?8)
5.1 材料准备
个人:上传本人露脸手持身份证照片、身份证彩照正面、身份证彩照反面,填写正确的信息后提交,等待审核。
企业: 上传营业执照彩扫件(复印件盖公章彩扫)、法人身份证彩扫件(复印件盖公章彩扫)、联系人露脸手持身份证,填写正确的信息后提交,等待审核。
极光推送 (文档地址:https://docs.jiguang.cn//jpush/guideline/intro/)
6.1 注册
填写邮箱,手机号进行注册
6.2 认证
企业
个人
6.3 推送相关信息
API推送限制:如果要发广播(全部设备),则直接填写 “all”。极光将于 3 月 10 日对「广播推送」的频率进行限制,调整为 10 次每天。如果为批量单点推送,则registration_id设备标识。一次推送最多 1000 个。alias一个设备只能绑定一个别名,但多个设备可以绑定同一个别名一次推送最多 1000 个。
推送消息回执:需要在运营后台配置回执的回调地址通知服务端。(具体回执包含的数据:未知,官方没明确给出)。
推送常见问题/运营平台使用说明(官方文档地址):https://docs.jiguang.cn//jpush/guideline/intro/
信鸽推送
(文档地址:https://xg.qq.com/docs/)
6.1 注册
填写邮箱,手机号进行注册
8.推送渠道相关总括
小米 OPPO VIVO 华为 极光
标题字数 < 50 字符 1~50个字,中英文均以一个计算 最大20个汉字(一个汉字等于两个英文字符,即最大不超过40个英文字符) 同下内容字数描述 同下内容字数描述
子标题字数 ios10特性
不支持安卓 字数限制1~10,中英文均以一个计算 —— —— ——
内容字数 < 128 字符 字数限制200以内(兼容API文档以前定义,实际手机端通知栏消息只能展示50字数),长文本样式(style 为 2)限制128个以内,大图样式(style 为 3)字数限制50以内,中英文均以一个计算 最大50个汉字(一个汉字等于两个英文字符,即最大不超过100个英文字符) 消息体最大不能超过4096Bytes(不包括token) IOS:{}对象内(包括大括号)的总体长度不超过:3584 个字节最大3584 个字节。JPush 使用 utf-8 编码,所以一个汉字占用 3 个字节长度。
消息类型及数量限制 普通消息:MIUI在线数 * 2
系统消息:不限制
说明链接:https://dev.mi.com/console/doc/detail?pId=2086
消息类型 :运营类消息,系统类消息 发送条数限制:每天向某个设备上某个App最多可发送3000条,超过后会被限流24小时,一天内发送超过10万条会直接封禁推送权益,需要整改并申报整改方案重新申请push权益。
说明链接:https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides-V5/faq-0000001050042183-V5
四种消息形式:通知,自定义消息,富媒体和本地通知
是否有查询消息状态API 有
https://api.xmpush.xiaomi.com/v1/trace/message/status
https://api.xmpush.xiaomi.com/v1/trace/multi_message/status
有
可查消息统计信息 • id表示单条消息的id。
• resolved表示消息的计划送达数。
• raw_counter表示https原始请求目标数。
• invalid_target表示无效目标数(alias无效,、user_account无效等)。
• app_not_register表示app未注册push服务数量。
• device_condition_unmatch表示设备所处的环境不符合消息设置的条件(例如:网络环境不匹配, 地域不匹配, app版本不匹配, 机型不匹配等)。
• msg_send表示消息的实际下发数。
• delivered表示消息的送达数。
• delivery_rate表示送达率(送达数/有效设备数)。
• bar_closed表示屏蔽通知栏数。
• msg_display表示消息的展示数(送达数-屏蔽通知栏数)。
• click表示消息的点击数。
• click_rate表示消息的点击率(点击数/送达数)。
• create_time表示消息的发送时间。
• time_to_live表示消息的有效期。
• msg_type表示该消息发送的方式(msg_type分为Common、BatchRegId、Alias、BatchAlias、Topic)。 • jpush_received 极光通道用户送达数;包含普通Android用户的通知+自定义消息送达,iOS用户自定义消息送达;如果无此项数据则为 null。
• android_pns_sent Android厂商用户推送到厂商服务器成功数,计算方式同 Android厂商成功数;如果无此项数据则为 null。
• android_pns_received Android厂商用户推送达到设备数,计算方式以厂商回调数据为准;如果无此项数据则为 null。20200324新增指标
• ios_apns_sent iOS 通知推送到 APNs 成功。如果无此项数据则为 null。
• ios_apns_received iOS 通知送达到设备。如果无项数据则为 null。统计该项请参考 集成指南高级功能-通知送达统计 。
• ios_msg_received iOS 自定义消息送达数。如果无此项数据则为 null。
• wp_mpns_sent winphone通知送达。如果无此项数据则为 null。
• quickapp_jpush_received 快应用推送走极光通道送达设备成功的用户数量。
• quickapp_pns_sent 快应用推送走厂商通道请求成功的用户数量。
技术文档链接 https://dev.mi.com/console/doc/detail?pId=1558
https://open.oppomobile.com/wiki/doc#id=10688
https://dev.vivo.com.cn/documentCenter/doc/362#w1-05847321
https://developer.huawei.com/consumer/cn/doc/development/HMS-References/push-sendapi
https://docs.jiguang.cn//jpush/server/push/server_overview/