常见名词介绍

常见名词介绍

1. ClientID

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

2. AppID

由IGetui管理页面生成,是您的应用与SDK通信的标识之一,每个应用都对应一个唯一的AppID

3. AppKey

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

4. Mastersecret

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

5. Appsecret

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

6. APNs

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

7. DeviceToken

对APNs来说,设备的64位标识符,同一个设备上不同的应用使用的DeviceToken是一致的。个推服务在客户端注册时将DeviceToken和ClientID绑定。从而保证Andorid和iOS推送上的一致性。

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

8. 透传消息

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

9. 透传消息类型

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

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

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

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

10. 累计注册

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

11. 日在线用户

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

12. 活跃用户

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

13. 在线下发率

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

14. 回执率

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

15. 到达率

到达数/实际下发数

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

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

17. 实际下发数

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

18. 到达数

  • Android客户端:客户端SDK接收到消息的Clientid数(通过统计客户端SDK接收到消息后的回执获得)
  • iOS客户端:应用在后台时,苹果那边没有开放客户端接收到消息的回执接口,所以无法统计到;应用在前台走个推通道的可以统计到。

19. 展示数

  • Android客户端:用通知栏模版(NotificationTemplate)推送的通知栏消息在用户手机展示过的Clientid数,(注:透传消息不统计展示数)
  • iOS客户端:iOS只建议推送透传消息(TransmissionTemplate),展示是要客户端自己处理的,如要统计,则需要用自定义事件来统计。

20. 点击数

  • Android客户端:点击通知栏消息的Clientid数(此通知栏消息是用的通知栏消息模版(NotificationTemplate)推送的消息),(注:透传消息不统计点击数)
  • iOS客户端:iOS只建议推送透传消息(TransmissionTemplate),点击是要客户端自己处理的,如要统计,则需要用自定义事件来统计。

21. 自定义事件

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

22. 回调地址

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

23. 标签

  • 标签是用户的一种属性,在给某些用户设置某类标签后就可以针对推送。比如给喜欢“足球”打上“足球”标签,就可以只给他们精准推送。
  • 可以在应用管理页面管理每个应用的标签,标签数量没有限制,单个ClientID可支持100个标签。
  • 标签的设定支持除逗号以外键盘上的所有字符。
  • 标签的设定,一定要在获取到Clientid之后才可以设定。标签的设定,服务端限制一天只能成功设置一次。

24.别名

  • 对已经安装某应用的用户取个别名来标识,在对该用户消息推送时,就可以用此别名来进行推送。
  • 每个用户一次只能指定一个别名。
  • 对于同一个应用不同的用户,建议取不同的别名。这样就可以根据别名来确定唯一一个用户。
  • 系统不限定一个别名只能指定一个用户,一个别名最多支持10个用户。如果一个别名被指定到了多个用户,当给指定的别名发消息时,会同时给这多个用户发送消息。
  • 别名名称:长度40字节,支持中、英文(区分大小写)、数字以及下划线。

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

通知
2017.12.18 iOS SDK 2.1.0.0

新增 SDK 离线状态返回。 优化 SDK 解决已知问题。

......
2017.08.17 Android SDK 2.11.1.0

增加 "绑定、解绑别名" 结果回调 修复 "设置标签" 在某些情况下失败问题 修复若干其他 bug【感谢快看小说的反馈及大力支持~】

......
2017.08.10 iOS SDK 2.0.0.0

新增支持一键解绑该别名下对应的所有用户。 优化 SDK 解决已知问题,以 Framework 形式提供 SDK 库。 扩展 SDK(GtExtensionSdk)新增资源释放接口,防止超时处理导致的问题。

......
2017.08.03 Android SDK 2.10.3.5

调整代码符合google审核规则 针对海外用户进行联网优化 bug修复

......
2017.07.13 PYTHON SDK 4.0.1.4

修改获取用户状态接口的返回值无法识别的问题

......

文档中心搜索