创建模板

消息模板由模板主体、占位符,以及其它一些消息属性组成。占位符为模板中的动态化内容,不包含占位符的模板将不具有个性化消息推送的能力。

模板功能可以增加消息配置的灵活性,减少重复内容的输入。模板推送、批量推送以及群发推送都需要用到模板。

下面对如何配置推送模板进行详述。配置模板时,可以通过 #占位符名称# 的写法来标识模板中的动态化部分,占位符可以出现在 模板标题模板正文跳转地址 中。

操作步骤

  1. 登录 mPaaS 控制台,选择目标应用后,从左侧导航栏进入 消息推送 > 消息模板 页面。

  2. 在右侧页面中,单击 创建模板 按钮,配置模板信息,参数说明见下表。

    参数

    是否必填

    说明

    模板名称

    模板的名称,最多可输入 200 字符,可为字母、数字、下划线的组合。不能与已有名称重复,将作为模板的唯一标识用于 API 调用中。

    模板描述

    模板的描述,可输入字母、数字以及下划线,最多可输入 200 字符。

    模板标题

    模板的标题。

    模板正文

    模板的正文。

    展示类型:是否静默

    是否展示消息。

    • :表示静默消息,即用户对消息无感知,在目标设备上不以任何形式展示的消息。

    • :指在通知栏展示消息。

    对于 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 通道大图,无明确配置要求,系统自动拉取默认大图适配。

    点击后跳转

    本参数作为参考字段下发至客户端,供您参考使用,具体实现逻辑需要您自行处理。可选:

    • 网页:点击消息后,跳转至网页。选择该项后,需要填写要访问的网页 URL。

    • 客户端自定义:点击消息后,跳转至原生页面。选择该项后,需要填写要访问的原生页面地址(Android:ActivityName;iOS:VCName)。

    跳转地址

    点击消息后将要访问的页面地址。本参数仅作为参考字段下发至客户端,仅供您参考使用,但并不生效。您需要自行实现跳转逻辑。

  3. 点击 创建 按钮,创建消息。创建成功后,页面将返回 消息模板 页面,最新创建的模板将显示在列表最上方。

阿里云首页 移动开发平台 mPaaS 相关技术圈