把未读数显示在 App 图标上
角标是您能对海外用户说的最简短的一句话,用户读它不费任何成本。在与其他推送相同的活动和 Customer Journey 中设置、递增或清零角标。
超过 80,000 家企业借助 Pushwoosh 扩大用户互动
角标全解析
角标只是一个整数,这正是它的魅力所在。它不占横幅、不响提示音,不消耗您好不容易争取到的推送权限,对三小时前划掉您推送的用户依然有效。您可以在编辑器或 API 中对这个整数做三件事,另外还有一个关于显示位置的注意事项。
精确数值
ios_badges: 5 会把图标上的角标设为 5,无论之前是多少。您发送的值就是用户看到的值,适合服务端已经掌握真实总数的场景。
+1 和 -1
相对变化可以增减角标数,无需您自行追踪。SDK 通过内部 /setBadge 接口回传设备上的值,让 Pushwoosh 的计数器与实际图标保持一致。
0 清除角标
发送 0,角标即从图标上消失。打开时清零,决定了用户是信任这个数字,还是学会忽略红点。
iOS 统一,Android 取决于启动器
在 iOS 上,角标是标准的 aps.badge 值,所有设备显示方式一致。Android 没有原生角标 API,显示效果取决于启动器,Pushwoosh 会如实说明,而不是暗示无法实现的覆盖范围。
您可以控制什么
| 发送内容 | 角标数如何变化 | 设置位置 |
|---|---|---|
整数,5 | 将角标精确设为该值 | ios_badges / android_badges,或 Badges 字段 |
+1、+3 | 在当前计数上递增 | 同一字段,Android 推送预设中也支持 +n |
-1 | 在当前计数上递减 | 同一字段,用于服务端的已读或关闭操作 |
0 | 从图标上移除角标 | 同一字段,或 App 启动时清除 |
| SDK 调用 | 根据应用内事件设置或清除角标 | iOS 上为 setApplicationIconBadgeNumber,Android 上为 PushwooshBadge |
| 不做任何操作 | SDK 应用随推送到达的角标值 | iOS 基础场景无需 App 代码 |
| 扩展 | 在通知显示前修改计数 | PWNotificationExtensionManager 搭配 App Groups |
5ios_badges / android_badges,或 Badges 字段+1、+3+n-10setApplicationIconBadgeNumber,Android 上为 PushwooshBadgePWNotificationExtensionManager 搭配 App Groups在哪里设置
编辑器中的 Badges 字段
Send-Push 表单和推送预设支持填写数字、+n、-n 或 0。修改活动对角标的操作无需发版,也无需开发人员。
API 中的一个键
/createMessage 中的 ios_badges 和 android_badges。在 iOS 上,该值会写入 Apple 原有 payload 的 aps.badge 字段。
由 SDK 应用并同步
SDK 无需 App 代码即可应用到达的角标值,并通过 /setBadge 让服务端的角标值保持最新,确保 +1 从正确的数字开始计算。
在用户旅程中发挥作用
一个计数,多个来源
角标是您已在发送的消息的一个属性,无需单独集成。决定谁收到推送的同一个 Customer Journey 和同一份用户档案,也决定角标数变成多少。
因此唯一需要考虑的是:这个数字由什么驱动。Message Inbox 的未读总数可以直接作为计数,静默推送可以在不提醒用户的情况下改变它,可见的 移动推送 也可以顺带更新它。在旅程目标处加一步,即可将它清零为 0。
出海手游:玩家离线时累积三份奖励
每发放一份奖励都会触发一个事件,每个事件发送一条增加 +1 的静默推送。不响铃、不点亮锁屏,到了晚上,图标上悄悄显示 3。
当限时活动开启时,同一个旅程会发送一条值得打扰玩家的可见推送。无论是哪一种方式把玩家带回游戏,SDK 都会在启动时将角标清零为 0,让第二天的计数从真实的数字开始。
适用场景
角标的价值取决于计数密度:您的 App 是否真的有一个不断累积、值得显示在图标上的未读或待处理数量。以计数为核心的 App 可以免费获得真正的回访提示,而没有东西可计数的 App 只会得到一个让用户学会忽略红点的红点。
| 场景 | 数字代表什么 | 为什么适合角标 |
|---|---|---|
| 出海手游:奖励、体力恢复、活动入场 | 3 份待领取 | 计数本身就是留存循环的一部分,领取正是玩家的核心动机 |
| 跨境电商与交易平台:购物车商品、未读优惠 | 购物车中有 2 件商品 | 安静的提醒,购物者接收时无需分心 |
| 创作者与订阅类 App:新内容、私信、评论 | 12 条未读 | 社交信息流内部已经在维护这个数字,图标只需显示出来 |
| 媒体与新闻:未读文章、新剧集 | 5 篇未读文章 | 最典型的用例,能稳定地把读者带回 App |
| 金融科技:对账单、提醒、待处理操作 | 1 项待处理 | 确有未读文档计数,图标承载数字,不在锁屏上暴露细节 |
| 交易与竞猜:已触发提醒、已结算注单 | 已触发 4 条提醒 | 提醒累积成对用户真正有意义的数字 |
| 医疗与远程问诊:检查结果、安全消息 | 您的检查结果已出 | 计数显示在主屏幕上,内容仍在身份验证之后 |
| 在线教育:未读课程、连续学习、作业 | 2 节课待学习 | 连续打卡或课程队列正是人们想要清零的数字 |
什么时候不该用角标
角标只报告数量。等待中的内容是什么、有多紧急,都属于其他触点。
- 用户需要知道收到了什么:请使用 移动推送、富媒体推送或 应用内消息。
- 刻不容缓的时刻。角标天生是被动的,紧急情况应使用 中断级别。
- 持续变化而非计数的状态:配送中的订单、实时比分。这应使用 Live Activity。
- App 没有天然累积的计数。保险、酒店、公共事业和单次使用的工具只有一张账单或一份预订,角标在这里只是噪音。
- 您的受众以 Android 为主,而角标又是核心机制。在 Android 上应把它视为尽力而为,并设计无需角标也能运转的流程。
平台与技术支持
iOS 只有一种角标,每部 iPhone 的显示方式都相同。Android 没有通用的角标 API,主屏幕上显示什么取决于用户当前使用的启动器。最后一列列出了实际绘制数字的组件,因为对这个功能而言,真实答案就在那里。
| 能力 | iOS | Android | Web | 实现方式 |
|---|---|---|---|---|
| 精确角标值 | 支持,标准 aps.badge | 尽力而为,取决于启动器 | – | 推送 payload,由 SDK 应用 |
相对 +1 和 -1 | 支持,Pushwoosh SDK 6.4.0+ | 推送预设中的 +n,取决于启动器 | – | 推送,由 /setBadge 保持计数同步 |
清零为 0 | 支持 | 取决于启动器 | – | 推送 payload,或 App 启动时 |
| 无代码 Badges 字段 | 支持,编辑器和推送预设中 | 支持,推送预设中的角标值 | – | Pushwoosh Control Panel |
| 通过 App 代码设置或清除 | setApplicationIconBadgeNumber | PushwooshBadge | – | 您的 App,通过 Pushwoosh SDK |
| 显示前修改计数 | 支持,在 Notification Service Extension 中 | – | – | PWNotificationExtensionManager 搭配 App Groups |
| 无提醒更新角标 | 支持 | 尽力而为 | – | 静默推送,相同受众和旅程 |
| 启动器和设备覆盖 | 所有 iPhone,显示一致 | Sony、Samsung、LG、HTC、ASUS、ADW、APEX、NOVA、Huawei、ZUK、OPPO | – | com.pushwoosh:pushwoosh-badge 搭配启动器权限 |
| Pixel 及不支持的启动器 | 不适用 | – | – | Android 没有原生角标 API,因此不会显示 |
| 从系统读取当前计数 | – | – | – | iOS 不提供读取 API,计数保存在您的 App 或服务端 |
| App 图标角标本身 | 支持 | 取决于启动器 | – | 浏览器没有供 Web 推送使用的对应触点 |
aps.badge+1 和 -1+n,取决于启动器/setBadge 保持计数同步0setApplicationIconBadgeNumberPushwooshBadgePWNotificationExtensionManager 搭配 App Groupscom.pushwoosh:pushwoosh-badge 搭配启动器权限安全与托管
Pushwoosh 运行在位于美国和德国的自有硬件上,遵循 GDPR。
工作原理
设置角标无需代码,所有套餐均免费可用。开发工作只集中在两个小地方,而且都不涉及 iOS 基础场景。
-
设置计数 (无代码)
在 Send-Push 表单或推送预设的 Badges 字段中填写数字、
+n、-n或0,或通过 Messages API 发送ios_badges和android_badges。iOS 基础场景无需 App 做任何事:SDK 会在推送到达时应用该值。 -
接入需要开发的两处 (开发人员)
Android 需要
com.pushwoosh:pushwoosh-badge库,并在 manifest 中添加各启动器所需的权限。在打开推送和启动 App 时清零只需一次 SDK 调用;只有在通知显示前必须修改计数时,才需要搭配 App Groups 的 Notification Service Extension。 -
编排 (无代码)
用 Message Inbox 的未读总数驱动计数,用不带提醒的静默推送改变它,并在同一个 Customer Journey 的目标处清零——推送、应用内消息和邮件都在这个旅程中运行。
需要了解的限制
探索相关产品
Pushwoosh 移动推送通知帮助出海企业通过 FCM、APNs、华为 HMS 和 Amazon ADM 触达全球每一台设备,配合精准定向、全渠道 Journey 编排和 99% 高可用交付,把推送变成忠实付费用户。
Message Inbox 为 App 和网站加入应用内消息中心。静默送达覆盖所有海外用户,包括关闭推送的用户,保存的消息可随时回看。
使用一个可视化工具规划并优化您的营销活动。利用 Pushwoosh Customer Journey Builder 进行沟通、吸引、留存、转化、细分和实验。
Pushwoosh 应用内消息:在海外用户活跃的那一刻完成引导、追加销售、公告推送与反馈收集。无代码编辑器、原生 SDK 渲染模板、逐元素数据分析,符合 GDPR,欧盟数据中心托管,免费开始使用。
为已在发送的推送设置 iOS 中断级别,让欺诈提醒、骑手到门或登机口变更穿透专注模式和定时摘要。在 Pushwoosh 控制面板中无代码开启。
专为游戏应用打造的移动推送通知平台。发送个性化警报、特别优惠和活动提醒,让玩家持续回归。