全部产品

创建消息 - 批量推送

更新时间:2021-05-07 16:41:50

批量推送主要用于对大量目标(非全网)进行推送的场景,通常用来支持一些运营需求。在创建批量推送类型的消息时,MPS 支持直接调用移动分析人群作为推送目标,同时也支持通过上传文件的方式,指定推送目标。

  • 调用移动分析人群:支持对移动分析人群推送相同消息,不支持消息的个性化推送。
  • 手动上传人群:支持通过上传文件的方式来指定推送目标。您可基于消息使用的模板,在文件中为各推送 ID 配置不同的占位符内容,从而实现消息的个性化推送。
说明
  • 由于需要人工在页面上进行操作,故建议在系统验证、运营支持以及紧急临时需求等小频次推送场景下,通过控制台页面推送消息。
  • 消息一旦创建成功即进行推送,您将无法删除或修改。

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

前置条件

  • 在对 iOS 设备进行推送前,要先在控制台的 推送配置 页面配置好苹果设备的推送证书,具体操作参见 iOS 推送证书配置
  • 使用第三方渠道推送消息前,要先在控制台的 渠道配置 页面完成相应的推送渠道配置,具体操作参见 渠道配置
  • 创建批量推送消息之前,需要先创建好模板,操作参见 创建模板
  • 创建批量推送消息时,若选择调用移动分析人群作为目标推送人群,则需要事先创建好移动分析人群,具体操作参见 创建用户群组

操作步骤

登录 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 值。
    • 若通过日志等途径获取的设备标识包含空格,您需要删除其中的空格。
    推送模板 选择消息模板,可选 消息模板 页面上列表中的所有模板。
    选择推送人群 选择目标推送人群,可选:
    • 手动上传人群
    • 手动上传推送目标文件,文件内包含了推送目标标识以及针对所选模板对各推送目标的个性化配置。文件内一条数据代表一条消息,每条消息使用业务方消息 ID 进行标识。文件格式要求如下:
      • 每条数据格式:推送 ID,业务方消息 ID,占位符1= XXX,占位符2=XXX……,其中推送 ID 对应目标 ID(与目标 ID 类型保持一致),业务方消息 ID 由用户自定义。
      • 文件编码类型要求为 UTF-8,文件大小上限为 200 MB,多条数据之间使用换行符分隔,每条数据不要超过 250 字符。一个推送任务中最多可上传 1 个文件。
      文件上传成功后,手动上传人群 按钮下方将显示已上传文件的图标,点击图标,可对文件中的内容进行预览,最多可预览 10 条数据。
    • 移动分析人群
    • 支持调用移动分析人群,您需要先创建移动分析用户群组,操作方法参见 创建用户群组
      • 对所选移动分析人群推送相同消息。当所选推送模板中包含占位符时,移动分析人群不可选。
      • 当所选目标 ID 类型为设备 ID 时,移动分析人群不可选。
    安卓消息通道 系统根据所选消息模板的展示类型,提供不同选项(仅针对 Android 推送平台):
    • 模板展示类型为 展示消息(通知栏消息)时:提供 默认通道MPS 自建通道 选项。
    • 模板展示类型为 静默消息 时:系统默认选择 MPS 自建通道,您无法修改。
    各选项说明如下:
    • 默认通道:使用第三方渠道推送消息。未接入第三方渠道或已接入但推送设备非第三方渠道机型时,使用自建渠道推送消息。
    • MPS 自建通道:使用自建渠道推送消息。
    对于 Android 推送平台,本参数为自建渠道和第三方渠道推送的选择入口。对于 iOS 推送平台,您无需配置本参数(iOS 推送为第三方渠道推送)。
    展示类型 系统自动选择所选模板中的展示类型,您无法修改。
    • 展示消息(通知栏消息):指在通知栏展示消息。
    • 静默消息:指无感知消息,即在目标设备上不以任何形式展示的消息。

    对于 Android 推送平台,您需要根据不同的推送渠道,执行不同后续操作:
    • 自建渠道:本参数作为参考字段发送至客户端,您需要解析消息体,在获取本字段内容后,自行控制消息的展示。
    • 第三方渠道:本参数作为字段发送至目标设备后,由厂商系统解析字段内容并控制消息的展示,您无需执行其他操作。
    对于 iOS 推送平台,消息的展示为厂商系统行为,您无需执行其他操作。
    点击后操作 系统根据所选模板中的配置自动进行选择,您无法修改。

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

    1

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

    • 消息有效期:设置消息的有效期,单位为秒。由于设备未在线或者用户登出导致消息下发失败时,在消息有效期内,设备建连或发起用户绑定请求后,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。

相关操作