← 资料库索引 ← 官方文档 原始链接 ↗ 🔍
官方文档

友盟 U-Push 名词解释（Device Token 等） 原文标题：

发表时间：（页面未标注）采集时间：2026-10-09 10:34:51来源：developer.umeng.com原文语言：zh状态：完整
原始链接：https://developer.umeng.com/docs/67966/detail/98598
设备标识推送SDKDeviceToken友盟

内容概要总结

友盟消息推送 U-Push 官方文档「名词解释」页。逐一解释推送体系中的关键名词：Appkey（应用唯一标识，与友盟统计共用同一套）、Umeng Message Secret、App Master Secret（服务器秘钥，用于服务端调用 API 时的签名验证）、Device Token（友盟消息推送服务对设备的唯一标识，Android 的 device_token 为 44 位字符串，iOS 为 64 位）、Alias（开发者自有账号，可通过 setAlias(alias, alias_type) 与 device_token 绑定，绑定关系存储 180 天）。

并定义各类推送类型：单播(unicast)、列播(listcast)、广播(broadcast)、组播(groupcast)、文件播(filecast)、自定义播(customizedcast)，以及通知/消息在 Android、iOS 上的差异（通知-Android 由友盟 SDK 接管并在通知栏展示，消息-Android 透传给应用自身解析，通知-iOS 与静默推送-iOS 与 APNs 定义一致）。同时说明测试模式（仅发送给手工添加的测试设备；iOS 测试模式对应 APNs sandbox、正式模式对应 prod）与推送类型分类（单播类消息 vs 任务类消息）。

文末给出生产环境发送限制：广播每分钟 1 次、每天 10 次；组播与文件播每分钟 5 次、每天 500 次；单播类消息共享推送频次。

原文内容（原文即中文）

⚠ 说明：原站直连 SSL 握手失败（UNEXPECTED_EOF），浏览器桥接亦无法建立连接；正文经 curl 抓取页面 HTML 后提取主体。页面为 Next.js 渲染，正文为文档「名词解释」+「发送限制」两节。

名词解释

  • Appkey：应用唯一标识。友盟消息推送服务提供的appkey和友盟统计分析平台使用的同一套appkey。
  • Umeng Message Secret：Umeng Message Secret是和AppKey相对应的，用来关联唯一的应用，用于SDK集成。
  • App Master Secret：服务器秘钥，用于服务器端调用API请求时对发送内容做签名验证。
  • Device Token：友盟消息推送服务对设备的唯一标识。Android的device_token是44位字符串，iOS的device_token是64位。
  • Alias：开发者自有账号，开发者可以在SDK中调用setAlias(alias, alias_type)接口将alias+alias_type与device_token做绑定，之后开发者就可以根据自有业务逻辑筛选出alias进行消息推送。alias绑定关系存储180天，若需长时间调用需在180天内重复上报alias关系对。
  • 单播(unicast)：向指定的设备发送消息。列播(listcast)：向指定的一批设备发送消息，是单播的一种形式。
  • 广播(broadcast)：向安装该App的所有设备发送消息。
  • 组播(groupcast):：向满足特定条件的设备集合发送消息，例如: “特定版本”、”特定地域”等。
  • 文件播(filecast)：开发者将批量的device_token或者alias存放到文件，通过文件ID进行消息发送。
  • 自定义播(customizedcast)：开发者通过自有的alias进行推送，可以针对单个或者一批alias进行推送，也可以将alias存放到文件进行发送。
  • ※※安卓端针对90天内活跃设备推送※※
  • 通知-Android(notification)：消息送达到用户设备后，由友盟SDK接管处理并在通知栏上显示通知内容。
  • 消息-Android(message)：消息送达到用户设备后，消息内容透传给应用自身进行解析处理。
  • 通知-iOS：和APNs定义一致。
  • 静默推送-iOS：和APNs定义一致。
  • 测试模式：在广播、组播等大规模发送消息的情况下，为了防止开发者误将测试消息大面积发给线上用户，特增加了测试模式。 测试模式下，只会将消息发送给测试设备。测试设备需要到管理后台上手工添加。
  • 测试模式-Android：Android的测试设备是正式设备的一个子集
  • 测试模式-iOS： iOS的测试模式对应APNs的开发环境(sandbox), 正式模式对应APNs的生产环境(prod)，测试设备和正式设备完全隔离。
  • 签名： 为了保证调用API的请求是合法者发送且参数没有被篡改，需要在调用API时对发送的所有内容进行签名。签名附加在调用地址后面，签名的计算方式参见附录I。
  • 推送类型：单播(unicast)、列播(listcast)、自定义播(customizedcast且不带file_id)统称为单播类消息，管理后台不会展示此类消息详细信息，仅展示前一天的汇总数据；广播(broadcast)、文件播(filecast)、组播(groupcast)、自定义播(customizedcast且file_id不为空)统称为任务类消息，任务类消息支持API查询、撤销操作，管理后台会展示任务类消息详细信息。

发送限制

为了提供更加稳定高效的推送环境，生产环境下有以下发送限制（同测试环境）：

  • 广播(broadcast)默认推送频次每分钟1次，每天可推送10次
  • 组播(groupcast)默认推送频次每分钟5次，每天可推送500次
  • 文件播(filecast)默认推送频次每分钟5次，每天可推送500次
  • 单播类消息共享推送频次