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

创建消息 - 极简推送

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

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

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

前置条件

操作步骤

登录 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。

相关操作

首页 移动开发平台 mPaaS 运营工具 消息推送 使用控制台 消息列表 创建消息 - 极简推送