全部产品

创建消息

更新时间:2020-10-16 11:47:58

您可通过 消息列表 页面,创建多种类型的消息,并基于不同维度(用户标识或设备标识)推送消息。MPS 支持的推送类型包括:

  • 极简推送
    主要用于对少数几个目标进行推送的场景,比如测试苹果推送证书的有效性,Andriod pushSDK 接入的正确性等。无需使用模板,在创建消息时,直接添加消息内容。推送时可以选择按照指定用户或指定设备推送。
  • 模板推送
    主要用于对多个目标进行多次推送的场景。可以在自动化或大范围使用模板功能之前,通过在控制台页面创建模板推送类型的消息进行模板功能的校验和测试。
    当消息具有普适性,即针对多个用户、多次下发的场景下,可以从消息的标题、正文中提取出变量,配置成一个模板,采用模板进行推送。
  • 批量推送
    批量推送主要用于对大量目标(非全网)进行推送的场景,通常用来支持一些运营需求。

    在创建批量推送类型的消息时,MPS 支持通过上传文件的方式来指定推送目标。您可基于消息使用的模板,在文件中为各推送 ID 配置不同的占位符内容,从而实现消息的个性化推送。

  • 群发推送
    群发推送用于进行全网推送的场景,对全网安卓或苹果设备每次推送相同模板消息,通常用来支持一些运营需求。
    群发不支持用户标识的推送目标类型,只支持安卓设备和苹果设备两种类型。对安卓设备进行群发时,所有在消息有效期内建链的安卓设备都将收到群发消息;对苹果设备进行群发时,所有在消息有效期内处于绑定状态的设备都将收到群发消息。

说明:由于需要人工在页面上进行操作,故建议在系统验证、运营支持以及紧急临时需求等小频次推送场景时,通过控制台页面推送消息。
重要:消息一旦创建成功后即进行推送,您将无法删除或修改。

前置条件

  • 在对 iOS 设备进行推送时,要先在 推送配置 页面配置好苹果设备的推送证书,操作参见 iOS 推送证书配置
  • 创建批量推送、模板推送和群发推送消息之前,需要先创建好模板,操作参见 创建模板

操作方法

登录 mPaaS 控制台,选择目标应用,创建消息的操作方法如下:

  1. 在左侧导航栏中,选择 消息推送,进入 消息推送 页面。
  2. 在右侧页面上,点击 消息列表 标签,进入 消息列表 标签页。
  3. 点击 新建推送消息 按钮,页面上弹出 新建推送消息 对话框。
  4. 点击对话框上方的页签,进入不同推送类型的消息创建页面,配置 基础信息高级信息
    在高级信息配置区域,添加扩展参数操作方法如下:
    1. 打开 扩展参数 的开关,高级信息 区域内展示 扩展参数 配置区域。
    2. 点击 增加参数 按钮,在扩展参数列表中即增加一行 key 和 value 配置区域。
      配置扩展参数
    3. 配置 key 和 value 值,在页面任意区域处点击鼠标左键,完成配置。
      说明:点击 删除,可删除对应的扩展参数。
  5. 点击 提交 按钮,移动推送核心即推送消息至推送 ID。


不同推送类型以及不同推送平台,MPS 使用的推送渠道不同,具体如下:

  • 极简推送、模板推送和批量推送
    • Android 推送平台
      • 当安卓消息通道为 MPS 自建通道红点消息(配置了扩展参数 badge)时,使用自建渠道推送消息。
      • 其他场景下,当接入三方推送平台(小米、华为、OPPO、vivo、FCM 等)且推送目标设备为相应厂商的机型时,使用三方渠道推送消息,否则,使用自建渠道推送消息。
    • iOS 推送平台
      使用三方渠道推送消息。
  • 群发推送
    • Android 平台:提供 默认通道(即安卓厂商通道) 和 MPS 自建通道 推送消息。
    • iOS 平台:使用三方渠道推送消息。

配置项说明

新建推送消息 对话框内创建消息,对话框分 3 个区域:基础信息配置区域、高级信息配置区域以及推送预览区域。您需要在前两个区域内配置推送任务的参数,并在预览区域内实时查看消息展示效果。

基础信息

配置推送的基础信息,包括消息标题、正文、推送 ID等。不同推送类型的消息,其配置项有所不同。

极简推送

需配置的基础信息参数说明见下表。

参数 是否必填 说明
目标 ID 类型 选择消息下发模式,可选:
  • UserId:基于用户维度推送消息。需要调用绑定接口,绑定用户标识和设备标识,绑定接口说明参见 API 参考
  • DeviceId:基于设备维度推送消息。
推送平台 基于设备维度推送消息时,需要选择推送平台,明确推送设备类型。可选:
  • Android:推送目标设备为 Android 手机。
  • iOS:推送目标设备为苹果手机。
业务方消息 ID 系统自动生成,用于在业务方系统中唯一标识消息。支持自定义,最多可输入 64 个字符。
目标 ID 填写用户标识和设备标识。
  • 需要根据选择的 目标 ID 类型 进行填写,否则将导致推送失败。
  • 当目标 ID 类型为 DeviceId 时,目标 ID 为设备标识(Android 设备填写 Ad-token;iOS 设备填写 Device Token),其所对应的手机操作系统应于所选 推送平台 一致,否则将导致推送失败。
  • 若通过日志等途径获取的设备标识包含空格,您需要删除其中的空格。
安卓消息通道 可选:
  • 默认通道:使用三方渠道推送消息。未接入三方渠道或已接入但推送设备非三方渠道机型时,使用自建渠道推送消息。
  • MPS 自建通道:使用自建渠道推送消息。
对于 Android 推送平台,本参数为自建渠道和三方渠道推送的选择入口。对于 iOS 推送平台,您无需配置本参数(iOS 推送为三方渠道推送)。
展示类型 可选:
  • 展示消息(通知栏消息)
  • 静默消息:指无感知消息,即在目标设备上不以任何形式展示的消息。
对于 Android 推送平台,您需要根据不同的推送渠道,执行不同后续操作:
  • 自建渠道:本参数作为参考字段发送至客户端,您需要解析消息体,在获取本字段内容后,自行控制消息的展示。
  • 三方渠道:本参数作为字段发送至目标设备后,由厂商系统解析字段内容并控制消息的展示,您无需执行其他操作。
对于 iOS 推送平台,消息的展示为厂商系统行为,您无需执行其他操作。
点击后操作 选择在手机上点击消息内容后的操作。本参数仅作为参考字段发送至客户端,您需要参考字段内容,自行实现后续操作。
可选:
  • 打开 Intent Activity:点击消息后,页面跳转至原生页面。
  • 打开 Web URL:点击消息后,页面跳转至网页。
推送标题 填写消息的标题,最多可输入 200 字符。在 新建推送消息 文本框右侧的预览区域,可预览消息下发后的展示效果。
推送文本 填写消息的文本内容,最多可输入 200 字符。在 新建推送消息 文本框右侧的预览区域,可预览消息下发后的展示效果。

模板推送

需配置的基础信息参数说明见下表。

参数 是否必填 说明
目标 ID 类型 选择消息下发模式,可选:
  • UserId:基于用户维度推送消息。需要调用绑定接口,绑定用户标识和设备标识,绑定接口说明参见 API 参考
  • DeviceId:基于设备维度推送消息。
推送平台 基于设备维度推送消息时,需要选择推送平台,明确推送设备类型。可选:
  • Android:推送目标设备为 Android 手机。
  • iOS:推送目标设备为苹果手机。
业务方消息 ID 系统自动生成,用于在业务方系统中唯一标识消息。支持自定义,最多可输入 64 个字符。
目标 ID 填写用户标识或设备标识。
  • 需要根据选择的 目标 ID 类型 进行填写,否则将导致推送失败。
  • 当目标 ID 类型为 DeviceId 时,目标 ID 为设备标识(Android 设备填写 Ad-token;iOS 设备填写 Device Token),其所对应的手机操作系统应于所选 推送平台 一致,否则将导致推送失败。
  • 若通过日志等途径获取的设备标识包含空格,您需要删除其中的空格。
推送模板 选择消息模板,可选 消息模板 页面上列表中的所有模板。
安卓消息通道 系统根据所选消息模板的展示类型,提供不同选项:
  • 模板展示类型为 展示消息(通知栏消息)时:提供 默认通道MPS 自建通道 选项。
  • 模板展示类型为 静默消息 时:系统默认选择 MPS 自建通道,您无法修改。
各选项说明如下:
  • 默认通道:使用三方渠道推送消息。未接入三方渠道或已接入但推送设备非三方渠道机型时,使用自建渠道推送消息。
  • MPS 自建通道:使用自建渠道推送消息。
对于 Android 推送平台,本参数为自建渠道和三方渠道推送的选择入口。对于 iOS 推送平台,您无需配置本参数(iOS 推送为三方渠道推送)。
展示类型 系统自动选择所选模板中的展示类型,您无法修改。
  • 展示消息(通知栏消息):指需要展示的消息。
  • 静默消息:指无感知消息,即在目标设备上不以任何形式展示的消息。
对于 Android 推送平台,您需要根据不同的推送渠道,执行不同后续操作:
  • 自建渠道:本参数作为参考字段发送至客户端,您需要解析消息体,在获取本字段内容后,自行控制消息的展示。
  • 三方渠道:本参数作为字段发送至目标设备后,由厂商系统解析字段内容并控制消息的展示,您无需执行其他操作。
对于 iOS 推送平台,消息的展示为厂商系统行为,您无需执行其他操作。
点击后操作 系统根据所选模板中的配置自动进行选择,您无法修改。
模板占位符 填写模板中的变量值。系统根据所选模板中的占位符,提供配置入口。

批量推送

需配置的基础信息参数说明见下表。

参数 是否必填 说明
目标 ID 类型 选择消息下发模式,可选:
  • UserId:基于用户维度推送消息。需要调用绑定接口,绑定用户标识和设备标识,绑定接口说明参见 API 参考
  • DeviceId:基于设备维度推送消息。
推送平台 基于设备维度推送消息时,需要选择推送平台,明确推送设备类型。可选:
  • Android:推送目标设备为 Android 手机。
  • iOS:推送目标设备为苹果手机。
推送模板 选择消息模板,可选 消息模板 页面上列表中的所有模板。
选择推送人群

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

  • 每条数据格式为:推送 ID,业务方消息 ID,占位符1= XXX,占位符2=XXX……
  • 文件编码类型要求为 UTF-8,文件大小上限为 200 MB,多条数据之间使用换行符分隔,每条数据不要超过 250 字符。一个推送任务中最多可上传 1 个文件。
文件上传成功后,手动上传人群 按钮下方将显示已上传文件的图标,点击图表,可对文件中的内容进行预览,最多可预览 10 条数据。

安卓消息通道 系统根据所选消息模板的展示类型,提供不同选项:
  • 模板展示类型为 展示消息(通知栏消息)时:提供 默认通道MPS 自建通道 选项。
  • 模板展示类型为 静默消息 时:系统默认选择 MPS 自建通道,您无法修改。
各选项说明如下:
  • 展示消息(通知栏消息):使用三方渠道推送消息。未接入三方渠道或已接入但推送设备非三方渠道机型时,使用自建渠道推送消息。
  • MPS 自建通道:使用自建渠道推送消息。
对于 Android 推送平台,本参数为自建渠道和三方渠道推送的选择入口。对于 iOS 推送平台,您无需配置本参数(iOS 推送为三方渠道推送)。
展示类型 系统自动选择所选模板中的展示类型,您无法修改。
  • 展示消息(通知栏消息):指需要展示的消息。
  • 静默消息:指无感知消息,即在目标设备上不以任何形式展示的消息。
对于 Android 推送平台,您需要根据不同的推送渠道,执行不同后续操作:
  • 自建渠道:本参数作为参考字段发送至客户端,您需要解析消息体,在获取本字段内容后,自行控制消息的展示。
  • 三方渠道:本参数作为字段发送至目标设备后,由厂商系统解析字段内容并控制消息的展示,您无需执行其他操作。
对于 iOS 推送平台,消息的展示为厂商系统行为,您无需执行其他操作。
点击后操作 系统根据所选模板中的配置自动进行选择,您无法修改。
说明:推送目标人群中,以下不符合要求的推送目标 ID 将无法收到消息:
  • 非所选目标 ID 类型的 ID。
  • 对应手机操作系统非所选推送平台的 ID。

群发推送

需配置的基础信息参数说明见下表。

参数 是否必填 说明
推送平台 选择推送平台,明确推送设备类型。可选:
  • Android:提供安卓厂商渠道和 MPS 自建渠道,对全网(在消息有效期内)在线的 Android 设备推送消息,对每个设备仅推送一次,不重复推送。
  • iOS:使用三方渠道,对全网 iOS 客户端用户(当前登录或者历史登录过且当前登出的用户)推送消息,对每个用户仅推送一次,不重复推送。
业务方消息 ID 系统自动生成,用于在业务方系统中唯一标识消息。支持自定义,最多可输入 64 个字符。
推送模板 选择消息模板,可选 消息模板 页面上列表中的所有模板。
安卓消息通道
  • MPS 自建通道:向推送消息有效期内的所有在线安卓用户推送消息。
  • 默认通道:推送对象为所有安卓用户。如果接入了厂商通道,则通过厂商通道推送、否则通过自建通道推送。如果选择默认通道,请先接入安卓各厂商渠道。
注意:由于默认通道会对所有安卓用户推送,推送数量会远大于消息有效期内在线用户,同时可能会造成计费增长。如果未接入厂商渠道,使用默认通道,实际上是对所有用户尝试使用自建渠道推送,实际收到消息的用户就是消息有效期内在线的用户,效果和 MPS 自建通道一致。
展示类型 系统自动选择所选模板中的展示类型,您无法修改。
  • 展示消息(通知栏消息):指需要展示的消息。
  • 静默消息:指无感知消息,即在目标设备上不以任何形式展示的消息。
对于不同的推送平台,您需要为消息的展示执行不同的操作:
  • Android 推送平台:本参数作为参考字段发送指客户端,您需要解析消息体,在获取本字段内容后,自行控制消息的展示。
  • iOS 推送平台:消息的展示为厂商系统行为,您无需执行其他操作。
点击后操作 系统根据所选模板中的配置自动进行选择,您无法修改。
模板占位符 填写模板中的变量值。系统根据所选模板中的占位符,提供配置入口。

高级信息

配置推送任务的更多信息,包括:

  • 跳转地址:在手机上点击消息后访问的页面。本参数仅作为参考字段下发至客户端,仅供您参考使用,但并不生效。您需要自行实现跳转逻辑。
    根据 点击后操作 填写不同内容:
    • 打开 Intent Activity:填写需要访问的原生页面地址(Android:ActivityName;iOS:VCName)。
    • 打开 Web URL:填写需要访问的网页地址。
      说明:创建模板推送、批量推送以及群发推送消息时,跳转地址 在所选模板中配置,高级信息配置区域中无本参数的配置入口。
  • 消息有效期:设置消息的有效期,单位为秒。由于设备未在线或者用户登出导致消息下发失败时,在消息有效期内,设备建链或发起用户绑定请求后,MPS 将重新下发消息,确保消息触达率。
  • 扩展参数:会跟随消息体到达客户端,供用户自定义处理。
    扩展参数包含以下 3 类:

    • 系统扩展参数

      这些扩展参数被系统占用,注意不要修改此类参数的 value 值。系统扩展参数包括:

      • notifyType
      • action
      • silent
      • pushType
      • templateCode
      • channel
      • taskId
    • 系统具有一定意义的扩展参数

      这些扩展参数被系统占用,且具有一定的意义。您可以配置此类扩展参数的 value 值,但配置结果不会随消息体中的扩展参数到达客户端。系统具有一定意义的扩展参数及其说明参见下表。

      key 说明
      min_version 客户端最小版本,配置 value 后,即指定最小版本,MPS 推送消息时将检查应用的版本号,仅对的大于最小版本的应用推送消息。
      max_version 客户端最大版本,配置 value 后,即指定最大版本,MPS 推送消息时将检查应用的版本号,仅对的小于最大版本的应用推送消息。
      sound 自定义铃声,value 配置为铃声的路径,本参数仅对小米和苹果手机有效。
      badge 应用图标角标,value 配置为具体数值。本扩展参数会跟随消息体到达客户端。
      • 对于 Android 手机,您需要自行处理角标的实现逻辑。
      • 对于苹果手机,手机系统将自动实现角标。消息推送至目标手机后,应用图标的角标即会显示为 value 中配置的数值。
      mutable-content APNs 自定义推送标识,推送的时候携带本参数即表示支持 iOS10 的 UNNotificationServiceExtension;若不携带本参数,则为普通推送。Value 配置为 1
      Icon FCM 消息(依赖 FCM 服务推送的消息)的图标,Value 配置为图标的路径。
      fcm 针对国外安卓用户进行群发时,需要配置扩展参数 fcm = ture,否则即为对国内安卓用户的群发。
      badge_add_num 华为渠道推送角标增加数。
      badge_class 华为渠道桌面图标对应的应用入口 Activity 类。
    • 用户自定义扩展参数

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

  • 推送登录状态:选择 iOS 平台群发推送的目标用户类型。

    • 登录用户:对全网登录的用户推送消息。
    • 登录用户+登出用户:对全网登录,或者历史登录过且当前登出的用户推送消息。
  • 退出登录时长:选择 推送登录状态登录用户+登出用户 时,需要设置本参数,用于圈定推送的登出用户人群。可选:
    • 7 天:对在 7 天内登出的用户推送消息。
    • 15 天:对在 15 天内登出的用户推送消息。
    • 60 天:对在 60 天内登出的用户推送消息。
    • 永久:对所有登出的用户推送消息。

推送预览

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

消息内容由替换模板占位符得到时,预览中 #占位符名称# 将根据对应的 模板占位符 内容进行替换,方便您验证消息配置是否正确。

1