全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
移动推送

推送使用场景

更新时间:2017-06-07 13:26:11

  • 按设备号deviceId推送
  • 按账号account推送
  • 按别名alias推送
  • 按标签tag推送
  • 通知的各种应用场景
    • 打开应用
    • 打开指定activity
    • 打开指定网页
    • 自定义 key/value 说明
  • 查看设备状态
  • 查看推送效果

1、按设备号推送

  • deviceId是设备在推送系统的唯一标识,刚接入推送时,一般验证推送效果会采用这种推送方式,deviceId的说明和获取方式可参考deviceId、deviceToken的概念和区别

  • 在控制台推送的“高级设置”选择 “指定终端”,或者在OpenAPI中按照device推送:setTarget(“device”)。

2、按账户推送

  • 账户account的设定可参考SDK API文档中接口的相关描述;
  • 注: 按account推送的时候,绑定该account的手机都会收到推送。如有账号之间互斥登陆需要自己的业务来保证。
  • 在控制台推送的“高级设置”选择 “指定账号”,或者在OpenAPI中按照account推送:setTarget(“account”)。
  • :如需要解绑账号,调用unbindAccount方法。

3、按别名推送

  • alias是给设备添加的别名,相比于account,别名绑定更加灵活,同一设备最多添加128个别名,单个别名长度最大为128字节;
  • 具体接口描述和调用方式参考SDK API文档;
  • 别名绑定后,在OpenAPI中按alias推送:setTarget(“alias”),调用setTargetValue()指定别名即可;
  • 调用removeAlias()接口可以删除设备的指定别名或全部别名。

4、按标签推送

  • tag是给设备添加的标签,可以是任意您的业务需要的,支持向【设备】【账号】【别名】绑定标签,系统最大支持128个标签。
  • 具体接口描述和调用方式参考SDK API文档;
  • 绑定tag后,在Open API中按tag推送:setTarget(“tag”),调用setTargetValue()指定标签名即可。
  • :使用unbindTag接口可以解绑添加的标签,解绑标签不同于删除,目前不支持标签删除功能。

5、通知的各种应用场景

  • 打开应用
  • 打开指定activity
  • 打开指定网页
  • 自定义 key/value 说明

5.1 打开应用

  • 点击通知栏通知会打开定的App,如果App本来处在前台,不发生跳转动作;
  • OpenAPI设置如下:
    1. pushRequest.setAndroidOpenType("1"); // 点击通知后动作,1:打开应用 2: 打开应用Activity 3:打开 url

5.2 打开指定activity

  • 点击通知栏通知会跳转到对应的App的指定Activity中;
  • Activity名的设置为”包名 + Activity名”的格式,OpenAPI设置如下:
    1. pushRequest.setAndroidOpenType("2"); // 点击通知后动作,1:打开应用 2: 打开应用Activity 3:打开 url
    2. pushRequest.setAndroidActivity("com.alibaba.cloudpushdemo.bizactivity.DeviceActivity"); // 设定通知打开的activity

5.3 打开指定网页

  • 点击通知栏通知会调用手机系统的浏览器并打开指定的URL。
  • OpenAPI设置如下:
  1. pushRequest.setAndroidOpenType("3"); // 点击通知后动作,1:打开应用 2: 打开应用Activity 3:打开 url
  2. pushRequest.setAndroidOpenUrl("http://www.aliyun.com"); // Android收到推送后打开对应的url,仅当androidOpenType=3有效

5.4 自定义 key/value 说明

  • 以Android为例,通过OpenAPI发送通知的时候,设置androidExtParameters
  1. pushRequest.setAndroidExtParameters("{\"key\":\"value-muting\"}");//设定android类型设备通知的扩展属性
  • 在Android端重写通知相关的方法,获取extraMap参数
  1. import com.alibaba.sdk.android.push.MessageReceiver;
  2. protected void onNotification(Context context, String title, String summary, Map<String, String> extraMap) {}
  3. protected void onNotificationOpened(Context context, String title, String summary, String extraMap) {}

查看App的日志输出如:

  1. 02-29 15:33:11.412 32577-32577/com.alibaba.push2 E/MyMessageReceiver: onNotificationOpened, title: pop title, summary: pop body.., extraMap:{"key":"value-muting"}

6、查看设备状态

7、查看推送效果

  • 目前只提供消息ID维度的推送统计结果,入口:通知记录/消息记录 页面点击 统计

注:发送有问题请查看推送错误提示

本文导读目录