创建消息

消息推送服务（Message Push Service，简称 MPS）支持创建多种推送类型的消息，并基于不同维度（用户标识或设备标识）推送消息。下面对如何通过控制台创建推送消息进行具体说明。

推送类型

MPS 支持极简推送、模板推送、批量推送以及群发推送四种推送类型。

• 极简推送
  主要用于对少数几个目标进行推送的场景，比如测试苹果推送证书的有效性，Andriod 推送 SDK 接入的正确性等。无需使用模板，在创建消息时，直接添加消息内容。推送时可以选择按照指定用户或指定设备推送。
• 模板推送
  主要用于对多个目标进行多次推送的场景。可以在自动化或大范围使用模板功能之前，通过在控制台页面创建模板推送类型的消息进行模板功能的校验和测试。
  当消息具有普适性，即针对多个用户、多次下发的场景下，可以从消息的标题、正文中提取出变量，配置成一个模板，采用模板进行推送。
• 批量推送
  批量推送主要用于对大量目标（非全网）进行推送的场景，通常用来支持一些运营需求。
  在创建批量推送类型的消息时，MPS 支持直接调用移动分析人群作为推送目标，同时也支持通过上传文件的方式，指定推送目标。
  • 调用移动分析人群：支持对移动分析人群推送相同消息，不支持消息的个性化推送。
  • 手动上传人群：支持通过上传文件的方式来指定推送目标。您可基于消息使用的模板，在文件中为各推送 ID 配置不同的占位符内容，从而实现消息的个性化推送。
• 群发推送
  群发推送用于进行全网推送的场景，对全网安卓或苹果设备每次推送相同模板消息，通常用来支持一些运营需求。
  群发不支持用户标识的推送目标类型，只支持安卓设备和苹果设备两种类型。对安卓设备进行群发时，所有在消息有效期内建链的安卓设备都将收到群发消息；对苹果设备进行群发时，所有在消息有效期内处于绑定状态的设备都将收到群发消息。

针对不同的推送类型以及不同的推送平台，MPS 使用的推送渠道不同，具体如下：

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

前置条件

• 创建批量推送、模板推送和群发推送消息之前，需要先创建好模板，操作参见 创建模板。
• 创建批量推送时，若选择移动分析人群作为推送目标人群，则需要事先创建好移动分析人群，操作参见 创建用户群组。
• 在对 iOS 设备进行推送时，要先在 推送配置 页面配置好苹果设备的推送证书，操作参见 iOS 推送证书配置。

操作方法

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

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

配置项说明

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

基础信息

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

极简推送

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

模板推送

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

批量推送

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

群发推送

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

高级信息

配置推送任务的更多信息，包括：

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

• 扩展参数：会跟随消息体到达客户端，供用户自定义处理。
  扩展参数包含以下三类：

  • 系统扩展参数
    这些扩展参数被系统占用，注意不要修改此类参数的 value 值。系统扩展参数包括：
    • notifyType
    • action
    • silent
    • pushType
    • templateCode
    • channel
    • taskId

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

    参数	说明
    sound	自定义铃声，value 配置为铃声的路径，本参数仅对小米和苹果手机有效。
    badge	应用图标角标，value 配置为具体数值。本扩展参数会跟随消息体到达客户端。 对于 Android 手机，您需要自行处理角标的实现逻辑。 对于苹果手机，手机系统将自动实现角标。消息推送至目标手机后，应用图标的角标即会显示为 value 中配置的数值。
    mutable-content	APNs 自定义推送标识，推送的时候携带本参数即表示支持 iOS10 的 UNNotificationServiceExtension；若不携带本参数，则为普通推送。Value 配置为 1。
    badge_add_num	华为渠道推送角标增加数。
    badge_class	华为渠道桌面图标对应的应用入口 Activity 类。
    big_text	大文本样式，value 固定为 1，填写其他值无效。本参数仅对小米和华为手机有效。

  • 用户自定义扩展参数
    

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

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

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

推送预览

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

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