消息模板由模板主体、占位符,以及其它一些消息属性组成。占位符为模板中的动态化内容,不包含占位符的模板将不具有个性化消息推送的能力。
模板功能可以增加消息配置的灵活性,减少重复内容的输入。模板推送、批量推送以及群发推送都需要用到模板。
下面对如何配置推送模板进行详述。配置模板时,可以通过 #占位符名称# 的写法来标识模板中的动态化部分,占位符可以出现在 模板标题、模板正文 和 跳转地址 中。
操作步骤
登录 mPaaS 控制台,选择目标应用后,从左侧导航栏进入 消息推送 > 消息模板 页面。
在右侧页面中,单击 创建模板 按钮,配置模板信息,参数说明见下表。
参数
是否必填
说明
模板名称
是
模板的名称,最多可输入 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)。
跳转地址
否
点击消息后将要访问的页面地址。本参数仅作为参考字段下发至客户端,仅供您参考使用,但并不生效。您需要实现跳转逻辑。
点击 创建 按钮,创建消息。创建成功后,页面将返回 消息模板 页面,最新创建的模板将显示在列表最上方。