消息回执-应用开发（已归档）-推送服务

1. 场景介绍

消息回执是指华为Push服务端将消息推送到用户终端之后，Push端侧会给Push服务端反馈送达结果，服务端会将消息送达状态以回执消息形式回给开发者应用回执服务器。

消息回执发送时间：消息回执会在Push服务端收到端侧响应后开始发送，但受网络环境以及消息量的影响，回执消息可能会存在一些延迟，属于正常现象。

目前消息回执功能只支持安卓应用消息。

开发者可以基于接收到的消息回执码进行消息数据统计和分析，目前以下消息状态会有回执消息：

回执状态码	状态码描述	原因及处理
0	成功	NA
2	应用未安装	需用户设备安装应用。
5	指定的token在当前安卓终端用户下不存在	指定的token非设备当前系统用户的，需切换到对应的系统用户下或者更换为当前用户的token进行消息推送。
6	通知栏消息不展示	请排查以下三种原因：开发者在App中调用Push Kit的turnOffPush设置了不显示通知栏消息；用户关闭了设备上的系统通知栏总开关；用户关闭了本App的通知栏渠道开关；
10	非活跃设备消息	设备为非活跃设备（30天不接入Push），消息不进行下发。
15	离线用户消息覆盖	设置了离线用户消息覆盖（服务端API中的collapse_key）功能，消息被覆盖掉了，未下发到设备。
27	在终端设备上目标应用进程不存在导致透传消息被缓存	目标应用进程不存在。
102	消息频控丢弃	单一设备推送消息超过限制，消息丢弃，详见FAQ。
201	消息发送管控	消息被Push服务端管控起来了，待端侧通知解除管控后，消息未过期再下发。可能的原因：消息中指定的token与设备当前登录的用户无法匹配（在开启或者切换过多用户功能的设备上，不同登录用户对应不同的token）；用户关闭了显示通知栏消息；应用被卸载；

建议：

对上述状态中的2、5、6、10、201做过滤处理，减少对这些用户的无效推送。

2. 开发准备

2.1 开通回执权益

1、登录 AppGallery Connect 网站，选择“我的应用”。

2、选择需要开通服务的应用所属产品的名称，进入应用信息页面。

3、点击“开发”页签，左侧导航选择“增长服务 > 推送服务”。

4、点击“开通”，配置推送服务的状态。开通服务后，可以选择是否开通回执。

2.2 回执参数配置

1、配置消息回执的回调地址，您的回执消息接收url。

2、配置https证书。

注意：目前华为PUSH服务器和接收回执消息的APP服务器之间走的是HTTPS协议，华为PUSH服务器会校验APP服务器提供证书的合法性，请APP服务器务必使用正式商用的HTTPS证书。

3、配置回调用户名和回调密钥（非必填）进行身份验证。

4、点击“测试回执”可以对回执地址进行功能测试，测试通过点击“提交”完成服务的开通。

3. 开发指导

开发者调用服务端发送Push消息API进行消息推送时，通过设置bi_tag，消息回执时此bi_tag值会返回给开发者，通过识别bi_tag对消息的送达情况进行统计分析。

示例报文：

{
    "validate_only": false,
    "message": {
        "notification": {
            "title": "message title",
            "body": "message body"
        },
        "android": {
            "bi_tag": "your bi_tag",
            "notification": {
                "click_action": {
                    "type": 1,
                    "intent": "#Intent;compo=com.rvr/.Activity;S.W=U;end"
                }
            }
        },
        "token": [
            "pushtoken1"
        ]
    }
}