tencent cloud

即时通信 IM

动态与公告
产品动态
公告
产品简介
产品概述
基本概念
应用场景
功能介绍
账号系统
用户资料与关系链
消息管理
群组相关
公众号系统
音视频通话 Call
使用限制
购买指南
计费概述
价格说明
购买指引
续费指引
停服说明
退费说明
开发指引
Demo 专区
开通服务
体验 Demo
快速跑通
下载中心
SDK & Demo 源码
更新日志
聊天互动(含 UI)
TUIKit 组件介绍
快速开始
全功能接入
单功能接入
AI 集成
构建基础界面
更多特性
定义外观
国际化界面语言
推送服务(Push)
服务概述
名词解释
开通服务
快速跑通
厂商通道
数据统计
排查工具
客户端 API
服务端 API
推送回调
高级功能
更新日志
错误码
常见问题
智能客服
功能概述
快速入门
集成指引
管理员操作手册
客服操作手册
更多实践
直播间搭建
AI 聊天机器人方案
超大娱乐协作社群
Discord 实现指南
游戏内集成 Chat 指南
类 WhatsApp Channel 搭建方案
发送红包
Chat 应对防火墙限制相关
无 UI 集成
快速开始
集成 SDK
初始化
登录登出
消息相关
会话相关
群组相关
社群话题
用户管理
离线推送
云端搜索
本地搜索
公众号
客户端 API
JavaScript
Android
iOS & macOS
Swift
Flutter
Electron
Unity
React Native
C 接口
C++
服务端 API
生成 UserSig
REST API
第三方回调
控制台指南
新版控制台介绍
创建并升级应用
基本配置
功能配置
账号管理
群组管理
公众号管理
回调配置
用量统计
资源包查看指南
实时监控
开发辅助工具
访问管理
高级功能
常见问题
uni-app 常见问题
购买相关问题
SDK 相关问题
账号鉴权相关问题
用户资料与关系链相关问题
消息相关问题
群组相关问题
直播群相关问题
昵称头像相关问题
协议与认证
服务等级协议
安全合规认证
IM 政策
隐私政策
数据隐私和安全协议
平滑迁移方案
平滑迁移完整版
平滑迁移简化版
错误码
联系我们

全员推送接口说明

PDF
聚焦模式
字号
最后更新时间: 2025-03-20 21:53:34

全员推送服务简介

全员推送服务是基于即时通信 Chat 通信架构实现的一组 REST API,用以支持 App 应用的全员推送、标签推送、属性推送等消息推送需求,客户端可通过 SDK 在线推送、离线推送(Android 后台通知和 APNs)接收推送的消息。同时全员推送支持消息的离线存储,帮助运营人员更高效地实现运营目标。
注意:
账号必须曾经登录过或者手动导入过该账号,才可以接收到全员推送的消息。
本功能仅针对专业版、专业版Plus或企业版客户开放(如您降级为标准版将无法使用),请参见 配置变更需求工单 指引,提交全员推送开通申请。申请通过后,该功能将在48小时后开启。

全员推送服务提供的基础能力

支持 App 内用户全员推送消息。
支持指定用户标签推送消息。
支持指定用户属性推送消息。

产品优势

全员推送服务基于客户端 Chat SDK 和即时通信 Chat 后台,在消息能力和系统可用性上有可靠保证:
基于 Chat SDK,保证消息可达,可简单为应用提供消息广播能力。
支持为每个用户设置最多10个推送属性,各属性可分别设置,互不影响。
属性推送支持选择多个属性的 and/or 逻辑进行推送。
标签推送同样支持选择多个标签的 and/or 逻辑进行推送。
支持只推在线用户,同时支持最长7天的消息离线存储(不支持撤回,不支持漫游)。
支持自定义消息。
支持指定发送方账号。

应用场景示例

全员推送场景示例

1. 例如,某款游戏计划在圣诞节推出优惠活动,为了达到运营效果,需要推送给全部用户。这时候就可以采用全员推送服务。此外,为了让更多的用户知道这个活动,可以设置消息离线存储时间。这样即便推送时某些用户不在线,但在离线存储时间范围内,这些用户上线时也能收到消息,从而提升活动质量效果。
2. 例如,某款直播 App 计划举行一场大型的直播带货活动,需要推送通知给全部用户,这时候就可以在活动开始前7天进行全员推送,同时设置消息离线存储时间为7天。到了活动开始的时间,也可以进行全员推送,不设置消息离线存储时间,这样在线的用户都可以收到活动开始的通知,从而进入直播间,提高直播间人气。

按用户标签推送场景示例

例如,某金融产品计划给那些关注“股票 A”或者“股票 B”的用户推送某一理财服务。这时就可以使用标签推送:
1. 当有用户关注“股票 A”或者“股票 B”时,调用添加标签接口,给该用户加上对应的标签。
2. 当有用户取消关注“股票 A”或者“股票 B”时,调用删除标签接口,删除该用户的对应标签。
3. 在推送接口中设置推送标签条件为“股票 A”或“股票 B”(即 TagsOr 功能),于是所有关注“股票 A”或者“股票 B”的用户都可以收到消息。

按用户属性推送场景示例

例如,某款游戏的用户会员级别有:非会员、普通会员、黄金会员、超白金会员。现在运营人员计划给在深圳的超白金会员用户推送某一活动。此时就可以使用按属性推送:
1. 设置应用属性名称。该示例中的游戏用户有两个属性:会员等级和所在城市。因此可以设置属性0为会员等级,属性1为所在城市。
2. 当用户会员级别改变时(例如会员到期或者用户充值买会员时),调用设置用户属性接口,更改用户的会员等级属性。如充值买黄金会员时,设置用户的会员等级属性为“黄金会员”即可。
3. 当用户更改所在城市时,同样调用设置用户属性接口,更改用户的所在城市属性。如从北京改为上海时,设置用户的所在城市属性为“上海”即可。
4. 运营活动时,即可调用推送接口,将推送属性条件设为:会员等级为超白金用户并且所在城市为深圳,则所有在深圳的超白金会员用户就能收到消息。
注意:
上述场景属性推送比标签推送更适合。因为使用标签推送的话,当用户所在城市从深圳变为广州,那么应用得先删除用户的"深圳"标签,然后再给用户添加上"广州"的标签,需要调用两次接口。而属性推送的话,直接修改用户所在城市属性即可,只需一次接口调用。

相关API

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈