基本概念

术语

解释

通知

也叫通知栏消息。通知会自动在手机端弹出通知栏,用户可以打开或者清除通知栏。iOS的通知走APNs(苹果官方推送通知服务),Android与鸿蒙的通知走移动推送自己的通道或辅助通道。

消息

也叫透传消息、自定义消息。消息不会自动在通知栏弹出,客户端在接收到消息后,需要自己去处理消息的展示方式或后续动作。iOS,Android与鸿蒙的消息都走移动推送自己的通道。

设备ID(DeviceId)

设备在推送服务中的唯一标识,由SDK生成,32位数字和小写字母组合,通过代码获取。Android获取方法:CloudPushService的getDeviceld方法;iOS获取方法:CloudPushSDK的getDeviceld方法;HarmonyOS获取方法:aliyunPush.getDeviceId方法。

账号(Account)

给设备添加的账号,可以是任意您的业务需要的,一个设备只能添加一个账号,一个账号可添加多个设备。

别名(Alias)

给设备添加的别名,可以是任意您的业务需要的,一个设备可以最多添加128个别名,一个别名可以最多添加128个设备。

标签(Tag)

给设备添加的标签,可以是任意您的业务需要的,一个应用最多可有1万个标签,每个标签下可绑定的设备数没有限制。

按设备号推送

在客户端调用getDeviceld获得设备号,再通过控制台/OpenAPI门户/OpenAPI接口推送。

按账号推送

在客户端调用bindAccount操作,传参账号为您自己业务的账号(如您的app用手机号登录,可以用手机号来bindAccount),再通过控制台/OpenAPI门户/OpenAPI接口推送。

按别名推送

设备绑定别名后,根据业务逻辑筛选出别名进行消息推送。

按标签推送

设备绑定标签后,根据业务逻辑筛选出标签进行消息推送。

全量推送

也叫“全推”,指对全量设备进行推送。

消息离线缓存

可为消息推送设置缓存时间,离线设备只有在缓存过期前上线才能收到消息。

批量推送

把需要推送的多个推送请求组合为数组,通过请求批量推送接口进行推送,能有效降低请求QPS。

持续推送

在持续一段时间内复用同一个消息ID进行推送,使得这一批推送的结果能汇总到同一个消息ID中。

厂商通道推送

也叫辅助通道推送。手机系统厂商提供的系统级别的推送服务,在网络畅通和推送消息合法的情况下,通过厂商通道推送消息给该型号手机,不论应用是否存活,只要设备开机,都能推送到位。

自有通道

ACCS(Alibaba Cloud Channel Service,阿里云推送服务),阿里系基础推送通道。

受理成功数

受理成功的前提是请求发送的设备是有效的,具备发送消息的可能性;设备没有过期(默认Android设备需在90天内活跃过,iOS设备需在24个月内活跃过,超过这个时间的设备将无法推送);用户没有关闭推送功能。

受理成功数是除去原始请求发送目标过程中无法发送的设备之后的数。

实际送出数(实际下发数)

实际送出成功的消息数。对于自有通道来说,设备建连时就可以尝试下行消息到设备,下行的动作即称之为送出;对于厂商通道来说,消息成功发送到厂商服务端即送出。

到达数

也叫“送达数”,针对不同的设备,计算方式有所不同:

iOS设备:iOS通知是投递给苹果APNs服务器的,到达依据是只要苹果服务器没有返回错误信息,则认为送达。

Android与HarmonyOS设备:设备的到达数是自有通道和厂商通道送达数的统计值,各个通道均有送达的回执。

在线送达率

走在线通道到达数 / 走在线通道实际送出数。

送出率

实际送出数 / 受理成功数。

到达率

到达数 / 实际送出数。

AppKey

App在移动推送中的唯一标识。推送SDK初始化和调用OpenAPI推送时需要,从推送控制台APP列表页的应用证书中获取。

AppSecret

App的密钥。推送SDK初始化时需要,从推送控制台APP列表页的应用证书中获取。

DeviceToken

iOS设备在苹果中心注册时返回的64位设备标识符(iOS设备同时会有Deviceld和DeviceToken,请不要混淆)。

消息ID(MessageId)

标志一次推送的消息ID,基于OpenAPI接口推送时返回,或者在推送控制台查看。

多包名

预先针对各渠道添加包名,实现一次推送,全渠道包消息可达。