消息推送服务(Message Push Service,简称 MPS)支持创建多种推送类型的消息,并基于不同维度(用户标识或设备标识)推送消息。下面对如何通过控制台创建推送消息进行具体说明。
推送类型
MPS 支持极简推送、模板推送、批量推送以及群发推送四种推送类型。
- 极简推送
主要用于对少数几个目标进行推送的场景,比如测试苹果推送证书的有效性,Andriod 推送 SDK 接入的正确性等。无需使用模板,在创建消息时,直接添加消息内容。推送时可以选择按照指定用户或指定设备推送。 - 模板推送
主要用于对多个目标进行多次推送的场景。可以在自动化或大范围使用模板功能之前,通过在控制台页面创建模板推送类型的消息进行模板功能的校验和测试。
当消息具有普适性,即针对多个用户、多次下发的场景下,可以从消息的标题、正文中提取出变量,配置成一个模板,采用模板进行推送。 - 批量推送
批量推送主要用于对大量目标(非全网)进行推送的场景,通常用来支持一些运营需求。
在创建批量推送类型的消息时,MPS 支持直接调用移动分析人群作为推送目标,同时也支持通过上传文件的方式,指定推送目标。- 调用移动分析人群:支持对移动分析人群推送相同消息,不支持消息的个性化推送。
- 手动上传人群:支持通过上传文件的方式来指定推送目标。您可基于消息使用的模板,在文件中为各推送 ID 配置不同的占位符内容,从而实现消息的个性化推送。
- 群发推送
群发推送用于进行全网推送的场景,对全网安卓或苹果设备每次推送相同模板消息,通常用来支持一些运营需求。
群发不支持用户标识的推送目标类型,只支持安卓设备和苹果设备两种类型。对安卓设备进行群发时,所有在消息有效期内建链的安卓设备都将收到群发消息;对苹果设备进行群发时,所有在消息有效期内处于绑定状态的设备都将收到群发消息。
说明:
- 由于需要人工在页面上进行操作,故建议在系统验证、运营支持以及紧急临时需求等小频次推送场景下,通过控制台页面推送消息。
- 消息一旦创建成功即进行推送,您将无法删除或修改。
针对不同的推送类型以及不同的推送平台,MPS 使用的推送渠道不同,具体如下:
- 极简推送、模板推送和批量推送
- Android 推送平台
- 当安卓消息通道为 MPS 自建通道 或 红点消息(配置了扩展参数
badge
)时,使用自建渠道推送消息。 - 其他场景下,当接入三方推送平台(小米、华为、OPPO、vivo、FCM 等)且推送目标设备为相应厂商的机型时,使用三方渠道推送消息,否则,使用自建渠道推送消息。
- iOS 推送平台
使用三方渠道推送消息。
- 群发推送
- Android 推送平台:提供 默认通道(即安卓厂商通道) 和 MPS 自建通道 推送消息。
- iOS 推送平台:使用三方渠道推送消息。
前置条件
- 创建批量推送、模板推送和群发推送消息之前,需要先创建好模板,操作参见 创建模板。
- 创建批量推送时,若选择移动分析人群作为推送目标人群,则需要事先创建好移动分析人群,操作参见 创建用户群组。
- 在对 iOS 设备进行推送时,要先在 推送配置 页面配置好苹果设备的推送证书,操作参见 iOS 推送证书配置。
操作方法
登录 mPaaS 控制台,选择目标应用,创建消息的操作方法如下:
- 在左侧导航栏中,选择 消息推送,然后进入 消息列表 标签页。
- 点击 新建推送消息 按钮,页面上弹出 新建推送消息 对话框。
- 点击对话框上方的页签,进入不同推送类型的消息创建页面,配置推送消息的相关信息。具体参见 配置项说明 - 基础信息 和 配置项说明 - 高级信息。
在高级信息配置区域,添加扩展参数操作方法如下:
- 打开 扩展参数 的开关,高级信息 区域内展示 扩展参数 配置区域。
- 点击 增加参数 按钮,在扩展参数列表中即增加一行 key 和 value 配置区域。

- 配置 key 和 value 值,在页面任意区域处点击鼠标左键,完成配置。
说明:点击 删除,可删除对应的扩展参数。
- 点击 提交 按钮,移动推送核心即推送消息至推送 ID。
配置项说明
在 新建推送消息 对话框内创建消息,对话框分三个区域:基础信息配置区域、高级信息配置区域以及推送预览区域。您需要在前两个区域内配置推送任务的参数,并在预览区域内实时查看消息展示效果。
基础信息
配置推送的基础信息,包括消息标题、正文、推送 ID等。不同推送类型的消息,其配置项有所不同。
极简推送
需配置的基础信息参数说明见下表。
参数 | 是否必填 | 说明 |
目标 ID 类型 | 是 | 选择消息下发模式,可选: - UserId:基于用户维度推送消息。需要调用绑定接口,绑定用户标识和设备标识,绑定接口说明参见 API 参考。
- DeviceId:基于设备维度推送消息。
|
推送平台 | 是 | 基于设备维度推送消息时,需要选择推送平台,明确推送设备类型。可选: - Android:推送目标设备为安卓手机。
- iOS:推送目标设备为苹果手机。
|
业务方消息 ID | 是 | 系统自动生成,用于在业务方系统中唯一标识消息。支持自定义,最多可输入 64 个字符。 |
目标 ID | 是 | 填写用户标识和设备标识。 - 需要根据选择的 目标 ID 类型 进行填写,否则将导致推送失败。
- 当目标 ID 类型为 DeviceId 时,目标 ID 为设备标识(Android 设备填写 Ad-token;iOS 设备填写 Device Token),其所对应的手机操作系统应与所选 推送平台 一致,否则将导致推送失败。当目标 ID 类型为 UserId 时,目标 ID 为用户标识,即用户调用绑定接口时传入的
userid 值。 - 若通过日志等途径获取的设备标识包含空格,您需要删除其中的空格。
|
安卓消息通道 | 是 | 可选: - 默认通道:使用三方渠道推送消息。未接入三方渠道或已接入但推送设备非三方渠道机型时,使用自建渠道推送消息。
- MPS 自建通道:使用自建渠道推送消息。
对于 Android 推送平台,本参数为自建渠道和三方渠道推送的选择入口。对于 iOS 推送平台,您无需配置本参数(iOS 推送为三方渠道推送)。 |
展示类型 | 是 | 可选: - 展示消息(通知栏消息):指在通知栏展示消息。
- 静默消息:指无感知消息,即在目标设备上不以任何形式展示的消息。
对于 Android 推送平台,您需要根据不同的推送渠道,执行不同后续操作: - 自建渠道:本参数作为参考字段发送至客户端,您需要解析消息体,在获取本字段内容后,自行控制消息的展示。
- 三方渠道:本参数作为字段发送至目标设备后,由厂商系统解析字段内容并控制消息的展示,您无需执行其他操作。
对于 iOS 推送平台,消息的展示为厂商系统行为,您无需执行其他操作。 |
点击后操作 | 是 | 选择在手机上点击消息内容后的操作。本参数仅作为参考字段发送至客户端,您需要参考字段内容,自行实现后续操作。 可选: - 打开 Intent Activity:点击消息后,页面跳转至原生页面。
- 打开 Web URL:点击消息后,页面跳转至网页。
|
推送标题 | 是 | 填写消息的标题,最多可输入 200 字符。在 新建推送消息 文本框右侧的预览区域,可预览消息下发后的展示效果。 |
推送文本 | 是 | 填写消息的文本内容,最多可输入 200 字符。在 新建推送消息 文本框右侧的预览区域,可预览消息下发后的展示效果。 |
模板推送
需配置的基础信息参数说明见下表。
参数 | 是否必填 | 说明 |
目标 ID 类型 | 是 | 选择消息下发模式,可选: - UserId:基于用户维度推送消息。需要调用绑定接口,绑定用户标识和设备标识,绑定接口说明参见 API 参考。
- DeviceId:基于设备维度推送消息。
|
推送平台 | 是 | 基于设备维度推送消息时,需要选择推送平台,明确推送设备类型。可选: - Android:推送目标设备为安卓手机。
- iOS:推送目标设备为苹果手机。
|
业务方消息 ID | 是 | 系统自动生成,用于在业务方系统中唯一标识消息。支持自定义,最多可输入 64 个字符。 |
目标 ID | 是 | 填写用户标识或设备标识。 - 需要根据选择的 目标 ID 类型 进行填写,否则将导致推送失败。
- 当目标 ID 类型为 DeviceId 时,目标 ID 为设备标识(Android 设备填写 Ad-token;iOS 设备填写 Device Token),其所对应的手机操作系统应与所选 推送平台 一致,否则将导致推送失败。当目标 ID 类型为 UserId 时,目标 ID 为用户标识,即用户调用绑定接口时传入的
userid 值。 - 若通过日志等途径获取的设备标识包含空格,您需要删除其中的空格。
|
推送模板 | 是 | 选择消息模板,可选 消息模板 页面上列表中的所有模板。 |
安卓消息通道 | 是 | 系统根据所选消息模板的展示类型,提供不同选项: - 模板展示类型为 展示消息(通知栏消息)时:提供 默认通道 和 MPS 自建通道 选项。
- 模板展示类型为 静默消息 时:系统默认选择 MPS 自建通道,您无法修改。
各选项说明如下: - 默认通道:使用三方渠道推送消息。未接入三方渠道或已接入但推送设备非三方渠道机型时,使用自建渠道推送消息。
- MPS 自建通道:使用自建渠道推送消息。
对于 Android 推送平台,本参数为自建渠道和三方渠道推送的选择入口。对于 iOS 推送平台,您无需配置本参数(iOS 推送为三方渠道推送)。 |
展示类型 | 是 | 系统自动选择所选模板中的展示类型,您无法修改。 - 展示消息(通知栏消息):指在通知栏展示消息。
- 静默消息:指无感知消息,即在目标设备上不以任何形式展示的消息。
对于 Android 推送平台,您需要根据不同的推送渠道,执行不同后续操作: - 自建渠道:本参数作为参考字段发送至客户端,您需要解析消息体,在获取本字段内容后,自行控制消息的展示。
- 三方渠道:本参数作为字段发送至目标设备后,由厂商系统解析字段内容并控制消息的展示,您无需执行其他操作。
对于 iOS 推送平台,消息的展示为厂商系统行为,您无需执行其他操作。 |
点击后操作 | 是 | 系统根据所选模板中的配置自动进行选择,您无法修改。 |
模板占位符 | 是 | 填写模板中的变量值。系统根据所选模板中的占位符,提供配置入口。 |
批量推送
需配置的基础信息参数说明见下表。
参数 | 是否必填 | 说明 |
目标 ID 类型 | 是 | 选择消息下发模式,可选: - UserId:基于用户维度推送消息。需要调用绑定接口,绑定用户标识和设备标识,绑定接口说明参见 API 参考。
- DeviceId:基于设备维度推送消息。
|
推送平台 | 是 | 基于设备维度推送消息时,需要选择推送平台,明确推送设备类型。可选: - Android:推送目标设备为安卓手机。
- iOS:推送目标设备为苹果手机。
|
推送模板 | 是 | 选择消息模板,可选 消息模板 页面上列表中的所有模板。 |
选择推送人群 | 是 | 选择推送目标人群,可选: - 手动上传人群
手动上传推送目标文件,文件内包含了推送目标标识以及针对所选模板对各推送目标的个性化配置。文件内一条数据代表一条消息,每条消息使用业务方消息 ID 进行标识。文件格式要求如下: - 每条数据格式:
推送 ID,业务方消息 ID,占位符1= XXX,占位符2=XXX…… ,其中推送 ID 对应目标 ID(与目标 ID 类型保持一致),业务方消息 ID 由用户自定义。 - 文件编码类型要求为 UTF-8,文件大小上限为 200 MB,多条数据之间使用换行符分隔,每条数据不要超过 250 字符。一个推送任务中最多可上传 1 个文件。
文件上传成功后,手动上传人群 按钮下方将显示已上传文件的图标,点击图标,可对文件中的内容进行预览,最多可预览 10 条数据。 - 移动分析人群
支持调用移动分析人群,您需要先创建移动分析用户群组,操作方法参见 创建用户群组。 - 支持对移动分析人群推送相同消息,所选推送模板中包含占位符时,移动分析人群 将不可选。
- 当所选目标 ID 类型为设备 ID 时,移动分析人群 选项不可选。
|
安卓消息通道 | 是 | 系统根据所选消息模板的展示类型,提供不同选项: - 模板展示类型为 展示消息(通知栏消息)时:提供 默认通道 和 MPS 自建通道 选项。
- 模板展示类型为 静默消息 时:系统默认选择 MPS 自建通道,您无法修改。
各选项说明如下: - 展示消息(通知栏消息):使用三方渠道推送消息。未接入三方渠道或已接入但推送设备非三方渠道机型时,使用自建渠道推送消息。
- MPS 自建通道:使用自建渠道推送消息。
对于 Android 推送平台,本参数为自建渠道和三方渠道推送的选择入口。对于 iOS 推送平台,您无需配置本参数(iOS 推送为三方渠道推送)。 |
展示类型 | 是 | 系统自动选择所选模板中的展示类型,您无法修改。 - 展示消息(通知栏消息):指在通知栏展示消息。
- 静默消息:指无感知消息,即在目标设备上不以任何形式展示的消息。
对于 Android 推送平台,您需要根据不同的推送渠道,执行不同后续操作: - 自建渠道:本参数作为参考字段发送至客户端,您需要解析消息体,在获取本字段内容后,自行控制消息的展示。
- 三方渠道:本参数作为字段发送至目标设备后,由厂商系统解析字段内容并控制消息的展示,您无需执行其他操作。
对于 iOS 推送平台,消息的展示为厂商系统行为,您无需执行其他操作。 |
点击后操作 | 是 | 系统根据所选模板中的配置自动进行选择,您无法修改。 |
说明推送目标人群中,以下不符合要求的推送目标 ID 将无法收到消息:
- 非所选目标 ID 类型的 ID。
- 对应手机操作系统非所选推送平台的 ID。
群发推送
需配置的基础信息参数说明见下表。
参数 | 是否必填 | 说明 |
推送平台 | 是 | 选择推送平台,明确推送设备类型。可选: - Android:提供安卓厂商渠道和 MPS 自建渠道,对全网(在消息有效期内)在线的 Android 设备推送消息,对每个设备仅推送一次,不重复推送。
- iOS:使用三方渠道,对全网 iOS 客户端用户(当前登录或者历史登录过且当前登出的用户)推送消息,对每个用户仅推送一次,不重复推送。
|
业务方消息 ID | 是 | 系统自动生成,用于在业务方系统中唯一标识消息。支持自定义,最多可输入 64 个字符。 |
推送模板 | 是 | 选择消息模板,可选 消息模板 页面上列表中的所有模板。 |
安卓消息通道 | 是 | - MPS 自建通道:向推送消息有效期内的所有在线安卓用户推送消息。
- 默认通道:推送对象为所有安卓用户。如果接入了厂商通道,则通过厂商通道推送、否则通过自建通道推送。如果选择默认通道,请先接入安卓各厂商渠道。
注意:由于默认通道会对所有安卓用户推送,推送数量会远大于消息有效期内在线用户,同时可能会造成计费增长。如果未接入厂商渠道,使用默认通道,实际上是对所有用户尝试使用自建渠道推送,实际收到消息的用户就是消息有效期内在线的用户,效果和 MPS 自建通道一致。 |
展示类型 | 是 | 系统自动选择所选模板中的展示类型,您无法修改。 - 展示消息(通知栏消息):指在通知栏展示消息。
- 静默消息:指无感知消息,即在目标设备上不以任何形式展示的消息。
对于不同的推送平台,您需要为消息的展示执行不同的操作: - Android 推送平台:本参数作为参考字段发送指客户端,您需要解析消息体,在获取本字段内容后,自行控制消息的展示。
- iOS 推送平台:消息的展示为厂商系统行为,您无需执行其他操作。
|
点击后操作 | 是 | 系统根据所选模板中的配置自动进行选择,您无法修改。 |
模板占位符 | 是 | 填写模板中的变量值。系统根据所选模板中的占位符,提供配置入口。 |
高级信息
配置推送任务的更多信息,包括:
推送预览
新建推送消息 对话框右侧区域为 推送预览 区域。点击 通知、苹果消息体、安卓消息体,可分别预览消息的展示效果以及下发至不同平台的消息体。
消息内容由替换模板占位符得到时,预览中 #占位符名称# 将根据对应的 模板占位符 内容进行替换,方便您验证消息配置是否正确。

在文档使用中是否遇到以下问题
更多建议
匿名提交