名词解释

名词解释

ClientID(简称CID)

个推业务层中的对外用户标识,用于标识客户端身份,由第三方客户端获取并保存到第三方服务端,是个推SDK的唯一识别号,简称CID。

标签

标签是用户的一种属性,在给某些用户设置某类标签后就可以针对推送。比如给喜欢“足球”打上“足球”标签,就可以只给他们精准推送。

  • 可以在应用管理页面管理每个应用的标签,标签数量没有限制,单个ClientID可支持100个标签。
  • 标签的设定支持除逗号以外键盘上的所有字符。
  • 标签的设定,一定要在获取到Clientid之后才可以设定。标签的设定,服务端限制一天只能成功设置一次。

别名

对已经安装某应用的用户取个别名来标识,在对该用户消息推送时,就可以用此别名来进行推送。

  • 每个用户一次只能指定一个别名。

  • 对于同一个应用不同的用户,建议取不同的别名。这样就可以根据别名来确定唯一一个用户。

  • 系统不限定一个别名只能指定一个用户,一个别名最多支持10个用户。如果一个别名被指定到了多个用户,当给指定的别名发消息时,会同时给这多个用户发送消息。

  • 别名名称:长度40字节,支持中、英文(区分大小写)、数字以及下划线。

    注:当ClientID已绑定了别名A,若调用此接口绑定别名B,则与别名A的绑定关系会自动解除;绑定与解绑定的接口一天内最多调用100次,两次调用的间隔需大于5s。

离线消息

当用户设备没有和个推服务器保持连接,推送消息会转为离线消息,在离线有效期内,用户设备重新和个推服务器保持连接,会收到此消息。

离线时间

即消息有效期,在此期间内,用户设备和个推服务器保持连接,会收到此消息。

AppID

在个推开发者中心创建应用时生成,是您的应用与SDK通信的标识之一,每个应用都对应一个唯一的AppID

AppKey

预先分配的第三方应用对应的Key,是您的应用与SDK通信的标识之一。

MasterSecret

个推服务端API鉴权码,用于验证调用方合法性。在调用个推服务端API时需要提供。(请妥善保管,避免通道被盗用)

AppSecret

第三方客户端个推集成鉴权码,用于验证第三方合法性。在客户端集成SDK时需要提供。

APNs

苹果官方推送通知服务,个推中iOS的离线通知均使用该服务。

DeviceToken

设备的64位标识符,用于APNs推送时区分设备和APP,iOS9及以后系统APP每次卸载重装后DeviceToken会发生变化,为了保证APNs推送正常使用,开发者在客户端注册时必须将DeviceToken和ClientID绑定。

苹果push证书

苹果推送服务需要使用的证书,分development版本和product版本。在提供个推该证书时,请确定是哪个版本的,如果该证书不一样会导致苹果推送无法正常工作。

透传消息

透传消息,即自定义消息,个推只负责消息传递,不做任何处理,客户端在接收到透传消息后需要自己去处理消息的展示方式或后续动作。

透传消息类型

透传消息类型,即setTransmissionType(),是消息模版里的一个参数,判断应用打开类型的。

包括1和2两种类型,1为强制打开应用,客户端SDK接收到消息后会立即启动客户端应用;2为等待客户端应用启动。

目前这两种类型的功能只支持Android,iOS不支持,所以iOS填写几都可以。

需要注意的是:如果群推时,Android和iOS都推送,就要写成2了,这样的话,Android客户端接收到消息后就不会直接启动应用。

累计注册

通过应用相应的appid统计用户注册总量。

日在线用户

通过应用相应的appid统计当天的在线用户数。

活跃用户

通过应用相应的appid统计当天在个推平台激活过的用户总数。

在线下发率

在线消息下发数/总下发数

回执率

消息回执数(去重)/消息在线下发数

到达率

到达数/实际下发数

百日内联网用户数(可推送用户数)

是指最近三个月内有登录过(Clientid与个推服务端建立长链接)的Clientid总数,即有效可下发的用户数。个推服务端规定clientid在100天内没有登录请求,认为该clientid已经失效(即卸载概率非常大),所以无需再次发送。

实际下发数

实际可推送Clientid数(在消息有效期内,有联网并推送进程正常的Clientid,即消息有效期内的在线下发数。消息有效期就是设置的离线时间)。

到达数

Android客户端:客户端SDK接收到消息的Clientid数(通过统计客户端SDK接收到消息后的回执获得)

iOS客户端:客户端SDK接收到消息的Clientid数(通过统计客户端SDK接收到消息后的回执获得)

展示数

Android客户端: 用通知栏模版(NotificationTemplate)推送的通知栏消息在用户手机展示过的Clientid数,(注:透传消息不统计展示数)

iOS客户端: 经APNs通道推送的通知栏消息在用户手机展示过的Clientid数,(注:经个推通道的透传消息不统计展示数)

点击数

Android客户端: 点击通知栏消息的Clientid数(此通知栏消息是用通知栏消息模版(NotificationTemplate)推送的消息),(注:透传消息不统计点击数)

iOS客户端:点击通知栏消息的Clientid数(此通知栏消息是设置过iOS通知样式(setAPNInfo)的透传消息),(注:经个推通道的透传消息和静默消息不统计点击数)

自定义事件

对于透传消息处理成的通知栏消息的点击事件统计、应用内部的某个事件统计(如点击某个按钮、跳转动作等)等,可以用自定义事件来统计,先定义好自定义事件的名称及编号,在需要埋点的地方调用对应方法来提交统计。

回调地址

即回调URL,在平台上设置填写后,用来处理客户端接收到消息的回执回调,个推服务端会把消息接收回执通过此URL来POST给客户,方便客户来统计消息接收回执。

角标(Badge)

角标为应用图标右上角用于提示未读消息条数的红色数字。

开发者中心 SDK 下载

文档中心搜索