本篇文档主要介绍小游戏开发者如何在新版开发者平台使用消息订阅服务。

一、功能简介

“消息订阅能力” 是个帮助开发者通过消息中心触达用户的能力。订阅消息服务的用户将会在端内收到订阅消息提醒。这一功能有助于开发者提升用户活跃度以及活动运营效果等。

• 开发者可自定义配置游戏内触发条件以引导用户订阅消息。当订阅事件（如礼包到账、BOSS刷新）被触发时，系统会主动向用户推送相关消息，以此有效提升用户活跃度与长期粘性。

开发者如需向用户推送消息，必须首先完成订阅消息功能的申请。在此前提下，方可依次执行“模板创建”与“创建消息”操作，然后完成相关api接口的接入，最终完成整个推送流程。

• 开发者可手动创建消息下发计划。在游戏遇到周年庆、联动活动、春节等重要节点时，能够自主选择目标用户类型，实现精准推送，以提升活动运营的效率和效果。

开发者可前往点击“消息推送计划”进行体验该功能。

二、功能演示

• 订阅消息：用户目前有两种订阅消息方式，一种是主动订阅，另一种是开发者引导用户订阅。
  
• 主动订阅：用户可以点击界面上方“...”进入以下页面，用户主动点击订阅消息即可关注该游戏的订阅消息推送。

• 开发者引导用户订阅：消息类型需开发者自定义的，即设计触达点。当用户满足触发条件，即可调起订阅消息弹窗引导用户关注，具体演示如下图。

• 消息展示：目前用户手动已订阅的消息共4种展示场景

push推送

游戏内提醒

消息中心

三、开发者操作流程

1.功能申请

1.1功能入口：开发者可以登录开放平台，然后点击管理中心，选择小游戏，点击运营后，点击消息订阅服务。

2.权限申请：开发者进入消息订阅服务后，点击【申请开通】可提交权限申请。审核开通预计1-3个工作日开通。

2.模版消息创建

2.1模版创建：权限开通后，开发者能进入消息订阅服务页面即代表审核通过。审核通过后，开发者即可开始创建模版。创建完模版后需要提交审核。

• 创建入口：消息订阅服务→消息模板Tab→创建模板

• 模板信息填写：
  
• 限制：最多只能维护5个生效模板；每个模板的消息类型不可重复；每个模板最多只能维护5个内容项。
• 支持填写模板后保存为草稿不提交。
• 保存为草稿的模板可重新填写后提交。

4.创建消息：当开发者创建完模版通过审核后，开发者即可创建消息。

• 创建入口：消息订阅服务→消息内容Tab→创建消息
  

• 模板信息填写：
  

• 基于生效的消息模板创建消息内容，选中消息模板后自动带出填写的内容项。
  
• 支持开发者配置消息的跳转链接，用户点击消息后将跳转配置的游戏内指定页面。
• 消息内容支持配置占位符，开发者通过API调用下发消息可以灵活控制占位符字段的值。
• 为了验证消息填写内容，支持进行消息的测试，点击【测试】，可指定小米ID下发进行消息测试，测试场景用户无需订阅游戏即可收到下发消息。
  
• 下发限制：最多支持测试下发50个小米ID用户。

• 支持开发者填写消息后保存为草稿不提交。
• 保存为草稿的消息可重新填写后提交。

3.消息推送计划（手动消息下发）

该功能适用于发送节点，重点运营活动等，无需接口接入即可使用。

• 支持开发者自行创建消息下发计划，直接提交无需审核。
• 开发者创建计划入口：消息订阅服务→消息推送计划Tab→创建计划

• 创建计划

• 基于已生效的消息内容可创建消息推送计划，支持指定消息推送时间，可指定用户或者按照用户分类推送，目前平台支持的用户分类如下：
• 全部：代表全部已订阅了游戏的用户。
• 新用户：48H内首次登录游戏的用户。
• 活跃用户：近3日登录过游戏的用户。
• 付费用户：在游戏内付费金额大于0的用户。
• 非付费用户：在游戏内付费金额为0的用户。
• 流失付费用户：在游戏内付费金额大于0，但是在近3日付费金额为0的用户。
• 流失用户：近3日未登录过游戏的用户。
• 指定用户：开发者自行上传OPENID。
• 若推送计划执行时消息内容已失效，则推送失败。
• 撤回计划
• 待推送的计划或者已经在推送中的计划支持开发者自行撤回：
• 待推送计划撤回：计划不再执行，不会推送信息。
• 推送中计划撤回：已经推送成功的用户信息不会撤回，仅撤回后仍未推送的用户信息不再推送。
• 支持平台运营主动撤回计划，撤回后将会给开发者自动推送撤回通知邮件。
• 计划列表展示
• 推送计划列表可查看开发者创建的所有推送计划，除展示计划基本内容外，也会展示计划推送的数据，包括：
• 目标用户数：实际待推送的订阅用户数，以计划执行时判定的订阅用户数为准。
• 有效用户数：可推送成功的订阅用户数。
• 曝光用户数：已浏览推送信息的用户数。
• 点击用户数：已点击推送消息的用户数。
• 点击率：点击用户数/曝光用户数。

4.接口接入

1. 消息订阅接口：开发者创建完消息模版和消息内容后，开发者需要对小游戏加入“请求订阅消息弹窗”接口，具体详见技术文档：订阅消息
2. 消息下发：

• 支持开发者通过API的形式下发消息，仅可基于状态为已生效的消息下发，用户订阅了该游戏+消息类型才会收到开发者下发的消息。
• 平台提供【订阅用户查询接口】，开发者可通过【消息下发接口】给订阅用户下发消息。具体详情查看：消息订阅查询&消息下发

5.数据报表

完成以上操作流程后，若开发者对已发的订阅消息有数据需求，可以参照以下流程进行查看

1.订阅报表：开发者可以点击【用户订阅报表】查看用户订阅情况，同时支持数据导出。

2.下发报表：开发者可点击【消息下发报表】查看详细的消息下发数据，同时支持数据导出。

四、接口文档

• 订阅消息接口：订阅消息 | 小米澎湃OS开发者平台
• 消息订阅查询&消息下发接口：消息订阅查询&消息下发 | 小米澎湃OS开发者平台