tencent cloud

文档反馈

应用内消息补推

最后更新时间:2022-01-14 19:06:02

    下发推送消息时,如果您的用户关闭了手机终端的通知权限,推送消息将无法抵达。通过启动应用内消息补发能力,当用户在前台运行 App 时,会通过应用内横幅消息的方式展示推送消息的内容,不让您的用户错过重要通知,提升推送消息的抵达率。

    应用场景

    某信用卡 App 的运营人员想要给用户 W 发一条重要的、通知用户还款即将到期的 App 推送,但是用户 W 的 App 通知权限已被关闭,无法接收 App 推送。此时,运营人员可以通过启用“应用内推送补发”的能力,当用户 W 打开 App 时,通过应用内消息的形式,将该重要消息展示给用户。

    使用条件

    Android 端设置允许应用内消息展示

    1. 在 app 目录中的 build.gradle 文件下,增加以下依赖
      implementation 'com.tencent.tpns:tpns-inmsg:[version]-release' //[VERSION] 为最新发布的 SDK 版本号,版本号可在 Android SDK 发布动态查看
      
    2. 调用 SDK 接口开启应用内消息展示,示例代码如下:
      XGPushConfig.enableShowInMsg(context, true);
      
    注意:

    安卓端的应用内消息展示依赖 WebView 框架,请留意配置 WebView 数据目录,否则可能引起程序崩溃,详情请参见 应用内消息展示

    iOS 端设置允许应用内消息展示

    iOS 端 SDK 默认允许应用内消息展示,更多应用内消息的设置请参考 iOS 接口文档

    操作说明

    控制台使用

    1. 登录 腾讯移动推送控制台
    2. 在左侧导航栏中,选择App推送管理推送任务,进入推送任务管理页面。
    3. 单击新建推送,打开应用内消息补推。如下图所示:

    说明:

    • 此功能启用后,针对应用通知权限被关闭的用户,当在前台运行 App 时,会通过应用内横幅消息的方式展示推送的内容,提升推送消息的抵达率。
    • 设置仅针对该推送任务(push_id)生效。

    Rest API 使用

    在 Rest API 可选参数中增加设置supply_inapp_msg参数为true,可实现应用内消息补推,具体参考 PushAPI 参数说明
    推送示例如下:

    {
      "audience_type": "all",
       "message_type": "notify",
         "supply_inapp_msg": true 
       "message": {
           "title": "重要提示",
           "content": "7月1日是您的还款日期,请及时还款",
           "android": {
                "custom_content":"{\"key\":\"value\"}"
           }
       }
    }
    

    查看补推数据

    当启用应用内消息补推后,可以在推送任务单击-查看详情消息补推中查看补推的数据效果。如图所示:

    指标口径

    计划发送:该推送任务通过应用内消息下发的次数加和,不去重
    实际发送:该推送任务通过应用内消息下发到终端设备的次数加和,不去重
    抵达数: 该推送任务通过应用内消息下发并抵达成功的数量加和,不去重
    抵达率: 抵达数 / 实际发送 * 100%
    曝光数:该推送任务通过应用内消息下发并成功曝光的次数加和,不去重
    点击数:该推送任务通过应用内消息曝光并被用户点击的次数加和,不去重
    点击率:点击数 / 曝光数 * 100%
    抵达量提升:应用内消息补推的抵达数 / 推送抵达数 * 100%

    说明:

    抵达量提升说明:假如某推送任务没有启用应用内消息补推,仅 App 推送的抵达量为2000。若该推送任务启用应用内消息补推, App 推送的抵达量为2000,应用内消息的抵达量为1000,那么整个推送任务的抵达量为3000,较仅使用 App 推送而言抵达量提升50%。

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持