一．vivo推送简介

vivo推送（即Vpush）是vivo公司向开发者提供的消息推送服务，通过在云端与客户端之间建立一条稳定、可靠的长连接，为开发者提供向客户端应用实时推送消息的服务，支持百亿级的通知/消息推送，秒级触达移动用户。

开发者可以方便地通过嵌入SDK，调用API或者Web端进行可视化操作，实现对特定用户人群推送，大幅提升用户活跃度，有效唤醒沉睡用户，并实时查看推送效果。

二．产品优势

1．系统级通道

vivo推送在手机上的长连接由系统维护，能够充分的保障通知栏消息在vivo上的送达率。设备联网的情况下，有效推送的送达率能达到99.9%以上。

2．用户优质、流量丰富、赋能营销

拥有庞大的有活力、有潜力的优质用户，助力精细化优质应用推广、不断汇聚vivo全生态优质应用推广流量，满足日益增长的获客诉求、并通过强大个性化算法能力、完整营销闭环赋能智慧营销。

3．稳定、安全、高性能、快捷

支持每秒100w推送速度，亿级用户同时在线，稳定性好，安全性高，快速集成SDK，提供Web平台和API两种运营推送方式，有效提升运营效率。

4．全面的数据统计

推送平台提供包括APP数据、消息数据等多维度的统计，同时支持小时级实时数据，帮助开发者更好的掌握应用数据，助力精细化运营。

5．定时推送

开发者可以根据业务需求自定义消息推送时间，可以选择立即推送或指定时间推送。

6．在线诊断工具

vivo推送提供一站式服务能力，一套完备的调查工具可以辅助开发者自助查询设备与消息的对应关系与送达/在线情况，实时把控消息状态。

三．功能介绍

1．运营推送方式

vivo推送支持通知栏提醒消息类型，同时提供web平台和API两种运营推送方式。

① API推送

通过vivo推送提供的API接口，开发者可构建并发送消息。并提供个性化功能，包括获取统计数据、查询消息状态、获取失效数据等。

vivo推送官方提供了JAVA、PYTHON服务端SDK版本，如果无法满足需求，我们提供了http API，开发者可以自行进行封装调用，满足各种定制化的推送需求。

详细介绍请参见《服务端SDK文档》、《服务端API接口文档》

② 推送运营平台

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

推送运营平台网页版推送工具可以帮助开发者通过运营平台快速实现消息下发。支持通知栏消息消息推送，同时支持多种推送方式和个性化推送。

点击进入：推送运营平台

2．通知栏展示

消息通过vivo push系统通道下发，不需要应用驻留后台。客户端收到这类消息后，会直接在通知栏展现。

用户点击弹出通知后，客户端SDK会将消息中携带的数据传递给应用，由应用决定下一步的动作。 

通知栏消息展示效果如图所示，主要内容包括消息标题、摘要、应用图标、应用名称和时间，开发者可以自定义标题和摘要。

同时，针对每条消息开发者也可以单独定义是否响铃/振动（只对Android8.0以下）。

注： 在vivo push中，由于通知栏是由vivo服务框架弹出，因此图标均不可自定义，且部分版本不展示右侧小图标。

3．推送方式

vivo推送支持RegID、Alias、标签等消息发送方式。

① 基于 RegID的推送

RegID为vivo推送为每个设备上的每个app注册推送服务时生成的唯一标示。

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

注：

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

• RegID在应用卸载或清除本地数据后重新卸载、14天不在网后又重新联网regid均不会变。

• RegID在如下几种情况下会被判断失效：

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

    B .  App调用了turnOffpush

    C .  在vivo上，App卸载时，如果能成功上报，则RegID会被判定失效

    D .  设备超过14天没有和vivo Push服务器建立长连接

② 基于 Alias的推送

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

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

注：

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

• alias失效的可能原因如下：主动调用unsetalias；alias对应的RegID已经失效

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

③ 基于标签的推送

对应用下已订阅vivo推送的设置了标签的用户进行推送。在推送消息时，开发者可以结合每条消息的内容和目标用户人群，选择所对应的标签，完成请求后，vivo推送推送服务会向所有打上这一标签的用户发送该消息，从而满足定向推送的需求，并提供标签管理功能。

四. 其他个性化功能

1. 定时推送

开发者可以根据业务需求自定义消息推送时间，可以选择立即推送或指定时间推送。

定时消息功能可以指定未来30天内任意时间作为消息下发时间。

定时消息在消息开始推送之前可以在“消息推送平台-推送设置-待发送消息”中取消。

2.自定义消息有效期

开发者可以根据自己的业务需求设置每条推送消息的有效期，推送的目标用户在消息有效期内网络在线就会收到消息。

消息有效期最长7天。如果应用没有单独设置一条消息的有效期，vivo推送的默认有效期是1天。 

3.自定义键值对

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

4.自定义push提示声音

vivo提供Push通知铃声、震动、铃声+震动、无等提示方式，开发者可以自由控制推送消息到达时的提醒方式。

5.推送标题和内容支持添加emoji表情

开发者可在新建推送输入推送标题和内容时，插入emoji表情（分别最多不超过3个）以丰富推送内容，吸引用户点击了解推送内容。

6.AB test分组对比测试

vivo推送支持AB test分组对比测试，开发者可通过AB test分组对比测试为开发者提供精细化运营手段，通过AB test的结果由数据来做出决策，在运营中继续获得确定的用户增长。

vivo推送的AB test分组对比测试支持对比通知文案测试、对比用户群体测试、自动发送和手动发送以及独立的数据统计助力开发者的运营活动。

• 对比通知文案：向同类人群发送多个文案（上限为4个），筛选出最佳数据指标的文案进行正式组推送。

• 对比用户群体：将多个人群（上限为4个）发送一个文案，筛选出此文案最佳受众人群进行正式组推送。

• 发送形式：分为自动推送和手动推送

①自动推送：自动发送将会在选择的文案判别时间内收集数据，根据所选择的文案选择指标，在测试结果返回判断后自动发送最佳文案。

②手动推送：会将手动测试的结果保存在消息记录中，在消息记录中根据心仪数据继续手动发送。可选手动发送时间将从AB test测试组发送完成后开始计时三天，超过三天的手动发送AB test将不可继续手动发送。

• 数据统计：数据统计可在消息记录中实时查询，可同时观测测试组发送情况与正式组选择情况。实时转化、消息折损与推送时效将同步在AB test的消息记录中。

7.平缓推送

开启平缓推送功能，开发者可根据自身需要自行设定消息发送速度，使消息以均匀的速度送达用户设备，降低大量消息发送对服务器造成的压力和负担。

平缓推送支持每秒发送500-100000消息，打开开关默认速度为3000条/s

五．使用推送

1. 启用推送

登录vivo开放平台，注册开发者账号并创建APP审核通过之后，新建推送启用推送服务。详细介绍请参见《vivo推送使用指南》。

2. 集成客户端SDK

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

《服务端SDK文档》

《客户端SDK集成指南》

3. 推送统计

vivo推送支持推送数据实时统计功能，包括推送数据、APP数据等维度，帮助开发者更好的监控和分析业务现状。

六．常见问题

关于推送接入及后续使用的常见问题，可以参考《常见FAQ》