名词解释

ClientID（简称CID）

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

目前消息问题排查，需要提供cid信息，建议可以获取到线上用户应用的cid信息，或者用户通过应用可以自己获取到。

标签

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

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

别名

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

• 绑定别名，后续可以使用该别名进行定向推送，重复绑定以最后一次为准，两次调用的间隔需大于 1s
• 可用于与客户账号系统关联，建议将邮箱、昵称、手机号等用户标识设为别名
• 使用场景：同一个账号（比如手机号）分别登陆在 A、B、C 三台设备上的同一个 APP， 产生了 3 个不同的 cid, 想让这三台设备同时接收到推送，就可以考虑使用该接口，让三台设备的三个 cid 都绑定同一个别名也就是你的账号（比如手机号），最多支持 10 台设备，也就是最多绑定 10 个 cid
• 别名名称：长度40字节，支持中、英文（区分大小写）、数字以及下划线。

离线消息

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

离线时间

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

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）

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

次日留存率

新用户在第二天的使用情况比例。

在线用户数（峰值）

当前与个推服务器保持连接的用户数的峰值，每10分钟统计一次。

日联网用户数

当日内个推推送SDK与个推服务器建立过长链接的用户总数量

关闭通知率

活跃用户中，通知栏消息提示关闭的用户数占比。

卸载用户数

每周卸载该应用的用户数（此处统计的为iOS用户的卸载数）。