App 通道对接指南

UMS 系统支持对接极光公有云推送和私有云推送,本文将对 UMS 对接 App Push 所需进行的操作一一说明,更具体的如 JPush 客户端 SDK 集成操作请阅读 JPush 文档

配置鉴权信息

登录极光官网,进入服务中心-开发者平台,创建一个应用后,在应用设置页面获取 Appkey 与 Master Secret,并配置到 UMS 的 App 通道信息中。

添加通道时需要设置通道编码,该编码在上传用户信息时将用到。 jpush_webjpush_web

如果是对接极光私有云推送,由于私有云服务器部署在企业内部,因此还需要填写 REST API 的请求地址,并需要企业对 UMS 系统开放访问该私有云系统的权限。

  • 若请求地址中的端口不是 80、443、25、465 这 4 个之一,需要联系商务说明端口

UMS 并不限制对接的 App 属于哪一个极光账号,任意极光账号下的 App 均可以对接。

配置回调地址

为了让 UMS 系统能检测到消息的送达、点击状态,需要企业在极光推送-推送设置-回执设置页面,配置送达与点击回执地址。

  • 送达回执地址:https://ums-callback.jiguang.cn/v1/app/callback
  • 点击回执地址:https://ums-callback.jiguang.cn/v1/app/callback

jpush_webjpush_web

如果是极光私有云,则需要在私有云服务器配置中对应设置,具体可联系您的私有云专属技术支持进行协助。

上传 registrationID

1、在集成极光 JPush SDK 成功后,App 将获得设备的唯一标识 registrationID,该值需要上传到 UMS 系统中与 userID 绑定,这样才能在使用 userID 推送时准确推送给具体的设备。

2、在集成 SDK 时配置的是哪一个 Appkey,则在上传 registrationID 信息时,填写的绑定标识 bind_id,即为配置了同一个 Appkey 的通道的通道编码。

3、假设在 UMS 创建通道时设置的通道编码为:app123,则上传信息至 UMS 平台的示例如下:

  • 在 UMS 控制台上点击文件上传,App 注册 ID 在 UMS 中的命名是:app_regid,Excel 内容参考: jpush_web
  • 调用 rest API 上传的 JSON 示例如下,详情请参考 rest API - 用户管理
[{
    "userid": "zhangsan",
    "set":{
        "app": {
            "app123": ["1104a89792bbb69299a","191e35f7e0fb16c7d45"]
        }
    }
}]

发送消息

配置成功后即可开始使用官网控制台发送消息,阅读控制台操作指南

还可以调用 API 进行发送,阅读 REST API 文档


Copyright 2011-2020, jiguang.cn, All Rights Reserved.
粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

Documentation built with MkDocs.