即日起,mPaaS 消息推送将使用新版控制台。在新控制台界面上,创建消息推送窗口提供的推送方式由之前的极简推送、模板推送、批量推送、群发推送四种整合优化为极简推送、批量推送两种。重构后,现极简推送方式覆盖了原极简推送和模板推送功能;现批量推送方式覆盖了原批量推送和群发推送功能。
批量推送指对大量目标进行消息推送,通常用来支持一些运营需求。
批量推送分为以下两种类型:
全网推送:对全网 Android 或 iOS 设备推送相同的模板消息,仅支持按设备维度推送。对 Android 设备进行群发消息时,所有在消息有效期内建连的 Android 设备都将收到消息;对 iOS 设备进行群发消息时,所有在消息有效期内处于绑定状态的 iOS 设备都将收到消息;对鸿蒙设备进行群发消息时,所有在消息有效期内处于绑定状态的鸿蒙设备都将收到消息。
非全网推送:对指定人群推送相同的模板消息。支持手动上传人群、自定义推送人群或直接调用移动分析人群做为推送人群。
由于需要人工在页面上进行操作,故建议在系统验证、运营支持以及紧急临时需求等小频次推送场景下,通过控制台页面推送消息。
消息一旦创建成功即进行推送,您将无法删除或修改。
下面主要介绍如何通过控制台创建批量推送消息。
前置条件
对 iOS 设备进行消息推送前,确保已完成消息推送 iOS SDK 接入,并通过控制台的 通道配置 页面配置好苹果设备的推送证书,具体操作参见 配置 iOS 推送通道。
对鸿蒙设备进行消息推送前,确保已完成消息推送 鸿蒙 SDK 接入,并通过控制台的 通道配置 页面配置好鸿蒙设备的推送证书,具体操作参见 配置 HarmonyOS 推送通道。
使用 Android 厂商通道进行消息推送前,确保已完成消息推送 Android SDK 接入,接入相应的厂商通道,并通过控制台的 通道配置 页面完成相应的推送通道配置,具体操作参见 配置 Android 推送通道。
创建批量推送消息之前,需要先创建好模板,操作参见 创建模板。
创建批量推送消息时,若选择调用移动分析人群做为目标推送人群,则需要事先创建好移动分析人群,具体操作参见 创建用户群组。若选择用户标签人群做为目标推送人群,则需要事先创建用户标签人群,具体操作参见 创建用户标签。
操作步骤
登录 mPaaS 控制台,选择目标应用后,从左侧导航栏进入 消息推送 > 消息管理 页面。
单击 创建消息推送任务 按钮,在弹出的消息推送任务创建窗口中,选择 批量推送 标签。
在批量推送标签页上,配置推送消息的基础信息。各配置项说明如下:
参数
是否必填
说明
消息类型:是否静默
是
是否展示消息:
是:表示静默消息,即用户对消息无感知,在目标设备上不以任何形式展示的消息。
否:指在通知栏展示消息。
对于 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 推送消息。
重要当推送目标为移动分析人群或自定义标签人群时,不支持定时和循环推送。
对话框右侧区域为 推送预览 区域。单击 通知、苹果消息体、安卓消息体 和 鸿蒙消息体,可分别预览消息的展示效果以及下发至不同平台的消息体。
(选填)根据实际需要,配置高级信息。在高级信息配置区域,完成以下配置:
单击后跳转:选择在手机上单击消息内容后的操作。本参数仅作为参考字段发送至客户端,您需要参考字段内容,实现后续操作。
客户端自定义:单击消息后,页面跳转至原生页面。
网页:单击消息后,页面跳转至网页。
跳转地址:在手机上单击消息后访问的页面。根据 单击后跳转 选项,填写具体的页面地址:
如果是 客户端自定义,填写需要访问的原生页面地址(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)都属于用户扩展参数。用户自定义扩展参数会随消息体中的扩展参数到达客户端,供用户自定义处理。
单击 提交 按钮完成创建。创建的消息将展示在批量消息记录列表中。
除了通过控制台推送消息外,还支持通过调用 API 推送消息。具体操作,参见 服务端 API 说明。