文档

创建消息 - 极简推送

更新时间:

重要

即日起,mPaaS 消息推送将使用新版控制台。在新控制台界面上,创建消息推送窗口提供的推送方式由之前的极简推送、模板推送、批量推送、群发推送四种整合优化为极简推送、批量推送两种。重构后,现极简推送方式覆盖了原极简推送和模板推送功能;现批量推送方式覆盖了原批量推送和群发推送功能。

极简推送指针对单个推送目标推送一条消息。采用该推送方式进行消息推送时,您既可以自定义消息内容,也可以使用预先创建的消息模板。

自定义消息内容适用于对少数几个目标进行推送的场景,比如测试苹果推送证书的有效性,Android 推送 SDK 接入的正确性等。消息模板适用于对多个目标进行多次推送的场景,即可以在自动化或大范围使用模板功能之前,通过在控制台页面创建模板推送类型的消息进行模板功能的校验和测试。

说明

  • 消息一旦创建成功即进行推送,您将无法删除或修改。

  • 由于需要人工在页面上进行操作,建议在系统验证、运营支持以及紧急临时需求等小频次推送场景下,通过控制台页面推送消息。

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

前置条件

  • 对 iOS 设备进行消息推送前,确保已完成消息推送 iOS SDK 接入,并通过控制台的 通道配置 页面配置好苹果设备的推送证书,具体操作参见 配置 iOS 推送通道

  • 使用 Android 厂商通道进行消息推送前,确保已完成消息推送 Android SDK 接入,接入相应的厂商通道,并通过控制台的 通道配置 页面完成相应的推送通道配置,具体操作参见 配置 Android 推送通道

操作步骤

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

  2. 单击 创建消息推送任务 按钮,在弹出的消息推送任务创建窗口中,选择 极简推送 标签。

  3. 在极简推送标签页上,配置推送消息的基础信息。各配置项说明如下:

    参数

    是否必填

    说明

    消息类型:是否静默

    是否展示消息:

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

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

    对于 Android 推送平台,需要根据不同的推送通道,执行不同后续操作:

    • 自建通道:本参数作为参考字段发送至客户端,您需要解析消息体,在获取本字段内容后,根据需求控制消息的展示。

    • 厂商通道:本参数作为字段发送至目标设备后,由厂商系统解析字段内容并控制消息的展示,您无需执行其他操作。

    对于 iOS 推送平台,消息的展示为厂商系统行为,无需执行其他操作。

    消息内容创建方式

    支持两种创建方式:

    • 新建:自定义消息内容,包括消息标题、正文以及展示样式。

    • 使用模板:使用事先创建好的推送模板。

    推送模板

    选择消息模板,可选当前应用的 消息模板 页面上列表中的所有模板。

    说明

    仅当消息内容创建方式为 使用模板 时需要配置。

    模板占位符

    填写模板中的变量值。系统根据所选模板中的占位符,提供配置入口。

    推送维度

    选择消息下发模式,可选择:

    • 用户维度:基于用户标识推送消息。需要调用绑定接口,绑定用户标识和设备标识,绑定接口说明参见 客户端 API

    • Android 维度:基于 Android 设备标识推送消息。

    • iOS 维度:基于 iOS 设备标识推送消息。

    用户/设备标识

    根据所选的推送维度,填写相应的用户标识或设备标识。

    • 当推送维度为 Android 维度时,填写 Ad-token。

    • 当推送维度为 iOS 维度时,填写 Device Token。

    • 当推送维度为用户维度时,填写用户标识,即用户调用绑定接口时传入的 userid 值。

    • 若通过日志等途径获取的设备标识包含空格,您需要删除其中的空格。

    安卓消息通道推送优先级

    仅针对 Android 推送平台,可选择:

    • 优先厂商通道:优先使用厂商通道推送消息。对于已接入的厂商通道,消息走对应的厂商通道服务;对于未接入的厂商通道,消息走 MPS 自建通道。

    • MPS 通道:使用 MPS 自建通道推送消息。

    对于 Android 推送平台,本参数为 MPS 通道和厂商通道推送的选择入口。对于 iOS 推送平台,您无需配置本参数(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 大图:无明确配置要求,系统自动拉取默认图标适配。

    说明

    仅当消息内容创建方式为 新建 且展示样式为 图文 时需要配置。

    推送时间

    选择何时推送消息:

    • 立即:推送时间为当前时间,即消息推送任务创建完成后立即推送。

    • 定时:在指定时间推送消息。例如,指定在 6.19 日早上 8:00 推送消息。

    • 循环:在指定时间范围内重复循环推送消息,例如指定在 6.1 ~ 9.30 期间,每周五早上 8:00 推送消息。

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

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

    • 点击后跳转:选择在手机上点击消息内容后的操作。本参数仅作为参考字段发送至客户端,您需要参考字段内容,根据需求实现后续操作。

      • 客户端自定义:点击消息后,页面跳转至原生页面。

      • 网页:点击消息后,页面跳转至网页。

    • 跳转地址:在手机上点击消息后访问的页面。根据 点击后跳转 选项,填写具体的页面地址:

      • 如果是 客户端自定义,填写需要访问的原生页面地址(Android:ActivityName;iOS:VCName)。

      • 如果是 网页:填写需要访问的网页地址。

    • 自定义消息 ID:系统自动生成,用于在业务方系统中唯一标识消息。支持自定义,最多可输入 64 个字符。

      说明

      仅当选择消息类型为静默时需要配置自定义 ID。

    • 消息有效期:设置消息的有效期,单位为秒。由于设备未在线或者用户登出导致消息下发失败时,在消息有效期内,设备建连或发起用户绑定请求后,MPS 将重新下发消息,确保消息触达率。如不设置,则默认有效期为 180 秒。

      说明

      消息有效期不能短于 180 秒,也不得超过 72 小时。

    • 扩展参数:打开 扩展参数 开关,点击 增加参数 按钮,在 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)都属于用户扩展参数。用户自定义扩展参数会随消息体中的扩展参数到达客户端,供用户自定义处理。

    • 短信补充服务:针对因网络问题、App 后台禁止运行、消息延迟等原因导致用户无法收到 App 推送的消息的情况,通过短信通道进行消息补发。启用短信补充服务后,需要设置短信签名、模板以及补发策略。

      说明

      • 目前,仅杭州非金融区提供短信补充服务。

      • 首次使用短信补充服务时,请先前往 短信补充服务 页面,按照操作提示开通短信服务。具体操作,参见 使用短信补充服务 说明文档。

      • 短信签名:短信中的个性化签名,需要通过短信服务控制台配置。

      • 短信模板:即具体发送的短信内容,需要通过短信服务控制台配置。

      • 短信补充策略:提供并发和补发两种策略。

        • 并发:指同时使用 App 消息推送和短信推送通道推送消息,实现特定消息在多通道的并行下发,适用于重要消息的大规模群发。

        • 补发:指对 App 消息推送未触达的用户通过短信的方式进行消息补发,以提升消息触达率。

      • 短信模板变量:如果选择的短信模板包含有变量,则需要指定变量的实际值。短信服务会自动用实际值替换模板中的变量,并发生短信。

  5. 点击 提交 按钮完成创建。创建的消息将展示在极简消息记录列表中。

    除了通过控制台推送消息外,还支持通过调用 API 推送消息。具体操作,参见 服务端 API 说明

相关操作

  • 本页导读 (0)
文档反馈