全部产品

创建消息 - 极简推送

极简推送主要用于对少数几个目标进行推送的场景,比如测试苹果推送证书的有效性,Andriod 推送 SDK 接入的正确性等。无需使用模板,在创建消息时,直接添加消息内容。推送时可以选择按照指定用户或指定设备推送。

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

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

前置条件

  • 在对 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 自建通道:使用自建渠道推送消息。
    对于 Android 推送平台,本参数为自建渠道和第三方渠道推送的选择入口。对于 iOS 推送平台,您无需配置本参数(iOS 推送为三方渠道推送)。
    展示类型 可选:
    • 展示消息(通知栏消息):指在通知栏展示消息。
    • 静默消息:指无感知消息,即在目标设备上不以任何形式展示的消息。
    对于 Android 推送平台,您需要根据不同的推送渠道,执行不同后续操作:
    • 自建渠道:本参数作为参考字段发送至客户端,您需要解析消息体,在获取本字段内容后,自行控制消息的展示。
    • 三方渠道:本参数作为字段发送至目标设备后,由厂商系统解析字段内容并控制消息的展示,您无需执行其他操作。
    对于 iOS 推送平台,消息的展示为厂商系统行为,您无需执行其他操作。
    展示样式 消息在客户端的展示样式,支持默认(小文本)、大文本、图文消息三种样式。
    • 默认:该样式展示的内容包含推送标题和文本,适用于内容简洁明了的消息。消息文本长度建议不超过 100 个字符(包括自定义参数和符号)。
    • 大文本:该样式展示的内容包含推送标题和文本,适用于文字内容较多的消息(例如资讯类、新闻类消息),让用户无需打开应用,也能快速获取信息。消息文本长度建议不超过 256 个字符(包括自定义参数和符号)。
    • 图文消息:该样式支持消息中带图标和大图,适用于除普通文本之外更丰富的内容。出于展示效果考虑,建议消息文本长度不超过两行。
    推送标题 填写消息的标题。在 新建推送消息 文本框右侧的预览区域,可预览消息下发后的展示效果。
    推送文本 填写消息的文本内容。在 新建推送消息 文本框右侧的预览区域,可预览消息下发后的展示效果。
    消息图标 展示在通知栏消息内容右侧的消息图标,支持 jpg、jpeg、png 格式的图片。此处填写公网可访问的图标物料 URL 地址。
    若各厂商渠道未上传相应的物料,仅上传默认物料 URL时,系统会自动拉取默认物料去支持各厂商渠道的图标显示,但因为各厂商渠道对物料要求不尽相同,为避免效果不好,建议按各渠道要求分别上传物料。
    • 默认图标:建议尺寸为 140 * 140px,大小 50 KB 以内
    • OPPO 渠道图标:建议尺寸为 140 * 140px,大小 50 KB 以内
    • 小米渠道图标:建议尺寸为 120 * 120px,大小 50 KB 以内
    • 华为渠道图标:建议尺寸为 40 * 40dp,大小 512 KB 以内
    • 对于 FCM 渠道图标,无明确配置要求,系统自动拉取默认图标适配。
    消息大图 展示在通知栏消息内容下侧的图片。此处填写公网可访问的大图物料 URL 地址。
    若各厂商渠道未上传相应的物料,仅上传默认物料 URL 时,系统会自动拉取默认物料去支持各厂商渠道的大图显示,但因为各厂商渠道对物料要求不尽相同,为避免效果不好,建议按各渠道要求分别上传物料。
    • 默认大图:建议尺寸为 876 * 324px,大小 1 MB 以内,支持 jpg、jpeg、png 格式
    • OPPO 渠道大图:建议尺寸为 876 * 324px,大小 1 MB 以内,支持 jpg、jpeg、png 格式
    • 小米渠道大图:建议尺寸为 876 * 324px,大小 1 MB 以内,支持 jpg、jpeg、png 格式
    • iOS 大图:由用户自定义图片,无尺寸限制
    • 对于 FCM 渠道大图,无明确配置要求,系统自动拉取默认大图适配。
    • 对于 iOS 渠道,大图物料为用户自定义图片物料实现,无系统规范。
    点击后操作 选择在手机上点击消息内容后的操作。本参数仅作为参考字段发送至客户端,您需要参考字段内容,自行实现后续操作。
    可选:
    • 打开 Intent Activity:点击消息后,页面跳转至原生页面。
    • 打开 Web URL:点击消息后,页面跳转至网页。

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

    1

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

    • 跳转地址:在手机上点击消息后访问的页面。本参数仅作为参考字段下发至客户端,仅供您参考使用,但并不生效。您需要自行实现跳转逻辑。
      根据 点击后操作,填写不同内容:
      • 打开 Intent Activity:填写需要访问的原生页面地址(Android:ActivityName;iOS:VCName)。
      • 打开 Web URL:填写需要访问的网页地址。
    • 消息有效期:设置消息的有效期,单位为秒。由于设备未在线或者用户登出导致消息下发失败时,在消息有效期内,设备建连或发起用户绑定请求后,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。

相关操作