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

创建模板

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

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

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

操作步骤

  1. 登录 mPaaS 控制台,在应用列表页面选择目标应用,进入目标应用的控制台操作页面。
  2. 在左侧导航栏中,选择 消息推送,进入 消息推送 页面。
  3. 在右侧页面上,进入 消息模板 标签页。
  4. 点击 创建模板 按钮,在 创建模板 对话框中配置模板信息,参数说明见下表。

    参数 是否必填 说明
    模板名称 模板的名称,最多可输入 200 字符,可为字母、数字、下划线的组合。不能与已有名称重复,将作为模板的唯一标识用于 API 调用中。
    模板描述 模板的描述,可输入字母、数字以及下划线,最多可输入 200 字符。
    展示类型 可选:
    • 展示消息(通知栏消息):指在通知栏展示消息。
    • 静默消息:指无感知消息,即在手机上不以任何形式展示消息。
    展示样式 消息在客户端的展示样式,支持默认(小文本)、大文本、图文消息三种样式。
    • 默认:该样式展示的内容包含推送标题和文本,适用于内容简洁明了的消息。消息文本长度建议不超过 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 渠道大图,无明确配置要求,系统自动拉取默认大图适配。
    点击后操作 本参数作为参考字段下发至客户端,供您参考使用,具体实现逻辑需要您自行处理。可选:
    • 打开 Internet Activity:在手机上点击消息,访问原生页面。
    • 打开 Web URL:在手机上点击消息,访问网页。
    跳转地址 本参数作为参考字段下发至客户端,供您参考使用,具体实现逻辑需要您自行处理。
    根据 点击后操作,填写不同的内容:
    • 打开 Internet Activity:填写需要访问的原生页面地址(Android:ActivityName;iOS:VCName)。
    • 打开 Web URL:填写需要访问的网页 URL。
  5. 点击 创建 按钮,创建消息。创建成功后,页面将返回 消息模板 页面,最新创建的模板将显示在列表最上方。