全部产品

创建消息 - 模板推送

更新时间:2021-05-07 10:54:38

模板推送主要用于对多个目标进行多次推送的场景。可以在自动化或大范围使用模板功能之前,通过在控制台页面创建模板推送类型的消息进行模板功能的校验和测试。当消息具有普适性,即针对多个用户、多次下发的场景下,可以从消息的标题、正文中提取出变量,配置成一个模板,采用模板进行推送。

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

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

前置条件

  • 在对 iOS 设备进行推送前,要先在控制台的 推送配置 页面配置好苹果设备的推送证书,具体操作参见 iOS 推送证书配置
  • 使用第三方渠道推送消息前,要先在控制台的 渠道配置 页面完成相应的推送渠道配置,具体操作参见 渠道配置
  • 创建模板推送消息之前,需要先创建好模板,操作参见 创建模板

操作步骤

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

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

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

    对于 Android 推送平台,您需要根据不同的推送渠道,执行不同后续操作:
    • 自建渠道:本参数作为参考字段发送至客户端,您需要解析消息体,在获取本字段内容后,自行控制消息的展示。
    • 第三方渠道:本参数作为字段发送至目标设备后,由厂商系统解析字段内容并控制消息的展示,您无需执行其他操作。
    对于 iOS 推送平台,消息的展示为厂商系统行为,您无需执行其他操作。
    点击后操作 系统根据所选模板中的配置自动进行选择,您无法修改。
    模板占位符 填写模板中的变量值。系统根据所选模板中的占位符,提供配置入口。

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

    1

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

    • 消息有效期:设置消息的有效期,单位为秒。由于设备未在线或者用户登出导致消息下发失败时,在消息有效期内,设备建连或发起用户绑定请求后,MPS 将重新下发消息,确保消息触达率。如不设置,则默认有效期为 180 秒。
    • 扩展参数:打开 扩展参数 开关,点击 增加参数 按钮,在 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。

相关操作