名词解释

名词解释

ClientID(简称CID)

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

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

通知消息

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

透传消息

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

标签

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

  • 单个标签长度最大为32字节,单个ClientID标签总长度最大为512字节,单个ClientID最多设置100个标签。
  • 两次调用标签接口的时间间隔需大于1s。
  • 标签的设定支持除英文逗号和空格以外键盘上的所有字符。
  • 标签的设定,一定要在获取到ClientID之后才可以设定。支持应用端和服务端调用接口实现标签的设定,设定成功后,可在个推开发者中心-配置管理-应用标签,查看应用的标签、导出各标签下的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版本。在提供个推该证书时,请确定是哪个版本的,如果该证书不一样会导致苹果推送无法正常工作。

开发者中心 SDK 下载

文档中心搜索

技术
咨询

微信扫一扫

随时联系技术支持

在线
咨询