名词解释

ClientID（简称CID）

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

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

通知消息

指定通知标题和内容后，由个推SDK自动处理在系统通知栏中展示通知栏消息，同时响铃或震动提醒用户(响铃和震动受手机系统的设置状态影响)。

透传消息

即自定义消息，消息体格式客户可以自己定义，如纯文本、json串等。透传消息个推只传递数据，不做任何处理，客户端接收到透传消息后需要自己去做后续动作处理，如通知栏展示、弹框等。

标签

标签是用户的一种属性，用于描述用户的基础属性、兴趣爱好、行为特征等，在给某些用户设置某类标签后，就可以通过标签圈选具有共同特征的特定用户群，实现精准推送。比如给喜欢“足球”打上“足球”标签后，我们就可以通过圈选“足球”标签，给喜欢足球的用户，发送精准推送。

• 单个标签长度最大为32字节，单个ClientID标签总长度最大为512字节，单个ClientID最多设置100个标签。
• 两次调用标签接口的时间间隔需大于1s。
• 标签的设定支持除英文逗号和空格以外键盘上的所有字符。
• 标签的设定，一定要在获取到ClientID之后才可以设定。支持应用端和服务端调用接口实现标签的设定，设定成功后，可在个推开发者中心-配置管理-应用标签，查看应用的标签、导出各标签下的CID列表。
• 可在个推开发者中心-配置管理-应用标签，查看应用的标签、导出各标签下的CID列表。

别名

别名是APP为用户取的标识，该标识可以是APP业务层的用户标识，也可以是用户的昵称等。为用户绑定别名后，可以通过别名圈选目标用户组，方便APP运营同学快速、便捷地向特定的某群用户推送消息。

• 有效的别名组成：长度最长为40字节，支持中、英文（区分大小写）、数字、下划线。
• 服务端调用接口即可实现别名的绑定，一个CID只能绑定一个别名，重复绑定以最后一次为准，两次调用别名绑定接口的时间间隔需大于1s；一个别名最多可以绑定10个CID。
• 应用场景1：个推CID为32位，较长，运营同学发推送时不便获取、使用CID时，可通过别名圈选用户。
• 应用场景2：同一个设备上的同一个APP，只有1个CID，切换多个账号登陆时直接用CID发送推送，可能导致多个账号的推送信息串行，影响用户体验、泄露用户隐私；将账号设置为别名，并且切换账号时，需要解绑旧的账号，设置新的账号为别名，通过别名发送推送，就能确保收到推送的用户，即为当前登录的用户，避免消息串行。
• 应用场景3：同一个账号（比如手机号）分别登陆在 A、B、C 三台设备上的同一个 APP， 产生了 3 个不同的 CID, 想让这三台设备同时接收到推送，就可以考虑使用该接口，让三台设备的三个 CID都绑定同一个别名也就是你的账号（比如手机号），最多支持 10 台设备，也就是最多绑定 10 个 CID。

用户分组

APP可将特定某些用户添加至同一个用户分组，推送的时候，选择该用户分组，即可向该组内的所有用户推送消息。

• 可以通过个推开发者中心-消息推送-配置管理-用户分组，对用户分组进行管理，支持通过标签圈选用户分组。

• 应用场景：APP可能经常会向具有某几个标签特征的用户推送消息，通过标签圈选将这些用户添加至一个用户分组，每次推送的时候直接选择该用户组即可，无需再进行标签圈选。

消息有效时长

即未成功送达的消息，存在离线消息库、等待重发的有效时长，在此期间内，用户设备和个推服务器保持连接，会收到此消息。通常而言，设置消息有效时长，需要在消息内容时效性以及送达率这两者之间做评估取舍。

• 消息有效时长的设置：①在个推开发者中心创建推送的时候，在“推送设置”的“消息有效时长”处进行设置；②调用接口创建、推送消息时，在公共参数的推送条件，通过设置“ttl”参数，设置消息有效时长。

• 消息有效时长最长为72小时，如需扩展，可对接个推商务，升级为VIP客户扩展。

短信补量

在消息有效时间内，对未收到推送消息的用户进行短信补发，既提升了消息触达率又节省了成本。

• 应用场景：沉默用户唤醒、卸载用户召回、产品更新提醒、运营活动推广等。

广告投放

针对推送消息未触达的用户，使用广告投放的方式补发，提升用户点击数量，进一步提升DAU。

• 支持自主选择用户活跃状态（全部、近3天未活跃、近7天未活跃、近14天未活跃、近30天未活跃）和消息未触达类型（推送数量超限、关闭通知、参数超限等）。
• 应用场景：沉默用户唤醒、卸载用户召回、运营活动推广等。

通知渠道模板

用于设置通知在各个平台的提醒方式，可自定义设置响铃、震动、浮动、唤醒屏幕等提醒方式。

角标（Badge）

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

请求下发数

客户服务端请求发给个推的数量。

可下发数

本次推送任务中，个推认为有效的、可以下发消息的ClientID数，即有效的可下发用户数。

• CID无效判定规则：①ios: 一年不活跃认为CID无效；②安卓: 三个月不活跃认为CID无效。
• 设备长期没有登录请求，其卸载概率非常大，个推服务端定义该ClientID失效，不再进行消息下发。

成功下发数

本次推送任务中，由个推服务器实际下发到客户端的消息总数。包含个推通道成功下发量，和个推请求厂商通道、厂商通道返回成功的数量。

到达数

实际送达到客户端的数量。由客户端回执统计。

展示数

消息在用户通知栏展示的数量。

点击数

用户实际点击数量。

到达率

到达数/成功下发数

点击率

点击数/到达数

自定义事件

个推透传及部分厂商返回的推送报表数据不包含展示数和点击数。可通过自定义事件来统计，先定义好自定义事件的名称及编号，在需要埋点的地方，调用对应方法来提交统计，补全相应数据。也可用于应用内部的某个事件统计，如点击某个按钮、跳转动作等。

回调地址

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

累计注册用户数

历史累计，个推推送SDK与个推服务器建立过长链接的用户总数量。

日新增用户数

当日新增与个推服务器保持连接的用户数。

在线用户数（峰值）

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

日联网用户数

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

百日内联网用户数

是指最近三个月内有登录过（ClientID与个推服务端建立长链接）的ios和安卓的ClientID总数。安卓设备，个推服务端规定ClientID在100天内没有登录请求，认为该ClientID已经失效（即卸载概率非常大），则安卓的百日内联网用户数，即安卓的有效可下发的用户数。苹果设备，个推服务端规定ClientID 1年内没有登录请求，认为该ClientID已经失效。

次日留存率

当日新用户中，第二天有活跃的用户占比。

关闭通知率

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

卸载用户数

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

AppID

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

AppKey

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

AppSecret

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

MasterSecret

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

APNs

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

DeviceToken

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

苹果push证书

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