标签归档：消息推送

一门开发平台(www.yimenapp.com)原生底层开发框架，为您提供消息推送开发教程，消息推送从一门开始，200+功能模块、2000+JS映射接口按需调用。

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

发表于由

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

本文旨在指导用户如何在极光控制台上查看、使用推送记录。

推送记录说明

进入【极光控制台】-【消息推送】-【推送管理】-【推送记录】页面，点击“通知消息”、“自定义消息”、“A/B测试记录”可以查看对应类型的推送记录。移动鼠标至“送达率”、“点击率”、“推送状态”等可以查看名词解释。

  • 送达率：该通知消息的送达数量/发送数量，送达数据持续统计5天。应用内提醒消息加权：如果该消息开启了应用内提醒功能，加权送达率=应用内提醒消息送达数量/通知消息发送数量。
  • 点击率：该通知消息的点击数量/送达数量，送达数据持续统计5天。应用内提醒消息加权：如果该消息开启了应用内提醒功能，加权点击率=应用内提醒消息点击数量/通知消息发送数量。
  • 推送状态：推送成功表示极光推送服务已处理完成该推送任务请求，但不代表消息已全部推送至用户终端。处理中表示推送任务正在处理中，结束时间由通知消息的离线保存时长来决定。
  • 活跃数（A/B）：从测试时间起，1个自然天的用户活跃数据。

推送状态为“推送失败”时，该条推送显示为红色，点击“推送失败”右侧符号可以查看详细错误信息。

查询推送记录

在搜索框输入“内容/msg ID/tag/alias/RegID”可以进行推送记录查询。

搜索的内容和推送目标必须与推送时保持一致。

详情

通知消息/自定义消息

在【推送记录】-【通知消息/自定义消息】页面，点击“详情”进入推送详情页面。

基本信息

点击消息体，可以查看这条推送的 json 消息体，方便用户后续进行问题定位。

通知消息

选择对应的平台，可以查看该平台不同通道的详细推送数据。

  • 华为和魅族通道需要配置送达回执才能计算送达数据，详情参考 厂商通道回执配置指南。
  • 仅小米和极光通道支持展示率统计。

自定义消息

仅小米、华为、FCM 厂商支持自定义消息，且需要设备在线才可以收到自定义消息。

折损原因分析

  • 点击环形区域可以查看细分的折损原因。
  • 可以筛选不同平台和阶段，查看对应的折损原因比例。

均值对比

  • 均值对比-送达率-本APP均值：30日内，该 APPKEY 所属的 msgid 的送达数量相加/发送数量。
  • 均值对比-点击率-本APP均值：30日内，该 APPKEY 所属的 msgid 的点击数量相加/送达数量。

A/B 测试

在【推送记录】-【 A/B 测试记录】页面，点击“详情”进入推送详情页面。

基本信息

A/B 测试会返回两条推送的 Message ID 和两条消息体。

推送趋势分析

选择对应的平台，可以查看该平台不同通道的详细推送数据，A/B 测试所有数据都会分两组显示。

  • 华为和魅族通道需要配置送达回执才能计算送达数据，详情参考 厂商通道回执配置指南。
  • 仅小米和极光通道支持展示率统计。

折损原因分析

  • 点击环形区域可以查看细分的折损原因。
  • 可以筛选不同平台和阶段，查看对应的折损原因比例。

均值对比

  • 均值对比-送达率-本APP均值：30日内，该 APPKEY 所属的 msgid 的送达数量相加/发送数量。
  • 均值对比-点击率-本APP均值：30日内，该 APPKEY 所属的 msgid 的点击数量相加/送达数量。

转发

在推送记录页面，点击“转发”会再次进入创建推送页面，并复用原来这条推送消息的所有配置。

  • 转发功能仅支持控制台推送时使用，API 推送暂不支持。
  • A/B 测试不支持转发。

撤回

在推送记录页面，选择需要撤回的消息，点击“撤回”。

仅极光通道和小米通道支持撤回展示但未点击的通知消息。


点击“继续撤回”进行二次确认，未下发的消息将停止下发，并从设备端撤销已展示但未被点击的消息。

删除

在推送记录页面，选择需要删除的消息，点击“删除”。

该操作仅删除推送记录，不会撤回消息。


点击“确认”进行二次确认，即可删除该条推送记录。

导出申请

点击“导出申请”进入导出推送记录页面。


点击“发起申请”后，点击查看申请记录即可下载推送记录。


deleteTags 删除指定标签 APP开发接入极光消息推送能力

发表于由
用做网页的技术做APP！
一门提供标准化的jsbridge-mini.js库，您只需要在页面引用并执行JS即可实现各种原生APP、原生PC的功能能力。

==================APP端==================
【APP端】（安卓版&苹果版）目前提供200+原生功能，2000+JS映射接口，用做网站的技术即可实现各种原生APP能力、APP demo地址https://www.yimenapp.com/doc/demo.cshtml下载教程：
♦ JS-SDK 引用方式：
♦ 普通网页 script 方式加载：下载最新版，请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库；
♦ js module 方式引用：npm install ym-jsbridge 具体请参考 npm package
一门APP开发平台通用JS

deleteTags 删除指定标签 APP开发接入极光消息推送能力

核心代码示例，详情参阅demo

jsBridge.jiguang.deleteTags(['tag3', 'tag4'], function(tags){
  alert(JSON.stringify(tags));
});

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.jiguang.deleteTags(['tag3', 'tag4'], function(tags){
  alert(JSON.stringify(tags));
});

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.jiguang.deleteTags(['tag3', 'tag4'], function(tags){
  alert(JSON.stringify(tags));
});

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

addTags 新增标签 APP开发接入极光消息推送能力

发表于由
用做网页的技术做APP！
一门提供标准化的jsbridge-mini.js库，您只需要在页面引用并执行JS即可实现各种原生APP、原生PC的功能能力。

==================APP端==================
【APP端】（安卓版&苹果版）目前提供200+原生功能，2000+JS映射接口，用做网站的技术即可实现各种原生APP能力、APP demo地址https://www.yimenapp.com/doc/demo.cshtml下载教程：
♦ JS-SDK 引用方式：
♦ 普通网页 script 方式加载：下载最新版，请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库；
♦ js module 方式引用：npm install ym-jsbridge 具体请参考 npm package
一门APP开发平台通用JS

addTags 新增标签 APP开发接入极光消息推送能力

核心代码示例，详情参阅demo

jsBridge.jiguang.addTags(['tag4', 'tag5'], function(tags){
  alert(JSON.stringify(tags));
});

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.jiguang.addTags(['tag4', 'tag5'], function(tags){
  alert(JSON.stringify(tags));
});

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.jiguang.addTags(['tag4', 'tag5'], function(tags){
  alert(JSON.stringify(tags));
});

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

resumePush 恢复推送 APP开发接入极光消息推送能力

发表于由
用做网页的技术做APP！
一门提供标准化的jsbridge-mini.js库，您只需要在页面引用并执行JS即可实现各种原生APP、原生PC的功能能力。

==================APP端==================
【APP端】（安卓版&苹果版）目前提供200+原生功能，2000+JS映射接口，用做网站的技术即可实现各种原生APP能力、APP demo地址https://www.yimenapp.com/doc/demo.cshtml下载教程：
♦ JS-SDK 引用方式：
♦ 普通网页 script 方式加载：下载最新版，请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库；
♦ js module 方式引用：npm install ym-jsbridge 具体请参考 npm package
一门APP开发平台通用JS

resumePush 恢复推送 APP开发接入极光消息推送能力

核心代码示例，详情参阅demo

jsBridge.jiguang.resumePush();    
alert("已恢复接收推送");

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.jiguang.resumePush();    
alert("已恢复接收推送");

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.jiguang.resumePush();    
alert("已恢复接收推送");

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

个推消息推送emoji 表情推送

发表于由

个推消息推送emoji 表情推送

一、需求背景

1.1 背景描述

emoji是一种文本类型的象形符号，它在我们日常的网络生活中随处可见，通过它你可以了解到行行文字后的感情，甚至于一个emoji就可以表达我们当下的心情。通知栏等消息如果适当的融入emoji表情，可以更好的跟用户交流，提高消息的点击率。

1.2 各渠道支持情况

渠道是否支持
个推支持
APNs支持
华为支持
小米支持
魅族支持
OPPO支持
VIVO支持

二、功能实现

  • Android 和 iOS 都支持 emoji 表情消息
  • emoji 表情适用于通知消息
  • 实现 emoji 表情消息，客户端不用操作，服务端跟据消息场景设置想要的表情即可

2.1 开发者平台设置示例

2.2 服务端 API 接口设置示例

开发者可通过调用 服务端 RestAPI V2 实现对应的功能。api接口支持32位的Unicode表情符号，例 ud83dude00。在线工具获取emoji表情编码示例：

2.2.1 个推

"push_message":{
        "notification":{
            "title":"你点我呀！",
            "body":"假如生活出卖了我，我希望是论斤卖。ud83dude48",
             // ...其他push_message参数略
        }
    }

2.2.2 Android厂商

"push_channel":{
        "android":{
            "ups":{
                "notification":{
                    "title":"你点我呀！",
                    "body":"生命在于运动。u26f9ufe0fud83dudeb4ud83cudfcbufe0f",
                    // ...其他push_channel参数略
                }
            }
        }

2.2.3 APNs

"push_channel":{
    "ios": {
        "aps": {
            "alert": {
                "title": "你点我呀！",
                "body": "加班使我快乐。ud83dudc69u200dud83dudcbb"
                // ...其他push_channel参数略
          }
       }
    }
 }

什么是个推消息撤回？

发表于由

什么是个推消息撤回？

消息撤回

功能说明：消息撤回支持对已经发送的vivo通道消息、个推通道通知消息、小米通道通知消息进行撤回。客户端接

收到消息撤回的指令，会将通知栏中展示的消息进行删除，不再展示。

应用场景：撤回已经发出的错误消息，降低负面影响。

使用说明：进阶功能说明-消息撤回 （RestAPI V2)

个推开放平台【消息推送】点击标签操作教程

发表于由

个推开放平台【消息推送】点击标签操作教程

【消息推送】点击标签

功能介绍：

个推提供“点击标签”功能，消息下发后，当消息被用户”点击”时，可自动添加指定标签，从而提升客户精准圈人的效率。通过历史任务的点击行为偏好，长期积累用户的精准标签，以实现给合适的人推合适的内容，可以提升标签推送的效果

操作步骤：

Step 1: 第一次推送时，设置将点击该消息的用户将添加标签为：精准＂男+爱好美食＂（该标签名称支持开发者自定义设置内容）。

Step 2: 消息下发后，推送系统会自动将点击了此消息的用户打标为：精准＂男+爱好美食＂ 。

Step3: 第二次推送时，可直接通过选择标签：精准＂男+爱好美食＂人群下发。

个推开放平台【消息推送】分组对比操作教程

发表于由

个推开放平台【消息推送】分组对比操作教程

【消息推送】分组对比

功能介绍：

分组对比功能支持在同一个推送计划中，添加2-5条文案/人群进行对比测试，通过对各测试组的到达、展示、点击数据的监测分析，筛选出最优文案/人群，并支持实时及定时地按最优测试组补发剩余用户，提高通知消息点击率，助力运营提效。

操作步骤：

Step 1:点击【创建推送】-【分组对比】，填写测试名称、选择测试模式、目标平台、测试人群、补发策略、推送设置等 ，点击【测试预览】

Step 2:查看推送预览，检查确认各项设置是否正确。确认无误后，点击【确定】，正式发送推送。

Step 3：点击【数据统计】-【推送记录】，管理测试任务，可选择停止测试、取消补发、手动补发等

个推推送开放平台【消息推送】透传消息操作教程

发表于由

个推推送开放平台【消息推送】透传消息操作教程

【消息推送】透传消息

功能介绍：

透传消息，即是自定义消息，个推只负责将消息送达到客户端，而客户端接收到消息后需要自己处理消息的展示方式或后续动作。

操作步骤：

Step 1:点击【创建推送】-【透传消息】，根据小图标的解释说明填写好目标平台、通知标题、通知内容、目标选择、消息有效时长等信息以及在各个平台的通知展示方式及后续动作。然后点击【预览】

Step 2:查看推送预览，检查确认各项设置是否正确，也可以选择发送测试推送到手机上进行测试预览。确认无误后，点击【确定】，正式发送推送。

个推开放平台【消息推送】通知消息操作教程

发表于由

个推开放平台【消息推送】通知消息操作教程

【消息推送】通知消息

功能介绍：

通知消息即是通知发送后会直接在手机通知栏（状态栏）展示一条消息，个推帮助将消息送达到客户端并处理消息的展示方式为通知栏消息，并且支持启动应用、打开第三方链接、打开应用内页面、附加消息四种后续动作形式。

操作步骤：

Step 1:点击【创建推送】-【通知消息】，根据小图标的解释说明填写好目标平台、通知标题、通知内容、目标选择、消息有效时长、短信补量、广告投放等信息。

Step 2:设置通知消息在各个平台的通知展示形式。在Android平台，可通过【通知渠道模板】设置响铃、震动、浮动、唤醒屏幕等通知提醒方式；通过【后续动作】设置后续动作为启动应用、打开第三方链接、打开应用内特定页面及附加消息，附加消息的形式为透传消息；通过【展开式通知】设置通知消息下拉展开的形式为文本、大图；通过【通知栏图标】设置通知消息到达通知栏的图标为默认图标、APP本地图标、上传图片、指定图片路径；通过【角标数字】设置通知消息到达客户端后，角标数字的增量。在iOS平台，也可进行相应设置。

Step 3:查看推送预览，检查确认各项设置是否正确，也可以选择发送测试推送到手机上进行测试预览。确认无误后，点击【确定】，正式发送推送。

个推开放平台【消息推送】简介操作教程

发表于由

个推开放平台【消息推送】简介操作教程

【消息推送】简介

一、 功能介绍

  1. 个推推送的消息主要分为三种：通知消息、透传消息以及分组对比。
  2. 通知消息即是通知发送后会直接在手机通知栏（状态栏）展示一条消息，个推帮助将消息送达到客户端并处理消息的展示方式为通知栏消息。
  3. 透传消息，即是自定义消息，个推只负责将消息送达到客户端，而客户端接收到消息后需要自己处理消息的展示方式或后续动作。
  4. 分组对比，支持对比通知文案及对比用户群体，小规模测试最佳文案及最佳用户群。

二、 使用场景

  1. 推送活动通知，如促销、活动、红包、优惠券等
  2. 推送资讯热点，如资讯、新闻、热点、赛事等
  3. 推送关注动态，如关注、订阅、收藏、加购物车等
  4. 推送系统通知，如账户状态、安全、支付、物流等

三、 操作步骤

【个推·消息推送】-【应用列表】-【创建推送】

当账号有新手权益时，可通过完成新手任务，免费领取30天VIP套餐

个推推送开放平台【应用管理】创建应用组操作教程

发表于由

个推推送开放平台【应用管理】创建应用组操作教程

【应用管理】创建应用组

功能介绍：

有多个应用时，创建应用组，进行应用群组管理，提高效率

操作步骤：

点击【个推·消息推送】-【应用组列表】-【创建应用组】，输入应用组名称，针对已创建好的应用做选择，加入应用组，点击【确定】

微信开放平台微信登录功能 /消息推送服务器设置

发表于由

微信开放平台微信登录功能 /消息推送服务器设置

消息推送

第一步：填写服务器配置

登录OPEN平台后，在移动应用/网页应用详情页面 -「消息推送」中，管理员可启用消息服务，填写服务器地址（URL）、令牌（Token） 和 消息加密密钥（EncodingAESKey）等信息。

  • URL: 开发者用来接收微信消息和事件的接口 URL。开发者所填写的URL 必须以 http:// 或 https:// 开头，分别支持 80 端口和 443 端口。
  • Token: 可由开发者可以任意填写，用作生成签名（该 Token 会和接口 URL 中包含的 Token 进行比对，从而验证安全性）。
  • EncodingAESKey: 由开发者手动填写或随机生成，将用作消息体加解密密钥。

同时，开发者可选择消息加解密方式：明文模式（默认）、兼容模式和安全模式。可以选择消息数据格式：XML 格式（默认）或 JSON 格式。

模式的选择与服务器配置在提交后都会立即生效，请开发者谨慎填写及选择。切换加密方式和数据格式需要提前配置好相关代码，详情请参考 消息加解密说明。

第二步：验证消息的确来自微信服务器

开发者提交信息后，微信服务器将发送 GET 请求到填写的服务器地址 URL 上，GET请求携带参数如下表所示：

参数描述
signature微信加密签名，signature结合了开发者填写的 token 参数和请求中的 timestamp 参数、nonce参数。
timestamp时间戳
nonce随机数
echostr随机字符串

开发者通过检验 signature 对请求进行校验（下面有校验方式）。若确认此次 GET 请求来自微信服务器，请原样返回 echostr 参数内容，则接入生效，成为开发者成功，否则接入失败。加密/校验流程如下：

  1. 将token、timestamp、nonce三个参数进行字典序排序
  2. 将三个参数字符串拼接成一个字符串进行sha1加密
  3. 开发者获得加密后的字符串可与 signature 对比，标识该请求来源于微信

验证 URL 有效性成功后即接入生效。

检验 signature 的PHP示例代码：

private function checkSignature()
{
    $signature = $_GET["signature"];
    $timestamp = $_GET["timestamp"];
    $nonce = $_GET["nonce"];

    $token = TOKEN;
    $tmpArr = array($token, $timestamp, $nonce);
    sort($tmpArr, SORT_STRING);
    $tmpStr = implode( $tmpArr );
    $tmpStr = sha1( $tmpStr );

    if ($tmpStr == $signature ) {
        return true;
    } else {
        return false;
    }
}

PHP示例代码下载：下载

第三步：接收消息和事件

当某些特定的用户操作引发事件推送时（如用户资料变更时），微信服务器会将消息（或事件）的数据包以 POST 请求发送到开发者配置的 URL，开发者可以依据自身业务逻辑进行响应。事件类型消息推荐使用 FromUserName + CreateTime 排重。

服务器收到请求必须做出下述回复，这样微信服务器才不会对此作任何处理，并且不会发起重试。详见下面说明：

  1. 直接回复success（推荐方式）
  2. 直接回复空串（指字节长度为0的空字符串，而不是结构体中 content 字段的内容为空）