极光消息推送查看审核记录操作教程

前提条件

在【推送设置】-【安全管理】页面，已经启用了推送审核功能。

审核记录说明

审核人员进入【消息推送】-【推送审核】-【审核记录】页面，可以查看所有状态的审核记录。

待审核数量：表示全部“待审核”状态的消息总量，是否有消息没被审核，可以根据此数量判断。

• 待审核：需要被审核的推送。
• 审核通过：判定为满足下发条件的推送。
• 审核不通过：判定为不满足下发条件的推送。
• 已撤销：创建者已经撤销的推送。
• 已过期：已经过了定时发送时间的推送。

审核通过

在待审核列表中选择满足下发条件的推送，点击“审核通过”，该推送将会正常下发。 

审核不通过

在待审核列表中选择不满足下发条件的推送，点击“审核不通过”，并填写原因，该推送不会下发。


切换至“审核不通过”列表，点击推送记录可以查看审核结果。

极光消息推送查看被审记录操作教程

前提条件

在【推送设置】-【安全管理】页面，已经启用了推送审核功能。

被审记录说明

创建推送后，进入【消息推送】-【推送审核】-【被审记录】页面，可以查看所有状态的被审记录。

• 待审核：需要审核人员审核的推送。
• 审核通过：被审核人员判定为满足下发条件的推送。
• 审核不通过：被审核人员判定为不满足下发条件的推送。
• 已撤销：创建者已经撤销的推送。
• 已过期：已经过了定时发送时间的推送。

撤销待审核推送

在待审核列表中选择需要撤销的推送，点击“撤销”，经过二次确认后即可撤销该被审记录，审核人员的待审核列表这条记录也会被删除。

极光消息推送定时任务操作教程

本文旨在指导用户如何在极光控制台上查看通知消息、自定义消息、A/B 测试的定时任务。

通知消息/自定义消息

在【推送管理】-【创建推送】-【通知消息/自定义消息】页面创建一个定时推送后，进入【定时任务】页面点击“通知消息”、“自定义消息”可以查看对应类型的定时任务记录。

编辑

在预定发送时间之前，点击“编辑”即可对已经创建的“定时任务”进行修改。

转发

在预定发送时间之前，点击“转发”即可复用指定“定时任务”的参数，快速新增一个新的“定时任务”。

此操作会产生新的“定时任务”！

A/B 测试记录

在【推送管理】-【创建推送】-【A/B 测试】页面创建一个定时推送后，进入【定时任务】页面点击“A/B 测试记录”即可查看定时任务记录。

查看

在预定发送时间之前，点击“查看”，可以查看测试报告和消息详情。

测试报告

消息详情

删除

在预定发送时间之前，点击“删除”，二次确认后即可删除该条 A/B 测试记录。

极光消息推送创建推送操作教程

本文旨在指导用户如何在极光控制台上创建通知消息、自定义消息、富媒体消息、A/B 测试等推送任务。

创建通知消息

进入【消息推送】-【推送管理】-【创建推送】-【通知消息】页面创建推送任务，参数配置说明如下：

基础设置

• 目标平台：根据集成 SDK 的平台，选择需要推送的平台。
  • 选择平台前需在【推送设置】中设置对应的平台。
  • 子账号仅支持选择主账号授权的平台。
• 通知标题：推送消息的标题，请尽量避免“test、测试、纯数字” 等无意义内容，否则可能会被厂商拦截而无法接收到通知消息。
• 通知内容：推送消息的内容，请尽量避免“test、测试、纯数字” 等无意义内容，否则可能会被厂商拦截而无法接收到通知消息。
• 发送时间：选择需要发送的时间
  • 立即：立即下发消息。
  • 定时：发送时间只能设置当前时间 3 分钟以后的时间，并且定时任务不能超过一年。
• 定速推送：在设定时间内完成推送，降低服务器压力。
• 点击打开通知：点击通知后的动作，详情参考 Android 通知点击跳转。 

高级设置

• 离线消息保留时长：可以通过该值指定离线消息的时长。如果该用户当前不在线，则会保存为离线消息，待该用户下次上线时继续推送给他。即在该时长范围内用户上线会继续收到推送，否则过期。
  • 默认时长为 1 天。
  • 设置为 0，则表示不保留离线消息，即只有当前在线的用户才可以收到，所有不在线的都不会收到。
• 地理围栏：自由圈定地理区域、商圈，针对区域内人群进行精准推送。
• 附加字段：客户端获取附加字段内容，用于自定义事件处理。
• 应用内提醒：对应用通知权限被关闭而无法触达的用户，使用应用内消息进行触达。Android SDK ≥3.9.0、iOS SDK ≥3.4.0 方可支持此功能。

Android

• 厂商通道状态：完成了对应的厂商通道集成和配置后，对应通道的厂商通道状态会高亮。
• 通知下发策略：可以指定厂商通道和极光通道的优先下发策略，选择厂商策略时，需确保厂商通道已配置成功，详情参考 通知下发策略文档。
• 厂商配额策略：此策略仅表示是否忽略和跳过极光系统侧的配额判断及扣除逻辑，实际依旧遵循和受厂商相关配额机制约束。目前仅对小米、OPPO 厂商有效；小米通知消息、OPPO 私信可选择“忽略”，其它类型推送消息建议“不忽略”。
• 通知栏样式：不同于 JPush SDK 内置的通知栏样式，这里的通知栏样式是用系统 api 来构建的三种常用样式，详情点击“？”查看说明。在 JPush Android SDK 3.0.1 及以后版本支持。
  • 自定义通知栏样式：在客户端可设置多套样式指定不同的编号，服务器端推送时指定编号就可以展现时使用之前设置的样式。这个值默认值为 0，即使用默认的样式。通知栏样式的定义参考 自定义通知栏样式 文档。
• 通知栏图标：通知栏右侧图标。
  • 默认 logo：通知栏展示应用默认的图标。
  • 指定图标路径：通知栏展示指定路径的图标。图片可以为 http 或 https 开头的网络资源，或 drawable 资源文件夹路径。
  • 上传图标：通知栏展示上传的图标。
• 通知消息模版：可以设置通知的提醒优先级，避免频繁打扰客户。默认选择“常规提醒模板”，模板包含模板名称、渠道名称、渠道 ID、通知优先级、通知类别、通知提醒类型、提示音设置。
  • 常规提醒模板：通知优先级为 “PRIORITY_DEFAULT”，通知提醒类型为“提示音 | 震动 | 指示灯”。
  • 无感知提醒模板：通知优先级为 “PRIORITY_LOW”，通知提醒类型为“指示灯”。
  • 强提醒模板：通知优先级为 “PRIORITY_HIGH”，通知提醒类型为“提示音 | 震动 | 指示灯”。
  • 点击“新建消息提醒模板”可以自定义提醒模板。
    • channel_id：针对 Android 8.0 及之后系统通知渠道特性功能，推送需要指定通知渠道 ID。
    • 通知优先级：该优先级仅对极光通道生效，默认的 priority 属性设置为 PRIORITY_DEFAULT，官方描述见 开发者文档。在 JPush Android SDK 3.0.1 及以后版本生效。
    • 通知类别：系统可能会用通知的 category 属性来做在通知栏的排序或者过滤。在 JPush Android SDK 3.0.1 及以后版本生效，官方描述见 开发者文档。
    • 通知提醒类型：开发者可勾选对应的项来指定通知送达时在手机上的提醒类型，但不能越过系统的限制，比如手机的声音要是开着的，振动是允许的，有 LED 指示灯并且是可开启的状态。在 JPush Android SDK 3.0.3 及以后版本生效。
• 角标数字：应用图标右上角的角标，详情参考 数字角标相关说明。
  • 此属性目前仅针对华为 EMUI 8.0 及以上、小米 MIUI 6 及以上设备生效，在 JPush Android SDK 3.3.6 及以后版本支持。
  • 此字段如果不填，表示不改变角标数字（小米设备由于系统控制，不论推送走极光通道下发还是厂商通道下发，即使不传递依旧是默认 +1 的效果。）；否则下一条通知栏消息配置的 badge_add_num 数据会和之前角标数量进行增加。建议 badge_add_num 配置为 1；举例：badge_add_num 配置 1，应用之前角标数为 2，发送此角标消息后，应用角标数显示为 3。
    

iOS

• silent_push：content-available: 1，不携带任何 badge，sound 和消息内容等参数，可以在不打扰用户的情况下进行内容更新等操作，参考“Silent Remote Notifications”。
• 通知子标题：该字段仅针对 iOS 10 以上的系统版本。Android 平台和 iOS 其他系统版本不受该字段内容影响。
• content-available（推送唤醒）：iOS 7 开始新增特性，此处开启说明是 Background Remote Notification，如果不启用则是普通的 Remote Notification。详情参考：Background Remote Notification”。
• mutable-content：iOS 10 开始新增的特性功能，此处开启说明支持 iOS 10 的 UNNotificationServiceExtension 特性，如果不开启则是普通的 Remote Notification。详情参考：UNNotificationServiceExtension”。
• collapse id：通知携带 collapse id 参数，将会覆盖掉通知中心里携带相同 collapse id 的通知。collapse id 的值不可超过 64 bytes , 该字段详细介绍参考 APNs Guide。
• 通知消息模版：可以设置通知的提醒优先级，避免频繁打扰客户。默认选择“常规提醒模板”，模板包含模板名称、通知类型、sound、volume、critical、category、thread-id、interruption-level。
  • 常规提醒模板：通知类型为“通知类型”，sound 为 “默认通知”，interruption-level 为 “active”。
  • 无感知提醒模板：通知类型为“通知类型”，sound 为 “无声”，interruption-level 为 “passive”。
  • 点击“新建消息提醒模板”可以自定义提醒模板。
    • 普通通知：通过 sound 字段指定声音。默认为 default，即系统默认声音。 如果设置为空值，则为静音。如果设置为特殊的名称，则需要你的 App 里配置了该声音才可以正常。
    • 告警通知：需要推送告警通知的应用需要前往 Apple 开发者官网 申请权限。
    • category：iOS 分类，只有 iOS 8 及以上系统才支持此参数推送。
    • thread-id：用于对通知分组的特定于应用的标识符，同一个 thread-id 的通知归为一组。
    • interruption-level：用于定义通知优先级和交付时间的中断级别，详情查看 interruption-level 字段。
• badge: 可指定 APNs 推送通知的 badge，直接展示在桌面应用图标的右上角，含义是应用未读的消息数，也可以进行角标 +N/-N，例：接受者 A，B 的角标分别为 1 和 2，那么推送 +2 后 A 的角标变为 3，B 的角标变为 4。系统默认值为 1。详情参考 数字角标相关说明。
  

目标人群

选择目标：需要推送的目标人群，测试时建议使用注册日志中获取的 registrationID 进行推送。

• tag：一次推送最多 20 个。
• alias：一次推送最多 1000 个。
• registrationID：一次推送最多 1000 个。

发送预览

配置推送参数后，点击发送预览，可以查看配置的推送参数和预估推送人数。

确认预估人数 >0，点击确认即可成功创建推送任务。

若预估人数为 0，推送无法发送，并会返回以下错误：

创建自定义消息

进入【消息推送】-【推送管理】-【创建推送】-【自定义消息】页面创建推送任务，参数配置说明参考 创建通知消息。

创建富媒体消息（模版）

选择模版

进入【消息推送】-【推送管理】-【创建推送】-【富媒体消息 – 模版】页面，目前支持 5 种模版：启动页 – 全屏式模板、信息流 – 多图文模板、信息流 – 单图文模板、弹窗 – 单图模板、弹窗 – 图文模板，选择其中一个模版。

填写模版

这里以“弹窗 – 图文模版”为例，填写标题、上传图片、编辑链接即可点击“下一步”。

设置推送内容

• 进入消息编辑页面，可以参照 创建通知消息 模块进行参数设置。
• 点击右侧预览富媒体可以预览该富媒体推送。

创建富媒体消息（URL）

选择模版

进入【消息推送】-【推送管理】-【创建推送】-【富媒体消息 -URL】页面，填写 URL 并选择页面去向。

设置推送内容

进入消息编辑页面，可以参照 创建通知消息 模块进行参数设置。

创建 A/B 测试

A/B 测试设置

设置目标平台、用户比例、发送时间等参数，参数配置说明参考 创建通知消息。

用户比例：设置的用户比例为满足上述条件用户的百分比。

• A、 B 两组参与测试的用户比例相等。
• 例如用户比例为 40%，则 A、B 两组的用户比例分别为 20%。若目标平台为 iOS 和 Android，以 A 组为例，A 组中参与测试的 iOS 用户占 iOS 平台用户的 20%，A 组中参与测试的 Android 用户占 Android 平台用户的 20%。

设置通知内容

点击“下一步”，进入通知内容编辑页面，参数配置说明参考 创建通知消息。

选择目标人群

推送目标至少为 2 人，若参与 A/B Test 的目标人数小于 2 人，推送将失败。

计算人数的最终结果取整数，舍弃小数。

极光消息推送富媒体推送统计查看教程

富媒体说明

为了更好的传达信息，带来更丰富的用户互动，JPush 支持开发者发送图文并茂的通知。目前提供了模板和 URL 的方式发送富媒体消息，使用详情参考富媒体消息推送。

统计说明

进入【消息推送】-【统计分析】-【富媒体推送统计】页面，可以查看富媒体推送的趋势图数据和详细数据。

• 富媒体推送数量：Android 用户实际收到富媒体推送的数量合计。
• 富媒体用户点击数：用户通过点击通知栏消息进入应用的次数。

导出数据

可以点击右侧“导出”下载详细数据。

极光消息推送查看推送统计

本文旨在介绍推送统计的各个统计页面，方便用户快速查询统计数据。

数据概况

进入【消息推送】-【统计分析】-【推送统计】-【数据概况】页面，可以查看该应用的实时数据、昨日概况、转化趋势和折损原因分析。

实时数据

实时数据以小时为纬度展示当天的推送总体情况，可以分别点击有效目标数、发送数量、送达数量、展示数量和点击数量查看对应的趋势图。

• 有效目标数：将推送任务所选定的目标人群，经过有效性筛选后的目标设备数量。
• 发送数量：有效目标设备中，极光服务器实际成功创建了发送任务的设备数量。
• 送达数量：通过极光通道、厂商通道下发，设备终端实际收到通知消息的回执数量，5天之后的送达数量不被计算在内，厂商送达参考 厂商通道回执配置指南。
• 展示数量：通知消息送达设备终端后，在设备终端成功展示的回执数量，5天之后的展示数量不被计算在内。
• 点击数量：通知消息成功展示后，点击通知消息的用户回执数量，5天之后的点击数量不被计算在内。

昨日概况

昨日概况展示推送转化漏斗和通知权限状态分布，方便用户了解昨日推送总体的转化。

转化趋势

转化趋势可以查看选定周期内的送达率、展示率、点击率的趋势图，方便用户根据数据做运营推送调整。

• 送达率：该时间段内产生的发送任务，送达总量/发送总量。
• 展示率：该时间段内产生的发送任务，展示总量/送达总量。
• 点击率：该时间段内产生的发送任务，点击总量/送达总量。

折损原因分析

折损原因可以分平台查看各个阶段的折损的具体原因，帮助用户快速定位原因，及时调整推送参数和推送目标等，提高转化率。

消息推送统计

进入【消息推送】-【统计分析】-【推送统计】-【消息推送统计】页面，可以查看选定周期内的推送趋势。

点击“?”可以查看详细数据说明。

推送用户统计

进入【消息推送】-【统计分析】-【推送统计】-【推送用户统计】页面，可以查看选定周期内的推送用户的趋势和详细数据。

• 推送新增用户：新注册的 jpush sdk 用户。
• 在线用户：Jpush SDK 与 jpush server 建立网络连接成功的用户（不区分前台后）。
• 活跃用户：应用在设备前台运行过的用户。
• 关闭通知用户：关闭本应用通知权限的用户。
• 卸载用户：极光监测到卸载本应用的用户，无法区分渠道和 APP 版本。

通知权限统计

进入【消息推送】-【统计分析】-【推送统计】-【通知权限统计】页面，可以查看选定周期内的通知启用趋势和详细数据。

• 通知开启：本应用通知权限状态为开启的用户总数。
• 通知关闭：本应用通知权限状态为关闭的用户总数。
• 新增开启：新开启本应用通知权限的用户。
• 新增关闭：新关闭本应用通知权限的用户。

API 调用统计

进入【消息推送】-【统计分析】-【推送统计】-【API 调用统计】页面，可以查看选定周期内的 API 调用趋势和详细数据。

• API 调用次数：统计时长内调用 Push API 的总次数。
• API 次数不同于消息数，一次广播推送与一次别名推送均为1次 API 调用。

极光消息推送快速排查问题教程

本文主要引导用户在推送收不到时，可以通过推送记录、排查工具等工具快速地进行问题排查。

推送记录

推送收不到时，查看推送记录的消息是否有正常下发，如果推送状态为“推送失败”，点击消息查看对应的错误信息，根据报错信息修改后再重新下发。

排查工具

消息查询

推送收不到时，可以进入【极光控制台】-【消息推送】-【配置管理】-【排查工具】-【消息查询】页面进行生命周期排查，输入 Message ID 和 Registration ID，点击查询即可查看消息的生命周期，查询结果如下图：

• 消息生命周期：如果发送失败，会在相应的失败环节展示错误码+错误提示信息。
• 特殊消息生命周期：如果消息类型为通知消息+自定义消息，则消息生命周期会产生两条分叉路径。
• 消息基本信息：展示消息类型、发送策略和消息体，点击消息体可以查看消息体 json。
• 设备基本信息：展示通知权限开关状态、厂商注册情况、最近在线时间等设备基本信息。

Message ID 获取方法

• 进入【极光控制台】-【消息推送】-【推送管理】-【推送记录】页面，即可获取 Message ID。 
• API 调用后在应答参数中获取 ​：

          {
    "sendno": "0",
    "msg_id": "54043471036732219"
}

        

Registration ID 获取方法

客户端初始化 JPush 成功后，JPush 服务端会分配一个 Registration ID，作为此设备的标识（同一个手机不同 App 的 Registration ID 是不同的），因此排查时需要获取 Registration ID 定位问题，获取方法：Android、iOS。

极光开发平台创建应用教程

创建极光开发者帐号

创建极光开发者帐号，请访问 极光推送官方网站。

创建应用

完成极光开发者账号的注册后，进入【极光控制台】-【应用管理】页面，点击“创建应用”按钮。

填写应用名称并选择应用类型，即可完成应用创建。

配置推送服务

选择服务“消息推送”，点击下一步。

Android 配置

在 Android 版块填上你的应用包名，并选择需要集成的厂商通道，点击下一步即可完成推送服务配置。

请慎重填写包名，包名保存成功后不支持自助修改，若需修改需联系技术支持，提供相关资料后方可修改。

iOS 配置

上传 iOS 推送证书 后，点击下一步即可完成推送服务配置。

本文目的在于，指导新接触极光推送的开发者，在短短几分钟时间内把极光推送跑起来：

• 安装 Demo 到客户端。
• 在 Portal 上创建推送。
• 客户端收到推送并显示在状态栏 。

创建极光开发者帐号

创建极光开发者帐号，请访问 极光推送官方网站。

创建应用

完成极光开发者账号的注册后，进入极光控制台，点击“创建应用”按钮，填写应用名称即可创建应用。

配置推送服务

选择服务“消息推送”，点击下一步。

Android 配置

在 Android 版块填上你的应用包名，并选择需要集成的厂商通道，点击下一步即可完成推送服务配置。

iOS 配置

上传 iOS 推送证书 后，点击下一步即可完成推送服务配置。

下载推送 Demo

Android 平台

点击“下载推送 Demo，免集成体验移动端接收消息” ，扫码下载推送 Demo，此 Demo 是已经配置好当前应用包名与 AppKey 的示例应用，可直接安装到手机，用于客户端接收推送。

iOS 平台

点击“下载 SDK”，并使用 Xcode 运行应用到手机。

快速测试推送

安装并打开实例应用，在应用首页获取设备的 Registration ID，如下图所示。

保持示例应用前台活跃并联网，在扫码下载推送 Demo 页面的底部输入 Registration ID，即可发送测试消息（仅支持 Android 平台）。若您需体验更多的消息样式、推送类型等，可参考下文：Portal 创建推送。

Portal 创建推送

进入【极光控制台】-【消息推送】-【创建推送】-【通知消息】，可测试更多的消息样式、推送类型，具体详情请查看 创建推送。

客户端接收推送

在上述步骤安装推送 Demo 的手机上，你就可以收到推送的通知了。