小米应用商店：小米推送产品说明

小提示：您能找到这篇{小米应用商店：小米推送产品说明}绝对不是偶然，我们能帮您找到潜在客户，解决您的困扰。如果您对本页介绍的小米应用商店：小米推送产品说明内容感兴趣，有相关需求意向欢迎拨打我们的服务热线，或留言咨询，我们将第一时间联系您！

< ">< font-size: 18px;">1.小米推送简介

< ">小米推送（MiPush）是小米公司向开发者提供的消息推送服务，通过在云端与客户端之间建立一条稳定、可靠的长连接，为开发者提供向客户端应用实时推送消息的服务，有效地帮助开发者触达用户，提升APP活跃度。

< ">依托强大的服务器集群，以及多年在手机即时通讯领域的技术积累，小米在消息推送服务这一领域有着丰富的经验和雄厚的实力。在保证推送消息的到达率及到达速度的同时，我们还设计了一套基于业界最高标准加密算法的安全措施，让应用消息的传输更加安全可靠。

< ">截止2019年底，小米推送累计接入应用30000+，覆盖设备数11亿，每天发送消息110亿条。

图1 小米推送服务业务逻辑

< ">< font-size: 18px;">2.产品优势

< ">2.1 MIUI系统级通道

< ">小米推送在MIUI上的长连接由系统维护，能够充分的保障通知栏消息在MIUI上的送达率。设备联网的情况下，有效推送的送达率能达到90%以上。

< ">2.2定制化消息样式

< ">支持长文字、大图等富文本通知栏消息样式，满足不同开发者的个性化推送需求。

< ">2.3稳定、安全、快速、灵活

< ">小米推送支持通知栏消息和透传消息两种消息类型，同时提供API接口和推送运营平台两种消息下发途径。SDK覆盖Android、iOS客户端及服务端主流语言，只需半天时间集成，可以帮助开发者更好的结合自身业务逻辑，满足复杂业务场景需求。

< ">2.4多平台支持

< ">小米推送服务的客户端SDK基于标准的Android SDK，支持所有的Android2.2及以上的系统。同时，我们也支持iOS版本的推送，目的是提供一整套有关推送消息的整合解决方案，让开发者真正地做到推送无忧。iOS推送是基于苹果的APNs服务之上封装的一层服务。降低开发者使用iOS推送的门槛。同时服务端的接口实现了跨平台，方便开发者跨平台使用小米推送。

< ">2.5全面的数据统计

< ">推送运营平台提供包括APP数据和消息数据等多维度的统计，帮助开发者更好的掌握应用数据，助力精细化运营。

< ">2.6自助调查工具

< ">小米推送为开发者提供了一套完备的调查工具，可以辅助开发者自助查询设备与消息的送达/在线情况，实时把控消息状态。

< ">< font-size: 18px;">3.推送功能介绍

< ">3.1推送的消息类型

< ">小米推送支持通知栏提醒和透传消息两种消息类型，同时提供运营平台及API两种推送消息下发方式。

< ">3.1.1通知栏消息

< ">通知栏消息通过小米系统通道下发，不需要应用驻留后台。

< ">客户端收到这类消息后，会直接在通知栏展现。用户点击弹出通知后，客户端SDK会将消息中携带的数据传递给应用，由应用决定下一步的动作。

< ">通知栏消息展示效果如图2所示，主要内容包括消息标题、摘要、应用图标和时间。开发者可以自行定义具体展示内容。同时，针对每条消息，开发者也可以单独定义是否响铃、是否振动、是否点亮呼吸灯，并且可以选择响铃的声音。

< ">注：在MIUI中，由于通知栏是由小米服务框架弹出，因此大、小图标均不可自定义。使用的声音资源必须先内置在应用程序的安装包中。

图2 MIUI和原生Android上消息展示

< ">关于通知栏消息有如下几点说明：

< ">MIUI10以上，同一个App的所有通知栏消息会聚合成一个消息组，消息组最多支持展示10条消息，超过10条消息，会自动删除一条最老的消息并补上来一条新消息。

< ">消息组折叠状态下默认展示3条消息，多余的消息用+N标识，N=消息总数-3。特别的，如果该App的消息组位于通知栏首位，则会展示5条消息，超过5条的多余消息用+N标识。

< ">如果手动点击或删除一条展示的消息，会自动补充上来一条消息展示。

< ">3.1.2透传消息

< ">透传消息是指开发者可选择不通过任何预定义的方式展现，由应用直接接收推送消息。利用透传消息，开发者可自定义更多使用推送的方式和展现形式，从而能更为灵活地使用消息推送通道。

< ">需要注意的是，在一些Android系统(如MIUI)中，受到系统自启动管理设置的限制，应用不能在后台自启动。在这类系统中，如果在发送消息的时候对应的应用没有被启动，透传类消息将不能顺利送达。因此，对于对送达率要求很高的消息，建议尽量采用通知栏提醒的方式推送消息。

< ">注：在MIUI中，对于小米推送服务的通知栏提醒类消息，通知由系统级应用“小米服务框架”弹出，不需要应用驻留后台。在非MIUI上，通知栏消息和透传消息都需要应用保留进程。

< ">3.2推送方式

< ">小米推送支持标签（Topic）、RegID、别名（Alias）、Useraccount四种消息发送方式。

< ">3.2.1基于标签的推送

< ">标签（Topic）可以认为是具有某些相同属性的用户集合,在应用初始化时或运行过程中，开发者可结合自己的业务特征，给用户打上不同的标签(Topic)。

< ">在推送消息时，开发者可以结合每条消息的内容和目标用户，选择所对应的标签，完成请求后，小米推送服务会向所有打上这一标签的用户发送该消息，从而满足精准推送的需求。

< ">注：

< ">?标签不会主动失效，只有开发者主动调广州医医药有限公司用退订标签（unsubscribe）或设备标识（RegID/alias/useraccount）失效才会取消；

< ">?全部用户消息同样属于标签消息（设备注册时会注册一个默认标签用于发送全量消息）；

< ">?每个设备可订阅标签的个数无上限；

< ">?每个标签可对应的设备数无上限;

< ">?标签可以和RegID与alias对应;

< ">?标签消息在消息有效期结束之前，可以停止发送。停止后不能继续发送。只有标签消息可以停止，其余消息发送后不可停止。

< ">3.2.2基于RegID的推送

< ">RegID是小米推送为每个设备上的每个app注册推送服务时生成的唯一标识。

< ">当开发者需要给一个或多个具体的设备推送消息时，可以使用基于RegID的推送，将个性化的信息推送给指定的设备。这种方式适用于需要为每个用户订制个性化推送的场景。

< ">注：

< ">?RegID是在客户端向小米推送服务注册时，小米推送服务端根据设备标识、AppID以及当前时间戳生成，因此能够保证每个设备上每个app对应的regID都是不同的。

< ">?RegID在应用卸载或清除本地数据后会重新生成；

< ">?RegID在如下几种情况下会被判断失效：

< ">①App卸载重装或者清除数据后重新注册，这种情况下会生成一个新的RegID，而老的RegID会失效；

< ">②App调用了unregisterPush；

< ">③在MIUI上，App卸载时，如果能成功上报，则RegID会被判定失效；

< ">④设备超过3个月没有和小米Push服务器建立长连接；

< ">?可以通过feedback接口从小米推送服务后台拉取失效RegID的列表；

< ">?iOS SDK从2.2.2版本之后新增支持客户端获取RegID的方法：getRegID。

< ">3.2.3基于别名（alias）的推送

< ">别名（alias）是小米推送提供的一种个性化设定,开发者可以将用户在应用内的账号或其它用户唯一标识设定为用户设备RegID的别名，在推送中可以直接基于别名进行推送。

< ">别名不仅方便开发者将推送与自有的账号系统进行关联，同时也避免了因需要保存设备RegID与自有帐号的对应关系而额外带来的开发和存储成本。

< ">注：

< ">?alias与RegID(设备)一一对应，同一个alias不能对应多个RegID，alias对应的RegID以最后一次setalias对应的RegID为准；

< ">?alias失效的可能原因如下：

< ">①主动调用unsetalias；

< ">②alias对应的RegID已经失效；

< ">③设置alias不成功（调用setalias失败）；

< ">?alias只跟设备相关，所以请使用用户账号作为alias时，合理判断alias可能失效的情况。

< ">3.2.4基于useraccount的推送

< ">useraccount主要适用于用户多点登陆的情况，与alias类似，同样可以作为应用自身的用户标识与RegID建立映射关系。

< ">典型的场景就是用户的alias和user account都可以用来设置设备对应的用户账号，所不同的是，一个alias只能对应一台设备，如果有多台设备设置了同样的alias，则最后一个设置成功的生效，其它设备就会失效。而一个user account可对应20台以内的设备。因此如果应用是单点登录的，一个账号只会在一台设备上生效，用alias会比较合适。而如果产品需求是单账号多点登录同时接收消息，则用user account会更合适。

< ">注：

< ">useraccount最多可对应20台设备，并以最近注册的20台设备为准（如果第21台设备注册，则第一个注册的设备将会失效）。

< ">3.3其他个性化功能

< ">3.3.1定时推送

< ">开发者可以根据业务需求自定义消息推送时间，可以选择立即推送或指定时间推送。定时消息功能可以指定未来30天内任意时间作为消息下发时间。定时消息在消息开始推送之前可以通过推送运营平台-消息记录-详情中取消。

< ">3.3.2自定义消息有效期

< ">开发者可以根据自己的业务需求设置每条推送消息的有效期，推送的目标用户在消息有效期内网络在线就会收到消息。消息有效期最长14天。如果应用没有单独设置一条消息的有效期，小米推送的默认有效期也是14天。

< ">3.3.3自定义消息接收时间

< ">小米推送支持为每个客户端设定可接收推送时间，开发者可以设置接收消息推送时间段，不在该时间段的推送消息会被缓存起来，到了合适的时段再向App推送被缓存的消息；

< ">应用内设置免打扰时段的功能即可以通过自定义消息接收时间实现。

< ">3.3.4通知分类

< ">通知分类用来控制多条消息在通知栏内的替换关系。

< ">相同通知分类消息会存在替换（新的消息会覆盖之前的），不同类通知可以在通知栏并存。最多可以有10001类通知并存。

< ">因此，如果需要多条通知在通知栏内并存，请在推送时将将这些通知设置为不同的分类。

< ">3.3.5自定义键值对

< ">开发者可以自己输入一些自定义的键值对（key-value），在发送消息时传给客户端/服务端。客户端/服务端可以根据这些key-value可完成一些相应的操作。

< ">3.3.6自定义声音、振动、呼吸灯

< ">开发者可以自由控制推送消息到达时的提醒方式，同时可以自定义消息提醒的提示音。

< ">注：自定义提示音只能调用客户端存储的资源，需要由开发者自己制定资源位置。

< ">3.3.7 AB test多文案推送

< ">多文案推送方式是小米推送提供的通知栏消息自动化文案优选工具，旨在帮助开发者提高通知消息点击。开发者可在同一个推送计划中添加2-5条文案。推送开始后的前15分钟会进行预发送，每条文案发送相同数量的设备，15分钟过后系统会自动选择当前点击电商和营运率最高的消息作为最终文案，发送给剩余的设备。

< ">说明：

< ">注：

< ">预发送总量与目标总量的关系需要开发者自行保证。如果目标设备数＜文案条数x预发送数，则会直接按照文案顺序，以预发送数依次进行发送，发完为止。

< ">每条文案的测试消息会对应相应的jobkey，可在推送运营平台计划详情页进行查询。

< ">3.3.8平缓推送

< ">开启平缓推送功能，开发者可自行控制消息发送速度，让消息匀速的送达至设备，以降低大量消息对服务器造成的负担。

< ">平缓推送支持每秒1000~100000条消息，默认每秒3000条；

< ">3.3.9富文本消息

< ">富文本消息包括大文本和大图两种样式，并支持添加操作按钮。目前已经在小米推送国内和海外运营平台上线，同时也支持通过服务端API发送（Java SDK 2.2.20及以上版本）。国内版和海外版部分功能有所区别。

< ">注：推送运营平台AB test多文案功能只支持默认类型消息，不适用于富文本消息。

< ">3.3.10个性化场景推送

< ">根据网络环境推送

< ">开发者可以根据设备所处的环境进行推送：可以选择仅推送给处于WiFi环境下的用户。典型场景举例：视频类app可以推给WiFi条件下的用户，提升点击率。

< ">按照应用版本推送

< ">开发者可以通过指定应用的版本号来进行推送，可以选择某些版本接收消息/不接受消息。

< ">注：版本号需要开发者自己指定。

< ">按照机型推送

< ">开发者可以通过指定手机的品牌与机型来进行推送，可以选择某些版本接收消息/不接受消息。

< ">注：model需要开发者自己指定。

< ">< font-size: 18px;">4.使用推送

< ">4.1启用推送

< ">登录小米推送官网，注册开发者账号并创建App，通过管理控制台启用推送服务。

< ">注：小米推送服务的开通与使用与应用是否上架无关，应用不在应用商店上架也可使用小米推送。更改应用的归属关系、删除应用等行为，请通过【管理控制台】-【小米应用商店】-【更多服务】进行操作。

< ">4.2下载并集成客户端SDK

< ">SDK下载地址：http://dev.xiaomi.com/mipush/downpage/

< ">SDK集成和调试：

< ">小米推送服务的客户端SDK集成非常简单，仅需一位工程师0.5天的时间即可完成客户端SDK的集成。

< ">同时开发者也可以在接入SDK之前，通过接入demo的方式，快速体验小米推送的实际效果（仅限Android设备）。

< ">4.3推送实现方式

< ">4.3.1 API推送

< ">通过小米推送提供的API接口，开发者可以自行构建并发送消息。包括个性化功能实现、获取统计数据、追踪消息状态、拉取失效数据等。小米推送官方提供了JAVA服务端SDK版本，如果无法满足需求，我们同样提供了http API，开发者可以在底层接口上自行进行封装，满足各种定制化的推送需求。

< ">4.3.2推送运营平台

< ">推送运营平台是小米推送提供的管理和使用推送业务的一站式平台，通过运营平台开发者可以实现应用管理、消息下发、数据统计、使用人员管理等功能。

< ">推送运营平台网页版推送工具可以帮助开发者通过运营平台快速实现消息下发。

< ">支持通知栏消息和透传消息两种类型，同时支持多种推送方式和个性化推送。

< ">推送运营平台地址：http://admin.xmpush.xiaomi.com/

< ">< font-size: 18px;">5.推送统计

< ">小米推送支持推送数据实时统计功能，包括推送数据、APP数据、消息记录等维度，帮助开发者更好的监控和分析业务现状。

< ">开发者可以根据业务需求，登录推送运营后台查看，或者通过API接口获取。