JPush 产品简介

JPush 是经过考验的大规模 App 推送平台，每天推送消息数超过 5 亿条。开发者集成 SDK 后，可以通过调用 API 推送消息。同时，JPush 提供可视化的 web 端控制台发送通知，统计分析推送效果。JPush 全面支持 Android, iOS, Winphone 三大手机平台。

消息形式

JPush 提供四种消息形式：通知，自定义消息，富媒体和本地通知。

通知

或者说 Push Notification，即指在手机的通知栏（状态栏）上会显示的一条通知信息。通知主要用来达到提示用户的目的，应用于新闻内容、促销活动、产品信息、版本更新提醒、订单状态提醒等多种场景

开发者参考文档：Push API v3 notification

自定义消息

自定义消息不是通知，所以不会被 SDK 展示到通知栏上。其内容完全由开发者自己定义。自定义消息主要用于应用的内部业务逻辑。一条自定义消息推送过来，有可能没有任何界面显示。

开发者参考文档：Push API v3 message

富媒体

JPush 支持开发者发送图文并茂的通知，从而更好的传达信息，带来更丰富的用户互动。JPush 提供了 5 种模板，开发者可以通过填充模板的内容，发送 landing page、弹窗、信息流形式的富媒体通知。开发者还可以直接通过 URL 发送预先编辑好的页面。富媒体当前支持 Android 平台，为更好的使用富媒体的功能，建议更新当前 SDK 版本至 v2.1.8 及以上。暂时只能通过极光推送的控制台发送，不支持 API 形式。

Android 开发者参考文档：Rich Push 开发指南

本地通知

本地通知 API 不依赖于网络，无网条件下依旧可以触发；本地通知的定时时间是自发送时算起的，不受中间关机等操作的影响。本地通知与网络推送的通知是相互独立的，不受保留最近通知条数上限的限制。本地通知适用于在特定时间发出的通知，如一些 Todo 和闹钟类的应用，在每周、每月固定时间提醒用户回到应用查看任务。

Android 开发者参考文档：Android 本地通知iOS 开发者参考文档：iOS 本地通知

推送目标

通过使用标签，别名，Registration ID 和用户分群，开发者可以向特定的一个或多个用户推送消息。

标签

为安装了应用程序的用户打上标签，其目的主要是方便开发者根据标签，来批量下发 Push 消息。可为每个用户打多个标签。举例： game, old_page, women

别名

每个用户只能指定一个别名。同一个应用程序内，对不同的用户，建议取不同的别名。这样，尽可能根据别名来唯一确定用户。

Android 开发者参考文档：Android 标签和别名iOS 开发者参考文档：iOS 标签和别名使用别名和标签推送请参考文档：Push API v3 Audience

Registration ID

客户端初始化 JPush 成功后，JPush 服务端会分配一个 Registration ID，作为此设备的标识（同一个手机不同 App 的 Registration ID 是不同的）。开发者可以通过指定具体的 Registration ID 来进行对单一设备的推送。

用户分群

用户分群的筛选条件有：标签、地理位置、活跃用户、系统版本、智能标签。比如，开发者可以设置这样的用户分群：位于北京、上海、广州和深圳，并且最近 7 天内的活跃用户。开发者可以通过在控制台设置好用户分群之后，在控制台推送时指定该分群的名称或使用 API 调用该分群的 id 发送。

用户分群控制台使用指南：用户分群

统计分析

JPush 支持推送数量、用户打开次数、用户使用时长、新增用户、活跃用户等数据的统计。Android 开发者需要实现了相关的统计 API，才可以进行用户相关的统计。iOS 开发者不需要实现统计 API，可以直接在【控制台】-【统计】页面查看相关数据。

Android 开发者参考文档：统计分析 API

快速开始

  • 到极光推送官方网站注册开发者帐号；
  • 登录进入管理控制台，创建应用程序，得到 Appkey（SDK 与服务器端通过 Appkey 互相识别）；
  • 在推送设置中给 Android 设置包名、给 iOS 上传证书、启用 WinPhone，根据你的需求进行选择；
  • 下载 SDK 集成到 App 里。

技术支持

当出现问题时：

  • 请仔细阅读文档，查看是否有遗漏。 Android FAQ 、 iOS FAQ
  • 你可以到极光社区搜索类似问题

  • 给我们的 support 发邮件 support@jpush.cn
    为了更快速的解决问题，在寻求帮助时，请提供下列信息：

  • 你需要咨询的产品是 JPush，是否同时使用了极光其他的产品

  • 你所调用的是什么 API，所传参数，完整的报错信息，出现异常的时间点
  • 如果收不到消息，提供应用的 Appkey，消息的 Message ID，设备的 registration ID 信息
  • 如果是 SDK 问题请提供对应的 SDK 版本和完整的日志记录，日志信息请使用 TXT 文件上传
  • 出现异常的设备是 iOS 还是 Android，列出具体的机型和系统