全部产品
Search
文档中心

移动开发平台mPaaS:创建消息 - 批量推送

更新时间:Jan 28, 2023

重要

即日起,mPaaS 消息推送将使用新版控制台。在新控制台界面上,创建消息推送窗口提供的推送方式由之前的极简推送、模板推送、批量推送、群发推送四种整合优化为极简推送、批量推送两种。重构后,现极简推送方式覆盖了原极简推送和模板推送功能;现批量推送方式覆盖了原批量推送和群发推送功能。

批量推送指对大量目标进行消息推送,通常用来支持一些运营需求。

批量推送分为以下两种类型:

  • 全网推送:对全网 Android 或 iOS 设备推送相同的模板消息,仅支持按设备维度推送。对 Android 设备进行群发消息时,所有在消息有效期内建连的 Android 设备都将收到消息;对 iOS 设备进行群发消息时,所有在消息有效期内处于绑定状态的 iOS 设备都将收到消息。

  • 非全网推送:对指定人群推送相同的模板消息。支持手动上传人群、自定义推送人群或直接调用移动分析人群做为推送人群。

说明
  • 由于需要人工在页面上进行操作,故建议在系统验证、运营支持以及紧急临时需求等小频次推送场景下,通过控制台页面推送消息。

  • 消息一旦创建成功即进行推送,您将无法删除或修改。

下面主要介绍如何通过控制台创建批量推送消息。

前置条件

  • 对 iOS 设备进行消息推送前,确保已完成消息推送 iOS SDK 接入,并通过控制台的 通道配置 页面配置好苹果设备的推送证书,具体操作参见 配置 iOS 推送通道

  • 使用 Android 厂商通道进行消息推送前,确保已完成消息推送 Android SDK 接入,接入相应的厂商通道,并通过控制台的 通道配置 页面完成相应的推送通道配置,具体操作参见 配置 Android 推送通道

  • 创建批量推送消息之前,需要先创建好模板,操作参见 创建模板

  • 创建批量推送消息时,若选择调用移动分析人群做为目标推送人群,则需要事先创建好移动分析人群,具体操作参见 创建用户群组。若选择用户标签人群做为目标推送人群,则需要事先创建用户标签人群,具体操作参见 创建用户标签

操作步骤

  1. 登录 mPaaS 控制台,选择目标应用后,从左侧导航栏进入 消息推送 > 消息管理 页面。

  2. 单击 创建消息推送任务 按钮,在弹出的消息推送任务创建窗口中,选择 批量推送 标签。

  3. 在批量推送标签页上,配置推送消息的基础信息。各配置项说明如下:

    参数

    是否必填

    说明

    消息类型:是否静默

    是否展示消息:

    • 是:表示静默消息,即用户对消息无感知,在目标设备上不以任何形式展示的消息。

    • 否:指在通知栏展示消息。

    对于 Android 推送平台,需要根据不同的推送通道,执行不同后续操作:

    • 自建通道:本参数作为参考字段发送至客户端,您需要解析消息体,在获取本字段内容后,控制消息的展示。

    • 厂商通道:本参数作为字段发送至目标设备后,由厂商系统解析字段内容并控制消息的展示,您无需执行其他操作。

    对于 iOS 推送平台,消息的展示为厂商系统行为,无需执行其他操作。

    批量推送方式

    选择消息下发模式,可选择:

    • 用户维度推送:基于用户标识推送消息。需要调用绑定接口,绑定用户标识和设备标识,绑定接口说明参见 客户端 API

    • 设备维度推送:基于设备标识推送消息。

    推送平台

    基于设备维度推送消息时,需要选择推送平台,明确推送设备类型。

    • Android:提供安卓厂商通道和 MPS 自建通道,对全网(在消息有效期内)在线的或者指定的 Android 设备推送消息,对每个设备仅推送一次,不重复推送。

    • iOS:使用厂商通道,对全网或指定的 iOS 客户端用户推送消息,对每个用户仅推送一次,不重复推送。

    推送目标

    • 当为用户推送维度时,可选择:

      • 手动上传人群:手动上传推送目标文件,文件内需包含推送目标 ID 以及针对所选模板对各推送目标的个性化配置。文件内一条数据代表一条消息,每条消息使用业务方消息 ID 进行标识。文件格式要求如下:

        • 每条数据格式为 用户 ID,业务方消息 ID,占位符1= XXX;占位符2=XXX……,其中业务方消息 ID 由用户自定义。

        • 文件编码类型要求为 UTF-8,文件大小上限为 200 MB,多条数据之间使用换行符分隔,每条数据不要超过 250 字符。一个推送任务中最多可上传 1 个文件。

        文件上传成功后,手动上传人群 按钮下方将显示已上传文件的图标,点击图标,可对文件中的内容进行预览,最多可预览 10 条数据。

      • 移动分析人群:调用移动分析人群,对所选移动分析人群推送相同消息。需要先创建移动分析用户群组,操作方法参见 创建用户群组。当所选推送模板中包含占位符时,移动分析人群不可选。

      • 用户标签:根据用户标签选择人群。选择已打上标签的人群之前,需要先 创建用户标签

    • 当为设备推送维度时,可选择:

      • 所有设备:对所选平台的所有设备进行推送。

      • 批量账号:手动上传推送目标文件,文件内需包含推送目标 ID 以及针对所选模板对各推送目标的个性化配置。文件内一条数据代表一条消息,每条消息使用业务方消息 ID 进行标识。文件格式要求如下:

        • 每条数据格式为 设备 ID,业务方消息 ID,占位符1= XXX,占位符2=XXX……,其中业务方消息 ID 由用户自定义。

        • 文件编码类型要求为 UTF-8,文件大小上限为 200 MB,多条数据之间使用换行符分隔,每条数据不要超过 250 字符。一个推送任务中最多可上传 1 个文件。

          数据示例:mpaas_push_demo,123456,title=111,content=222。

        文件上传成功后,手动上传人群 按钮下方将显示已上传文件的图标,点击图标,可对文件中的内容进行预览,最多可预览 10 条数据。

      • 移动分析人群:调用移动分析人群,对所选移动分析人群推送相同消息。您需要先创建移动分析用户群组,操作方法参见 创建用户群组。当所选推送模板中包含占位符时,移动分析人群不可选。

    推送模板

    选择消息模板,可选当前应用的 消息模板 页面上的所有模板。

    模板占位符

    填写模板中的变量值。系统根据所选模板中的占位符,提供配置入口。

    安卓消息通道推送优先级

    仅针对 Android 推送平台,可选择:

    • 优先厂商通道:优先使用厂商通道推送消息。对于已接入的厂商通道,消息走对应的厂商通道服务;对于未接入的厂商通道,消息走 MPS 自建通道。

    • MPS 通道:使用 MPS 自建通道推送消息。

    对于 Android 推送平台,本参数为自建通道和厂商通道推送的选择入口。对于 iOS 推送平台,您无需配置本参数(iOS 推送为厂商通道推送)。

    推送时间

    选择何时推送消息:

    • 立即:推送时间为当前时间,即消息推送任务创建完成后立即推送。

    • 定时:在指定时间推送消息。例如,指定在 6.19 日早上 8:00 推送消息。

    • 循环:在指定时间范围内重复循环推送消息,例如指定在 6.1 ~ 9.30 期间,每周五早上 8:00 推送消息。

    重要

    当推送目标为移动分析人群或自定义标签人群时,不支持定时和循环推送。

    对话框右侧区域为 推送预览 区域。点击 通知苹果消息体安卓消息体,可分别预览消息的展示效果以及下发至不同平台的消息体。

  4. (选填)根据实际需要,配置高级信息。在高级信息配置区域,完成以下配置:

    • 点击后跳转:选择在手机上点击消息内容后的操作。本参数仅作为参考字段发送至客户端,您需要参考字段内容,实现后续操作。

      • 客户端自定义:点击消息后,页面跳转至原生页面。

      • 网页:点击消息后,页面跳转至网页。

    • 跳转地址:在手机上点击消息后访问的页面。根据 点击后跳转 选项,填写具体的页面地址:

      • 如果是 客户端自定义,填写需要访问的原生页面地址(Android:ActivityName;iOS:VCName)。

      • 如果是 网页:填写需要访问的网页地址。

    • 推送登录状态:根据用户的登录状态进一步圈定目标推送人群。指定登录/登出时段时,永久 表示对所有登录/登出的用户推送消息,没有时间限制。

      重要

      仅当群发/批量推送方式为设备维度推送时,推送登录状态可配置。

      • 如选择 登录用户,将会对在指定时段内登录 App 的用户推送消息。例如,选择登录时段为 15 天,则表示对最近 15 天内登录的用户推送消息。

      • 如选择 登出用户,将会对在指定时段内登出 App 用户推送消息。例如,选择登出时段为 15 天,则表示对最近 15 天内登出的用户推送消息。

      • 如同时选择 登录用户登出用户,将会对在指定时段内登录和登出的用户推送消息。例如,选择登录时段为永久,登出时段为 7 天,则表示对所有登录 App 的用户以及最近 7 天内登出 App 的用户推送消息。

    • 自定义 ID:系统自动生成,用于在业务方系统中唯一标识消息。支持自定义,最多可输入 64 个字符。

    • 消息有效期:设置消息的有效期,单位为秒。由于设备未在线或者用户登出导致消息下发失败时,在消息有效期内,设备建连或发起用户绑定请求后,MPS 将重新下发消息,确保消息触达率。如不设置,则默认有效期为 180 秒。

      说明

      消息有效期不能短于 180 秒,也不得超过 72 小时。

    • 扩展参数:打开 扩展参数 开关,点击 增加参数 按钮,在 key/value 配置区域中配置 key/value 后,在页面任意区域处点击鼠标左键,完成配置。扩展参数会跟随消息体到达客户端,供用户自定义处理。扩展参数包含以下三类:

      • 系统扩展参数

        这类扩展参数被系统占用,参数值不可修改。参数包括 notifyType、action、silent、pushType、templateCode、channel、taskId。

      • 系统具有一定意义的扩展参数

        这类扩展参数被系统占用,且具有一定的意义,您可以配置此类扩展参数的参数值。系统具有一定意义的扩展参数及其说明参见下表。

        参数

        说明

        sound

        自定义铃声,参数值配置为铃声的路径。该参数仅对小米和苹果手机有效。

        badge

        应用图标角标,参数值配置为具体数值。该参数会跟随消息体到达客户端。

        • 对于 Android 手机,您需要处理角标的实现逻辑。

        • 对于苹果手机,手机系统将自动实现角标。消息推送至目标手机后,应用图标的角标即会显示为所配置的参数值。

        mutable-content

        APNs 自定义推送标识,推送的时候携带本参数即表示支持 iOS10 的 UNNotificationServiceExtension;若不携带本参数,则为普通推送。参数值配置为 1。

        badge_add_num

        华为通道推送角标增加数。

        badge_class

        华为通道桌面图标对应的应用入口 Activity 类。

        big_text

        大文本样式,参数值固定为 1,填写其他值无效。本参数仅对小米和华为手机有效。

      • 用户自定义扩展参数

      除了系统扩展参数和系统具有一定意义的扩展参数,其他的参数(key)都属于用户扩展参数。用户自定义扩展参数会随消息体中的扩展参数到达客户端,供用户自定义处理。

  5. 点击 提交 按钮完成创建。创建的消息将展示在批量消息记录列表中。

除了通过控制台推送消息外,还支持通过调用 API 推送消息。具体操作,参见 服务端 API 说明

相关操作