本文将介绍如何完成 vivo 离线推送服务厂商配置。
前提条件
开始前,请确认您已具备以下条件:
条件 | 说明 |
vivo 开发者账号 | 用于登录 vivo 开放平台并创建应用。 |
已上架 vivo 应用商店的 Android 应用 | 正式通知推送要求应用已上架 vivo 应用商店。未上架应用的推送权限受限,只能在 API 后台向测试设备发送测试消息。 |
Android App 包名 | vivo 开放平台中的应用包名必须与 Android 工程的 applicationId 保持一致。 |
腾讯云账号和即时通信 IM 应用权限 | 用于在腾讯云控制台添加 vivo 厂商证书。 |
注意:
如果应用未上架 vivo 应用商店,不可在 vivo 官网 Web 界面和 API 后台发送正式消息,只能向设置的测试设备发送测试消息。
vivo 开放平台配置
提示:
注册 vivo 开发者账号
创建应用
进入 vivo 开放平台,单击分发 > 应用分发 > 应用商店 > 上传应用,创建您的应用。

警告:
vivo 开放平台中的应用包名必须与 Android 工程的
applicationId 保持一致。包名不一致可能导致后续 SDK 注册失败或推送设备无法正确匹配。开通推送服务
进入vivo 开放平台管理中心,单击推送服务 > 推送申请,为目标应用申请开通推送服务。


获取应用信息
进入 vivo 推送运营平台,单击应用管理 > 应用信息,查看并记录腾讯云控制台配置 vivo 证书所需的应用信息。

腾讯云控制台配置
添加 vivo 厂商证书
vivo 推送平台 | 腾讯云即时通信 IM 控制台 |
![]() | ![]() |
配置回执和点击统计
如需统计消息触达或点击数据,请在 vivo 开放平台设置 App 回执地址为:
https://api.im.qcloud.com/v3/offline_push_report/vivo,并在腾讯云控制台设置回执 ID。回调地址配置 | 腾讯云即时通信 IM 控制台 |
![]() | ![]() |
消息分类限制对推送效果的影响
vivo 会将推送消息分为系统消息和运营消息。消息分类会影响日推总量、单设备每日接收数量和夜间发送策略。IM 聊天、订单变动、账号安全等需要及时触达的消息,建议按 vivo 规则申请并使用系统消息能力。
消息类型 | 推送影响 | 适用建议 |
系统消息 | 适合及时触达;默认每日限额按通知开启有效用户数计算,可申请不限量权限。系统消息仍可能被 vivo 智能分类二次修正。 | 适用于聊天消息、订单变动、账号安全等用户有明确预期的消息。 |
运营消息 | 新闻类和其他类按通知开启有效用户数计算日推总量;单设备每日接收数量有限;夜间发送会受限制。 | 适用于活动、内容推荐、营销推广等非即时消息。 |
警告:
vivo 会对系统消息进行智能分类二次修正。如果厂商识别出消息内容不属于系统消息,可能自动修正为运营消息。正式上线前,请确认消息内容和所申请的消息分类匹配。
运营消息存在发送时间限制。vivo 服务器通常仅允许在
7:00 - 23:00 之间下发运营消息,在 23:00 - 次日 7:00 发送的运营消息会被服务器直接丢弃,不会延迟补发。系统消息不受此限制。完成 vivo 平台和腾讯云控制台配置后,后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置 vivo
Category。两者同时设置时,API 中的设置优先于控制台证书默认配置。具体 API 使用方式请参见 Android SDK 接入文档中的 配置消息分类(可选)。配置完成检查
完成本篇配置后,请按顺序检查:
检查项 | 预期结果 |
应用上架状态 | 正式推送使用的应用已在 vivo 应用商店上架;未上架应用仅用于测试设备测试。 |
包名一致性 | vivo 开放平台应用包名与 Android 工程 applicationId 完全一致。 |
PUSH 服务状态 | 目标应用已申请并开通 vivo 推送服务。 |
应用参数 | 已记录腾讯云控制台配置 vivo 证书所需的应用信息。 |
腾讯云厂商证书 | 已在腾讯云控制台添加 vivo 证书,并填写正确参数。 |
回执和点击统计 | 如需统计,已按消息触达统计配置完成回执相关配置。 |
消息分类配置 | 如需 IM 消息及时触达,已申请系统消息能力,并在 API 或腾讯云控制台默认 Category 中完成配置。 |
运营消息限制 | 如果业务消息属于运营消息,已确认单设备接收数量限制和 7:00 - 23:00 下发时间限制,避免夜间发送后被直接丢弃。 |



