厂商通道使用教程
厂商通道是对自用通道长连接推送的有力补充,在应用强停状态下,消息可通过厂商通道触达用户,从而提高消息的到达率。移动APP推送后台所需的厂商通道信息如下。
厂商 | 所需信息 | 是否需要上架 | 备注 |
---|---|---|---|
小米 | AppID,AppKey,AppSecret | 是,需要注册企业开发者账号 | |
华为 | AppID, OAuth2.0 Client Secret | 否 | |
魅族 | AppID,AppKey,AppSecret | 否 | AppID长度为6 |
OPPO | AppID,AppKey,MasterSecret | 是,需要注册企业开发者账号 | 需要提供MasterSecret |
VIVO | AppID,AppKey,AppSecret | 是,需要注册企业开发者账号 | |
荣耀 | APPID,Client ID,Client Secret | 否,需要注册企业开发者账号 |
上述厂商所需信息需按照以下说明步骤收集,并在移动APP推送平台上配置。文档中标红部分请务必仔细阅读。客户端相关修改见文档《移动APP推送平台SDK集成指南》客户端集成步骤章节,客户端集成后可在平台查询设备信息页面查询到相关信息,便于判断是否集成成功。
如果查询设备信息没有类似红框里面的信息,说明客户端厂商通道集成存在问题。在初始化之前调用TH.tinvoke(100019, "setDebug", new Class[] { boolean.class }, true),打开慧推SDK的debug日志,进行调试,直到出现下图中的日志 【vendor: {x},status:true,code:0】。
厂商通道通知标题/通知内容长度限制
厂商 | 通知标题 | 通知内容 |
---|---|---|
小米 | 不允许全是空白字符, 长度小于50, 一个中英文字符均计算为1 | 不允许全是空白字符, 长度小于128, 一个中英文字符均计算为1 |
华为 | 消息体最大不能超过4096Bytes,不限制通知标题通知内容长度,过长部分会显示为“...” | |
魅族 | 字数限制1~32字符 | 字数限制1~100字符 |
VIVO | 最大20个汉字(一个汉字等于两个英文字符,即最大不超过40个英文字符) | 最大50个汉字(一个汉字等于两个英文字符,即最大不超过100个英文字符) |
OPPO | 字数限制1~50,中英文均以一个计算 | 字数限制200以内(兼容API文档以前定义,实际手机端通知栏消息只能展示50字数) |
厂商通道限量说明
具体参考 https://cloud.baidu.com/doc/SPP/s/0ld2v6hw5
小米Push通道使用教程
a) 创建应用
打开管理平台,点击右上角进入登录页面。进入登录界面后,输入账号、密码并点击登录后进入小米开放平台。
b) 正确创建应用后,会获得该应用对应的AppId, AppKey, AppSecret
c) 在测试小米通道推送消息时,应尽量避免使用“test”、“测试”等字眼,否则可能会被小米拦截进入“非重要消息”中 e) 小米厂商通道有限量说明,具体可参考小米官方文档
f) 小米平台FAQ 小米平台的具体使用问题,可参照小米平台FAQ或咨询客服
华为Push通道使用教程
a) 创建应用
打开华为Push管理平台 管理中心->应用服务->Push ,若未创建应用,则需按照要求填写相关信息进行申请。
b) 华为推送平台进行申请,开通第三方回执权限,需提供下列数据
URL回执接收地址 https://sofire.baidu.com/push/deliver/v1/callback/huawei
创建完毕后,可增加回执回调https备用证书。(该步骤非必须操作)
-----BEGIN CERTIFICATE-----
MIIEaTCCA1GgAwIBAgILBAAAAAABRE7wQkcwDQYJKoZIhvcNAQELBQAwVzELMAkG
A1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jv
b3QgQ0ExGzAZBgNVBAMTEkdsb2JhbFNpZ24gUm9vdCBDQTAeFw0xNDAyMjAxMDAw
MDBaFw0yNDAyMjAxMDAwMDBaMGYxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9i
YWxTaWduIG52LXNhMTwwOgYDVQQDEzNHbG9iYWxTaWduIE9yZ2FuaXphdGlvbiBW
YWxpZGF0aW9uIENBIC0gU0hBMjU2IC0gRzIwggEiMA0GCSqGSIb3DQEBAQUAA4IB
DwAwggEKAoIBAQDHDmw/I5N/zHClnSDDDlM/fsBOwphJykfVI+8DNIV0yKMCLkZc
C33JiJ1Pi/D4nGyMVTXbv/Kz6vvjVudKRtkTIso21ZvBqOOWQ5PyDLzm+ebomchj
SHh/VzZpGhkdWtHUfcKc1H/hgBKueuqI6lfYygoKOhJJomIZeg0k9zfrtHOSewUj
mxK1zusp36QUArkBpdSmnENkiN74fv7j9R7l/tyjqORmMdlMJekYuYlZCa7pnRxt
Nw9KHjUgKOKv1CGLAcRFrW4rY6uSa2EKTSDtc7p8zv4WtdufgPDWi2zZCHlKT3hl
2pK8vjX5s8T5J4BO/5ZS5gIg4Qdz6V0rvbLxAgMBAAGjggElMIIBITAOBgNVHQ8B
Af8EBAMCAQYwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNVHQ4EFgQUlt5h8b0cFilT
HMDMfTuDAEDmGnwwRwYDVR0gBEAwPjA8BgRVHSAAMDQwMgYIKwYBBQUHAgEWJmh0
dHBzOi8vd3d3Lmdsb2JhbHNpZ24uY29tL3JlcG9zaXRvcnkvMDMGA1UdHwQsMCow
KKAmoCSGImh0dHA6Ly9jcmwuZ2xvYmFsc2lnbi5uZXQvcm9vdC5jcmwwPQYIKwYB
BQUHAQEEMTAvMC0GCCsGAQUFBzABhiFodHRwOi8vb2NzcC5nbG9iYWxzaWduLmNv
bS9yb290cjEwHwYDVR0jBBgwFoAUYHtmGkUNl8qJUC99BM00qP/8/UswDQYJKoZI
hvcNAQELBQADggEBAEYq7l69rgFgNzERhnF0tkZJyBAW/i9iIxerH4f4gu3K3w4s
32R1juUYcqeMOovJrKV3UPfvnqTgoI8UV6MqX+x+bRDmuo2wCId2Dkyy2VG7EQLy
XN0cvfNVlg/UBsD84iOKJHDTu/B5GqdhcIOKrwbFINihY9Bsrk8y1658GEV1BSl3
30JAZGSGvip2CTFvHST0mdCF/vIhCPnG9vHQWe3WVjwIKANnuvD58ZAWR65n5ryA
SOlCdjSXVWkkDoPWoC209fN5ikkodBpBocLTJIg1MGCUF7ThBCIxPTsvFwayuJ2G
K1pp74P1S8SqtCr4fKGxhZSM9AyHDPSsQPhZSZg=
-----END CERTIFICATE-----
不添加回执不会影响消息发送,但推送到达的统计项缺失,无法准确统计消息的到达率。
c) 配置SHA256证书指纹
一般只要配置一个指纹即可,如果该应用存在多个证书指纹(如测试应用指纹),可以配置多个,配置有一定延迟,大约五分钟左右,无法立刻生效。没有正确配置指纹会导致设备初始化华为厂商通道失败,只能使用自有通道收发消息。
c) 获取OAuth2.0 Client Secret
华为 AppID、华为 OAuth2.0 Client Secret 获取方式如上图所示, 其中华为 OAuth2.0 Client Secret 作为 AppSecret 填写到慧推平台
e) 华为平台FAQ 华为平台的具体使用问题,可参照华为平台FAQ或咨询客服,点击了解
魅族Push通道使用教程
a) 应用创建若未创建应用,则需按照要求填写相关信息进行
b) 使用魅族厂商通道需配置回调地址,回调地址配置步骤如下
配置管理->回执管理
回执接收地址填写 ,点击新增 回执地址新增成功,在列表中可见,不配置回执会导致无法使用魅族厂商通道发送消息。
c) 使用魅族厂商通道需配置回调地址,回调地址配置步骤如下
d) 魅族厂商协议title限制32字符魅族推送通道通知标题不超过32字符,通知内容不超过100字符
e) 魅族平台FAQ 魅族平台的具体使用问题,可参照华为平台FAQ或咨询客服,点击了解
OPPO Push通道使用教程
a) 创建应用 OPPO厂商通道在使用前,必须先在OPPO开放平台申请开通PUSH服务,开通步骤如下 进入管理中心,点击 推送服务
点击新增进入详情页,点击移动服务
在未开通服务中点击需要申请push服务权限的应用,进入push服务并点击开通,oppo平台在一个工作日内返回申请结果,开发者可以在申请页面查看申请结果.
b) 发送OPPO厂商平台消息需要提供MasterSecret,具体位置见下图, 如找不到,辛苦参考官网文档 OPPO 官方文档
c) OPPO平台有通知内容审核,消息中不能用“test”、“1234”、“测试”等字样
d) oppo 手机默认不开启通知权限,请到手机设置里将对应应用的 "notify" 通知栏权限开启
e) OPPO 通道需要 OPPO 手机系统 ColorOS V3.1 及以上支持
f) OPPO 通道对应用的每日推送量有额度限制,详情请参见OPPO官方文档
g) 相同内容重复发送会被拦截,导致发送失败,测试阶段,请保证每次发送内容不同
h) OPPO平台FAQ OPPO平台的具体使用问题,可参照OPPO平台FAQ或咨询客服,点击了解
VIVO Push通道使用教程
a) 创建应用 创建正式推送前需先在开放平台创建您的应用。 开放平台首页-管理中心-应用与游戏
点击“应用与游戏”进入创建应用
b) 提交应用后在“消息推送”创建应用-应用详情点击“创建”
提交应用后,应用将会列入在应用名称里,点击“应用名称”选择要申请的应用再点击“提交申请”,平台将会在1-2个工作日内返回审核结果,开发者可在申请页面查看审核结果。
c) VIVO平台有通知内容审核,消息中不能用“test”、“1234”、“测试”等字样
d) VIVO 手机默认不开启通知权限,请到手机设置里将对应应用的 "notify" 通知栏权限开启(与OPPO类似)
e) VIVO厂商通道单用户每日可接收的消息为 五条 ,请测试阶段注意此事项
f) 为避免造成用户打扰,目前vivo手机接收的消息为7:00-23:00,服务器允许推送时间为7:00-23:00。
g) vivo 通道仅支持部分较新的机型和对应的系统及以上系统,详情请参见VIVO官网文档
h) 相同内容重复发送会被拦截,导致发送失败,测试阶段,请保证每次发送内容不同
i) VIVO平台FAQ VIVO平台的具体使用问题,可参照VIVO平台FAQ或咨询客服,点击了解
荣耀 Push通道使用教程
a) 注册荣耀开发者账号
开发者需要注册荣耀帐号并完成实名认证才能享受荣耀开放服务。具体注册地址为荣耀开发者服务台 ,注册荣耀开发者账号流程见注册流程注册流程。
b) 创建应用
创建正式推送前需先在开放平台创建您的应用,登录荣耀开发者服务台平台后进入【管理中心】页面。
点击【应用服务】-【推送服务】进入推送服务列表页面。
选择【申请推送服务】进入应用申请页面。
填写产品应用名称、包名和证书指纹等信息,同意推送服务协议和数据处理附录,点击“提交”按钮。
SHA256证书指纹需与自己的打包证书一致,如果该应用存在多个证书指纹(如测试应用指纹),可以配置多个,配置有一定延迟,大约五分钟左右,无法立刻生效。没有正确配置指纹会导致设备初始化荣耀厂商通道失败,只能使用自有通道收发消息。
c) 获取应用信息
应用创建后,在应用列表页,点击【查看】即可查看应用详情,获取必要信息 APPID、Client ID、Client Secret
在百度云移动推送服务【厂商通道】页面,填写参数:APPID 、Client ID 、Client Secret,选择“启用”。
d) 回执配置
URL回执接收地址 https://sofire.baidu.com/push/deliver/v1/callback/honor , 回执名称可自定义。
不添加回执不会影响消息发送,但推送到达的统计项缺失,无法准确统计消息的到达率。
e) 荣耀平台FAQ 荣耀平台的具体使用问题,可参照荣耀平台FAQ或咨询客服,点击了解