阿里云首页 移动开发平台 mPaaS

创建消息 - 群发推送

群发推送用于进行全网推送的场景,对全网安卓或苹果设备每次推送相同模板消息,通常用来支持一些运营需求。

群发不支持用户标识推送目标类型,仅支持安卓设备和苹果设备两种类型。对安卓设备进行群发时,所有在消息有效期内建连的安卓设备都将收到群发消息;对苹果设备进行群发时,所有在消息有效期内处于绑定状态的设备都将收到群发消息。

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

下面主要介绍如何通过控制台创建群发推送类型的消息。

前置条件

  • 对 iOS 设备进行消息推送前,确保已完成消息推送 iOS SDK 接入,并通过控制台的 推送配置 页面配置好苹果设备的推送证书,具体操作参见 iOS 推送证书配置
  • 使用 Android 厂商通道进行消息推送前,确保已完成消息推送 Android SDK 接入接入相应的厂商通道,并通过控制台的 通道配置 页面完成相应的推送通道配置,具体操作参见 通道配置
  • 创建群发推送消息之前,需要先创建好模板,操作参见 创建模板

操作步骤

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

  1. 在左侧导航栏中,选择 消息推送然后进入 消息列表 标签页。
  2. 点击 新建推送消息 按钮,在弹出的 新建推送消息 对话框中,选择 群发推送 标签。
  3. 在群发推送标签页上,配置推送消息的基础信息。各配置项说明如下:

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

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

    1

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

    • 消息有效期:设置消息的有效期,单位为秒。由于设备未在线或者用户登出导致消息下发失败时,在消息有效期内,设备建连或发起用户绑定请求后,MPS 将重新下发消息,确保消息触达率。如不设置,则默认有效期为 180 秒。
    • 推送登录状态:根据用户的登录状态进一步圈定目标推送人群。指定登录/登出时段时,永久 表示对所有登录/登出的用户推送消息,没有时间限制。
      注意:当使用 Android 推送平台且使用 MPS 自建通道进行推送时,不支持配置推送登录状态。
      • 如选择 登录用户,将会对在指定时段内登录 App 的用户推送消息。例如,选择登录时段为 15 天,则表示对最近 15 天内登录的用户推送消息。
      • 如选择 登出用户,将会对在指定时段内登出 App 用户推送消息。例如,选择登出时段为 15 天,则表示对最近 15 天内登出的用户推送消息。
      • 如同时选择 登录用户登出用户,将会对在指定时段内登录和登出的用户推送消息。例如,选择登录时段为永久,登出时段为 7 天,则表示对所有登录 App 的用户以及最近 7 天内登出 App 的用户推送消息。
    • 扩展参数:打开 扩展参数 开关,点击 增加参数 按钮,在 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. 点击 提交 按钮,推送消息至目标 ID。

相关操作