控制台操作指南

为了便于运营人员更好地理解与使用 UMS，本文将详细介绍 UMS 控制台上的各项功能。

首先登录极光官网，进入服务中心，点击进入统一消息系统

渠道管理

渠道，即消息接入渠道，用于对接开发者的上游消息生产系统或人员，如果开发者拥有多条业务线，每条业务线的消息发送需要单独管理，则建议创建不同的渠道进行区分。

在渠道管理页面，点击「创建渠道」，输入渠道名称，即可创建一个渠道。

点击「基础设置」，进入渠道信息页面，其中，Channel Key 与 Master Secret 将用于调用 rest API 时的鉴权，请妥善保存防止泄露。

通道管理

通道，即消息下发通道，用于对接 App、微信公众号、微信小程序、短信、邮件、支付宝生活号、钉钉、企业微信等开发者与用户建立联系的通道。

开发者可以将上述通道所需的鉴权信息配置在 UMS 系统中，再自由组合分配给任意渠道使用，从而实现通道的统一管理。

在通道管理页面，点击「创建通道」，出现通道配置页面，通道信息包含：通道名称、通道编码、通道类型、服务商平台与对应的鉴权信息，说明如下：

• 通道名称：对通道进行命名，全局唯一，要求不超过 30 个字符，支持中英文及特殊字符。
• 通道编码：通道的绑定标识，全局唯一，将在上传用户信息时用到，仅支持数字和大小写字母，设置后不允许修改。
• 服务商平台：当某些通道类型下有不同的服务商时，将提供选择，如没有，则该值与通道类型一致。
• 通道设置：在选择了平台后，将需要输入对应的鉴权信息，各通道类型支持的平台与鉴权信息说明如下

• 微信公众号和微信小程序支持通过扫码授权的方式添加，获取授权信息需要使用微信公众号管理员的账号进行，授权成功后会展示相关公众号或小程序。

如果企业的业务系统已经自行接入了微信公众号/小程序业务，希望 UMS 在使用微信公众号/小程序时不要与业务系统产生冲突（token、获取统计数据），则建议用此种扫码授权的方式进行通道的创建。

创建通道成功后，可将该通道授权给特定的渠道，点击「渠道授权」，可对渠道进行授权和取消授权，授权后，该渠道将可以给该通道下发消息。

授权成功后，该通道将在该渠道的「渠道设置」-「通道设置」页面中出现，为防止信息泄露，该页面仅展示通道名称、通道编码和平台配置，鉴权信息不会展示。

用户管理

用户，即企业通过各个通道获取到的注册用户，UMS 将帮助企业构建一套统一管理的用户体系。

UMS 采用 userID 作为用户唯一标识，该 Key 的值由企业自行定义，可以将当前业务系统中已设定好的用户编码赋值给 userID，也可以另行设定。

• 一般来说，企业会对注册用户生成一个唯一标识，该用户产生的所有信息都将与该标识进行绑定，如果没有，则企业也可以借此机会，对用户信息做一次整合。

在用户管理页面，支持「手动添加」和「文件上传」2种方式。点击「手动添加」，出现可视化的编辑页面

点击「文件上传」，支持以 Excel 格式文件上传用户信息，一次最大支持 5 万条数据，文档大小不超过 30 M，导入数据的格式要求可以参考示例模板。

在导入 userID 与各个通道的对应关系时，有一个重要的关键字段是 bind_id（绑定标识），它可以取值 all、通道编码、渠道 Key

• all 即全局设置，所有渠道、通道通用，对标签、手机号码、邮箱地址、钉钉 ID、企业微信 ID、企业微信互联企业 ID 有效，注意：钉钉 ID 、企业微信 ID 、企业微信互联企业 ID 的关联标识仅允许传 all
• 具体的 ChannelKey，在渠道信息中可获取到该值，对标签、手机号码、邮箱地址有效，如果需要设置某一渠道的专属信息，则可以用 Channel Key 做标识，如不需要，则传 all
• 具体的通道编码，在通道详情中可获取到该值（在创建通道时由运营人员自行设定），在为 userID 绑定 App 注册 ID、微信公众号 ID、微信小程序 ID、支付宝生活号 ID 时必须指定通道编码

除了页面导入外，UMS 还提供 REST API 导入用户信息，点击查看 API 文档。

API 上传用户信息有两种鉴权方式：

• 渠道 key 和秘钥鉴权
  • 仅支持上传/修改绑定标识为：该渠道的 ChannelKey、 all 、已授权通道的编码的信息。
• 全局 key 和秘钥鉴权，该信息在用户管理页面的页尾可以取得。
  • 支持上传所有通道、渠道的用户信息
  • 支持删除用户

注：使用 UMS 系统发送消息，上传用户信息的操作不是必要的，在发送时传递相应通道的 ID 信息即可，但如果想要使用发送策略进行补发，则提前上传用户信息就是必要的，只有通过用户 ID 的发送，发送策略才生效。

通道设置

点击渠道设置-通道设置，可以启用或关闭已授权给该渠道的通道。

通道授权后默认为启用状态。关闭通道将会产生以下影响：

• 含有本通道的定时任务将在预定时间点发送失败
• 含有本通道的发送策略、通用模板将变为无效状态，无法使用
• 发送消息时将无法选择该通道

而重新启用通道会让含有本通道的无效发送策略、模板变为正常可用状态

发送策略

点击渠道设置-发送策略，可以为该渠道创建不同的发送策略，在发送时指定即可让消息按指定策略进行下发。

发送策略的主要逻辑是：在一定时间内，如果消息在上一步的通道中未送达/未点击，则执行下一步。

• 发送步骤中，每一个通道仅允许选择 1 次
• 发送策略必须设置 2 步，如果仅需要并发，则无需创建发送策略
• 从第 2 步开始，设置下发条件的作用是：当上一步触发条件时，执行本步骤
• 因通道的回执具有一定的延迟性，建议下发条件中设置的时间不要过小

发送策略设置与实际发送时的效果举例说明：

发送条件中的 AND、OR 关系说明：

• AND：所有条件均触发才执行下一步。例如：【APP 在 5 分钟内未完成送达】AND【微信公众号 在 10 分钟内未完成点击】时发送短信，那么若 App 在 5 分钟内送达了，就不会再发送短信
• OR：任意条件触发就执行下一步，反过来说即所有条件都没有触发才不执行。例如：【APP 在 5 分钟内未完成送达】OR【微信公众号 在 10 分钟内未完成点击】时发送短信，那么即便 App 在 5 分钟内送达了，但微信公众号在 10 分钟内未点击，也将发送短信。

各通道是否支持检测送达与点击状态，以及相关配置要求说明如下：

模板管理

点击渠道管理-功能模块-模板，即可进入模板管理页面。当前支持创建单、多通道通用模板，创建与导入第三方平台的模板，如微信公众号/小程序、支付宝生活号、极光短信等的模板。

多通道通用模板

UMS 支持在发消息前创建多通道通用模板，在创建模板时，可以选择对应的通道，即可以选择创建单或多通道的模板。

各通道的内容均可以嵌入变量，格式为{{var}}，不同通道的内容可以设置同一个变量，创建成功后，在使用通用模板发送消息时，仅需要对变量赋值即可，传递一个变量即可适配多个通道。方便企业对消息格式进行管控，节省多通道下发时的操作时间。

微信公众号

微信公众号消息分为模板消息和订阅通知，对应的，模板也分 2 类。

当在微信公众平台删除模板后，为了避免该操作为误操作，UMS 对应存储的模板不会直接删除，仅将模板状态变为失效，如企业确认该模板不再使用，则可以在 UMS 页面上点击删除，清除存储的信息。

1、模板消息

模板消息的模板需要前往微信公众平台-模板消息页面添加或创建。然后在 UMS 微信公众号模板页面，点击刷新即可获取到已添加的模板信息。

2、订阅通知

订阅通知可以在微信公众平台-订阅通知页面添加或创建，然后在 UMS 点击刷新来获取；也可以直接在公共模板库页面进行选用。

3、公共模板库

在公共模板库点击同步模板库，可以同步模板 ID 和模板标题，搜索找到自己想要的模板后，再点击更新关键词，即可获取该模板可选用的关键词。

同步模板库和关键词的数量是有限的，如果不够用，可以前往微信官方社区申请提高频次。

点击选用，可以选择模板中的关键词生成自己的模板，该操作与在微信公众平台的选用操作一致，创建成功后会记录在微信平台。

微信小程序

微信小程序的模板需要前往微信公众平台-模板消息页面添加或创建，并点击刷新即可获取到列表。

短信

UMS 默认对接支持极光短信，并支持标准的 CMPP 协议。

一、极光短信

短信模板的管理分为「正文模板管理」与「签名管理」，发送时将签名与正文模版进行组合，最终显示短信=签名+正文。使用极光短信需要先完成实名认证

1、短信模板分为「验证码」「通知」「营销」三种类型，创建时需要选择类型

创建完成后需要等待审核，一般预计三小时内完成审核。审核工作时间：周一至周五，9:00 ～ 11:30，13:00 ～ 18:00（法定节日顺延）。

• 审核状态会显示在列表中，需手动点击刷新获取最新的审核状态。
• 未通过的模板允许编辑，已通过和审核中的模板不允许编辑
• 点击删除即代表删除极光短信平台的模板
• 模板状态有三种：正常、失效、未知。
  • 刷新能正常查询到模板，即为正常。
  • 如果在极光短信平台删除了模板，点击刷新则模板状态会变更为无效
  • 创建成功后，若该渠道的短信通道被取消授权、或者换了一个短信通道时，状态将显示为未知。此时若确认取消授权、更换通道的操作无误，可删除这些模板，如为误操作，则可以重新授权，那么刷新模板状态后仍可继续使用这些模板。

除了创建新的模板外，还支持导入已在极光短信平台创建好的模板，输入模板 ID 即可。

2、短信签名支持在 UMS 系统中创建签名，也可以选择先在极光工作台台-极光短信-签名模板页面申请签名，然后将审核通过的签名 ID 导入 UMS 系统中。

签名状态也有三种：正常、失效、未知。

• 刷新能正常查询到签名，即为正常。
• 如果在极光短信平台删除了签名，点击刷新则签名状态会变更为无效
• 创建成功后，若该渠道的短信通道被取消授权、或者换了一个短信通道时，状态将显示为未知。此时若确认取消授权、更换通道的操作无误，可删除这些签名，如为误操作，则可以重新授权，那么刷新签名状态后仍可继续使用这些签名。

二、CMPP 协议

支持通过 CMPP 协议对接的短信平台一般无需创建/不提供创建模板和签名的接口，所以如果有需要提前报备模板和签名时，必须前往其官方平台进行申请创建，UMS 也无法将已创建好的模板同步展示。

支付宝生活号

支付宝生活号的模板需要登录生活号后台，在模板消息页面申请。申请后点击模板详情，整段复制「模板 ID」「模板名称」「关键字段」，粘贴至 UMS。

因支付宝未提供查询获取模板列表信息的 API，因此在支付宝平台删除模板后，UMS 无法检测到状态改变，只有当 UMS 在使用该模板推送消息时，若支付宝平台反馈模板不存在，才会将该模板状态变为无效。

消息管理

在渠道管理页面点击推送，进入消息管理页面，在本模块下，可以进行消息发送，查看历史记录和定时任务。

消息推送

消息发送分普通消息、通用模板消息 2 种类型，支持即时、定时、并发、补发、过滤黑名单、过滤白名单、设置消息优先级多种策略。

消息优先级

消息优先级分为高中低 3 种，不传时默认为中。不同优先级的消息处理队列不同。

消息优先级功能可以用来区分广播和点对点消息，避免广播推送影响即时推送的速度。

普通消息

在普通消息发送页面，运营人员可以自由选择进行单通道、多通道的消息发送，所有消息内容均自由填写。

消息发送分为如下几步：选择推送通道 → 设置发送时间（即时、定时）→ 选择发送策略（同时发送，自定义策略）→ 设置推送目标（广播、标签、用户 ID、用户分群、自定义传递通道 ID）→ 选择是否过滤黑名单/白名单（需要提前创建）→ 设置消息优先级（分高中低 3 个，默认为中）→ 填写各通道的消息内容。

通用模板消息

在通用模板消息发送页面，运营人员可以选择已创建好的模板进行变量传值，再选择发送，发送通道由模板确定。

消息发送分为如下几步：选择消息模板 → 设置发送时间（即时、定时）→ 选择发送策略（同时发送，自定义策略）→ 设置推送目标（广播、标签、用户 ID、用户分群、自定义传递通道 ID）→ 选择是否过滤黑名单/白名单（需要提前创建）→ 设置消息优先级（分高中低 3 个，默认为中）→ 填写模板变量。

推送历史

推送历史会记录所产生的所有消息历史记录，免费版本默认保存 7 天，VIP 可最多升级至保存 60 天。

可查看消息详情、转发消息、删除消息记录、撤回 24 小时内发出的消息。

消息列表

列表中将展示「消息内容、发送通道、有效用户数、发送用户数、送达率、点击率、发送状态、发送时间」，并支持进行筛选

列表中的送达率和点击率为用户维度的数据。指标定义如下

          有效用户数：经过极光过滤机制筛选后的最终发送目标用户数量
发送用户数：用户的任一通道返回了发送成功 code 码，则对该用户来说即为提交成功。
送达用户数：用户的任一通道有实际送达回执，对该用户来说即为送达。
点击用户数：用户的任一通道有实际点击的用户数，对该用户来说即进行了点击动作。
送达率：送达用户数/发送用户数。
点击率：点击用户数/送达用户数。
注：在选择自定义通道 ID 推送时，1 个通道注册 ID 均计为 1 个用户 

        

消息列表-撤回消息

在消息列表可以选择撤回 24 小时内发出的消息。超过 24 小时的消息无法撤回，已撤回消息的发送状态将更新为「已撤回」，在消息生命周期中也增加了对每一个用户的撤回状态。

消息详情-数据分析

点击详情，进入消息详情-数据分析页面，在本页面可以查看单条消息在用户、通道维度的漏斗、折损分析，以及通道维度的均值对比数据。

1、基本信息

此处提取重要的消息内容进行展示，详细消息内容需点击「任务详情」查看

2、用户数据分析

此处数据分析围绕用户，即 userID，用于观测多少用户（自然人）收到了此消息（不论通过什么通道收到），转化漏斗的数据指标定义如下：

          计划用户数：通过各种条件所圈定的初始发送目标用户数量
有效用户数：经过极光过滤机制筛选后的最终发送目标用户数量
发送用户数：用户的任一通道返回了发送成功 code 码，则对该用户来说即为提交成功。
送达用户数：用户的任一通道有实际送达回执，对该用户来说即为送达。
点击用户数：用户的任一通道有实际点击的用户数，对该用户来说即进行了点击动作。
送达率：送达用户数/发送用户数。
点击率：点击用户数/送达用户数。
注：在选择自定义推送时，1 个通道注册 ID均计为 1 个用户

        

用户折损分析仅分析从「计划用户」到「有效用户」之间的折损。从发送开始，折损均产生在通道侧，因此后续阶段的折损均记录在通道折损中。

3、通道数据分析

此处数据分析围绕通道，即用户绑定的各个通道的注册 ID 是否有收到、点击消息。包含：转化漏斗、折损分析、均值对比 3 个报表。

转化漏斗的数据指标定义如下：

          计划目标数：UMS系统将要提交到下游通道服务器的通道ID总数
有效目标数：经过下游通道过滤机制筛选后的最终发送目标数量
发送数量：在有效目标中，各通道服务器成功提交下发的目标数量
送达数量：在发送数量中，通过通道的回执判断已成功送达至用户的目标数量，7 天之后的送达数量不被计算在内
点击数量：消息送达后，成功被用户点击打开的目标数量，7 天之后的点击数量不被计算在内
送达率：送达数量/发送数量。
点击率：点击数量/送达数量。

        

折损原因分析是对各通道返回的失败与错误原因进行分类汇总，可以分「计划目标 → 有效目标」「有效目标 → 发送数量」「发送数量 → 送达数量」3 个阶段来查看折损。

注意：因各通道的回执存在无数据和延迟的可能性，通道消息折损数并不等于目标数、发送数与送达数之间的差值。

均值对比是将本条任务的送达率、点击率和本渠道在 30 天内所有消息的送达率点击率均值进行对比，观测本条消息的发送效果处于什么范围。

消息详情-任务详情

本页面展示该条消息所有的消息内容，可以分通道查看

定时消息

定时消息页分待发消息和发送结果

创建的定时任务将在待发消息中展示，可以对预定发送时间、消息类型、通道、目标进行筛选，也可以对定时消息进行编辑、转发和删除。

增加发送结果页是为了方便运营人员查看定时消息的处理结果，在本页面，将看到该条定时消息是否成功、失败的原因（譬如由于通道被取消授权等原因而导致消息失败）

审核管理

审核设置

分模板审核和消息审核 2 种，可分别设定。设置项均分为：审核状态（开启、关闭）、审核目标、审核流程（多级审核员）。

• 所有的成员均可被设置为审核员，每一级可以设置多个审核员，每一级的任意人处理了即可进入下一流程。
• 模板的审核目标有「多通道通用、短信、微信公众号」3项可选。仅针对可以在UMS平台上进行创建的模板进行审核，第三方平台创建的模板不在审核范围内。
• 消息的审核目标可以分「控制台推送」和「API推送」来设置，可以选择设置不同的消息类型与发送目标，譬如可以设置 API广播推送的普通消息需要被审核，通过用户ID点对点发送的模板消息不需要审核，让管控更为灵活。

审核记录

审核记录显示所有需要我（登陆账号）审核的模板、消息，可以进行通过、驳回 2 种操作。

被审记录

被审记录显示所有由我（登陆账号）发起的审批单，可以对被驳回的审批单进行修改后再次发起申请。

统计分析

数据概览

今日发送趋势：当天发出的消息产生的「计划目标、有效目标、发送数量、送达数量、点击数量」，此处送达点击均记录在上报的时间点，用于观测消息趋势。

今日折损分析：今日从 0 点到当前时间点的所有折损原因与占比，分「目标用户折损」和「通道消息折损」

用户通道覆盖率：具有**通道注册 ID 的用户在渠道总用户中的占比和数量，便于观测用户资产的完善度

消息统计

按时间维度汇总统计所有发给通道的消息，可观测「计划目标、有效目标、发送数量、送达数量、点击数量」5 个指标。

不论送达、点击在哪一天上报，均统计在发出消息的时间点，以形成一个漏斗。可以导出详细数据。

请求量统计

展示一段时间内发出的发送任务数量，便于运营人员观测本渠道消息发送的合理性。

点击分布

本统计报表对所选时间段的每天 24 小时的每小时点击数据累加，用于观测用户在一天各时间段点击消息的倾向，对企业选择发送时机有一定的帮助。

用户分群

分群管理

用户分群，可以将企业用户分为不同的人群包，通过手动或文件上传的方式导入用户 ID，在发送消息时可以选择该人群进行发送。

分群数据分析

对单个分群提供数据分析功能，包含：用户总数、各通道的触达数、人群历史数据，历史送达率、历史点击率。

历史送达率、历史点击率是对向该分群发出的所有消息的数据进行的统计分析。

高级功能

提供更多配置功能，包括：安全设置-敏感词、免打扰设置、用户黑名单、用户白名单、消息生命周期、回调设置。

除消息生命周期外，其他均为 VIP 功能，如需要开通此功能，请联系：商务客服

敏感词

开启敏感词检测后，发消息和创建模板时均会进行一次敏感词检测，保障信息内容安全。

敏感词添加方式支持手动添加、文件上传（Excel）。添加敏感词时可以设置本批敏感词的状态为开启或关闭，只有处于开启状态的敏感词才会被检测。

当敏感词检测开关被关闭后，无论单个敏感词处于什么状态，均不会检测。

免打扰设置

免打扰设置可以根据消息优先级来进行管控，总共可以设置 15 个时间段。开启免打扰设置后，如果发送的消息在管控范围内，将会直接报错失败。

用户黑名单

每个渠道可创建多份黑名单，在发送消息时再选择具体需要过滤的黑名单，黑名单中的用户可以通过手动添加、文件上传（Excel） 2 种方式进行导入。

用户白名单

每个渠道可创建多份白名单，在发送消息时再选择具体需要过滤的白名单，与用户黑名单互斥（发送消息时只能选择一种）。

白名单中的用户可以通过手动添加、文件上传（Excel）2 种方式进行导入。

消息生命周期

在此处可以查询一条消息下具体某一个目标的发送情况。包含发送进度（运营人员关注）和详细日志（研发关注）

回调设置

如果需要获得一条消息对于所有目标的发送状态，可以在高级功能-回调设置中配置一个回调地址，勾选所需回调的状态类型，开启回调即可。

在调用 rest API 发送消息时可以设置临时的 callback 地址，该地址必须在控制台进行配置才有效，控制台允许添加最多 5 个回调地址。当发送消息未设置临时 callback 地址时，回调消息将回调给默认地址。

关闭回调开关后，将不再进行消息回调。可以对回调地址进行有效性测试、删除、设为默认地址，默认地址不允许删除。

详细说明见回调设置