下发推送消息时,如果您的用户关闭了手机终端的通知权限,推送消息将无法抵达。通过启动应用内消息补发能力,当用户在前台运行 App 时,会通过应用内横幅消息的方式展示推送消息的内容,不让您的用户错过重要通知,提升推送消息的抵达率。
应用场景
某信用卡 App 的运营人员想要给用户 W 发一条重要的、通知用户还款即将到期的 App 推送,但是用户 W 的 App 通知权限已被关闭,无法接收 App 推送。此时,运营人员可以通过启用“应用内推送补发”的能力,当用户 W 打开 App 时,通过应用内消息的形式,将该重要消息展示给用户。
![](https://qcloudimg.tencent-cloud.cn/image/document/11fdbd66562f18babd46633cb0e1e768.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/11fdbd66562f18babd46633cb0e1e768.png)
使用条件
Android 端设置允许应用内消息展示
1. 在 app 目录中的
build.gradle
文件下,增加以下依赖implementation 'com.tencent.tpns:tpns-inmsg:[version]-release' //[VERSION] 为最新发布的 SDK 版本号,版本号可在 Android SDK 发布动态查看
2. 调用 SDK 接口开启应用内消息展示,示例代码如下:
XGPushConfig.enableShowInMsg(context, true);
注意
iOS 端设置允许应用内消息展示
操作说明
控制台使用
1. 腾讯移动推送控制台。
2. 在左侧导航栏中,选择App推送管理 > 推送任务,进入推送任务管理页面。
3. 单击新建推送,打开应用内消息补推。如下图所示:
![](https://qcloudimg.tencent-cloud.cn/image/document/127a61c2d048b88e9c711a9a681746b0.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/127a61c2d048b88e9c711a9a681746b0.png)
说明
此功能启用后,针对应用通知权限被关闭的用户,当在前台运行 App 时,会通过应用内横幅消息的方式展示推送的内容,提升推送消息的抵达率。
设置仅针对该推送任务(push_id)生效。
Rest API 使用
{"audience_type": "all","message_type": "notify","supply_inapp_msg": true"message": {"title": "重要提示","content": "7月1日是您的还款日期,请及时还款","android": {"custom_content":"{\\"key\\":\\"value\\"}"}}}
查看补推数据
当启用应用内消息补推后,可以在推送任务 > 查看详情 > 消息补推中查看补推的数据效果。如图所示:
![](https://qcloudimg.tencent-cloud.cn/image/document/186727c9c0602cb1f339d8f6ed877dc4.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/186727c9c0602cb1f339d8f6ed877dc4.png)
指标口径
计划发送:该推送任务通过应用内消息下发的次数加和,不去重
实际发送:该推送任务通过应用内消息下发到终端设备的次数加和,不去重
抵达数: 该推送任务通过应用内消息下发并抵达成功的数量加和,不去重
抵达率: 抵达数 / 实际发送 * 100%
曝光数:该推送任务通过应用内消息下发并成功曝光的次数加和,不去重
点击数:该推送任务通过应用内消息曝光并被用户点击的次数加和,不去重
点击率:点击数 / 曝光数 * 100%
抵达量提升:应用内消息补推的抵达数 / 推送抵达数 * 100%
说明
抵达量提升说明:假如某推送任务没有启用应用内消息补推,仅 App 推送的抵达量为2000。若该推送任务启用应用内消息补推, App 推送的抵达量为2000,应用内消息的抵达量为1000,那么整个推送任务的抵达量为3000,较仅使用 App 推送而言抵达量提升50%。