읽지 않은 수를 앱 아이콘에 표시하세요
배지는 사용자에게 건넬 수 있는 가장 작은 메시지이며, 읽는 데 아무 부담도 주지 않습니다. 다른 모든 메시지와 같은 캠페인과 고객 여정에서 배지를 설정하고, 늘리고, 초기화하세요.
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 | 아이콘에서 배지 제거 | 같은 필드 또는 앱 실행 시 앱에서 |
| SDK 호출 | 인앱 이벤트에서 배지를 설정하거나 초기화 | iOS는 setApplicationIconBadgeNumber, Android는 PushwooshBadge |
| 아무것도 보내지 않음 | SDK가 푸시와 함께 도착한 배지 값을 적용 | iOS 기본 사용 시 앱 코드 불필요 |
| 확장 프로그램 | 알림이 표시되기 전에 숫자를 변경 | App Groups와 함께 PWNotificationExtensionManager |
5ios_badges / android_badges 또는 Badges 필드+1, +3+n 사용 가능-10setApplicationIconBadgeNumber, Android는 PushwooshBadgePWNotificationExtensionManager설정 위치
작성 화면의 Badges 필드
Send-Push 양식과 푸시 프리셋에 숫자, +n, -n 또는 0을 입력합니다. 캠페인이 숫자를 바꾸는 방식을 변경하는 데 릴리스도, 개발자도 필요하지 않습니다.
API의 키 하나
/createMessage의 ios_badges와 android_badges. iOS에서는 이 값이 Apple이 이미 전달하는 페이로드의 aps.badge 필드로 들어갑니다.
SDK가 적용하고 동기화
SDK가 앱 코드 없이 도착한 값을 적용하고, /setBadge로 서버의 배지 값을 최신 상태로 유지하므로 +1이 올바른 숫자부터 계산됩니다.
고객 여정 안에서 하는 역할
하나의 숫자, 여러 소스
배지는 이미 발송하는 메시지의 속성이므로 별도 연동이 필요 없습니다. 누가 푸시를 받을지 정하는 같은 고객 여정과 같은 고객 프로필이 숫자도 결정합니다.
남은 질문은 숫자를 무엇으로 채울지뿐입니다. 메시지 인박스의 읽지 않은 메시지 수를 그대로 배지로 쓸 수 있고, 사일런트 푸시는 알림 없이 숫자를 바꾸며, 일반 모바일 푸시는 배지 값을 함께 실어 보냅니다. 고객 여정의 목표 단계에서 다시 0으로 되돌립니다.
플레이어가 없는 동안 쌓이는 세 개의 보상
보상이 지급될 때마다 이벤트가 발생하고, 각 이벤트는 +1을 더하는 사일런트 푸시를 보냅니다. 알림음도 잠금 화면 표시도 없이, 저녁이 되면 아이콘에 조용히 3이 표시됩니다.
라이브 이벤트가 열리면 같은 고객 여정이 방해할 가치가 있는 일반 푸시 하나를 보냅니다. 둘 중 무엇이 플레이어를 다시 불러오든, SDK는 앱 실행 시 배지를 0으로 초기화하므로 다음 날의 숫자는 정확한 값에서 시작합니다.
활용 사례
배지의 효과는 숫자의 밀도에 비례합니다. 즉, 앱에 아이콘에 표시할 만한 읽지 않은 항목이나 대기 중인 항목이 실제로 쌓이는지에 달려 있습니다. 카운터 중심의 앱은 리인게이지먼트 효과를 덤으로 얻고, 셀 것이 없는 앱은 사용자에게 빨간 점을 무시하는 습관만 들이게 됩니다.
| 상황 | 숫자의 의미 | 배지가 적합한 이유 |
|---|---|---|
| 모바일 게임: 보상, 충전된 생명, 이벤트 참여권 | 받을 항목 3개 | 숫자가 이미 리텐션 루프의 일부이며, 받는 것 자체가 동기 |
| 크리에이터 및 구독 앱: 신규 콘텐츠, DM, 댓글 | 읽지 않음 12개 | 소셜 피드는 이미 이 숫자를 내부에서 관리하므로 아이콘에 보여주기만 하면 됨 |
| 미디어 및 뉴스: 읽지 않은 기사, 새 에피소드 | 읽지 않은 기사 5개 | 대표적인 활용 사례이며, 독자를 다시 세션으로 불러오는 확실한 방법 |
| 이커머스 및 마켓플레이스: 장바구니 상품, 읽지 않은 혜택 | 장바구니에 상품 2개 | 쇼핑객의 주의를 빼앗지 않는 조용한 리마인더 |
| 핀테크: 명세서, 알림, 처리 대기 작업 | 처리할 작업 1개 | 실제 읽지 않은 문서 수가 있으며, 잠금 화면에 세부 내용을 노출하지 않고 아이콘이 숫자만 전달 |
| 트레이딩 및 베팅: 발생한 알림, 정산된 베팅 | 발생한 알림 4개 | 알림이 쌓여 사용자에게 실제로 의미 있는 숫자가 됨 |
| 헬스케어 및 원격 진료: 검사 결과, 보안 메시지 | 검사 결과가 도착했습니다 | 숫자는 홈 화면에 표시되고, 내용은 인증 뒤에 안전하게 유지 |
| 에듀테크: 읽지 않은 강의, 연속 학습, 과제 | 대기 중인 강의 2개 | 연속 학습이나 강의 대기열은 사람들이 끝까지 해결하려는 바로 그런 숫자 |
배지가 적합하지 않은 경우
배지는 수량을 알립니다. 무엇이 기다리고 있는지, 얼마나 급한지는 다른 채널의 몫입니다.
- 사용자가 무엇이 도착했는지 알아야 하는 경우: 모바일 푸시, 리치 미디어 푸시 또는 인앱 메시지를 사용하세요.
- 기다릴 수 없는 순간: 배지는 본래 수동적이므로, 긴급한 내용은 인터럽션 수준이 담당합니다.
- 숫자가 아닌 진행 중인 상태: 배송 중인 주문이나 진행 중인 경기 점수는 Live Activity의 영역입니다.
- 자연스럽게 쌓이는 숫자가 없는 앱: 보험, 호텔, 공공요금, 단일 세션 도구는 청구서나 예약이 하나뿐이어서 배지가 소음이 됩니다.
- Android 비중이 높은 오디언스에서 배지를 핵심 기능으로 쓰려는 경우: 이때 배지는 최선의 노력 수준으로 보고, 배지 없이도 작동하도록 흐름을 설계하세요.
플랫폼 및 기술 지원 범위
iOS에는 배지가 하나뿐이며, 모든 iPhone이 같은 방식으로 표시합니다. Android에는 범용 배지 API가 없어 홈 화면에 무엇이 표시될지는 사용자가 쓰는 런처에 달려 있습니다. 이 기능에서는 실제로 숫자를 그리는 주체가 가장 정확한 답이므로, 마지막 열에 이를 명시했습니다.
| 기능 | iOS | Android | Web | 제공 주체 |
|---|---|---|---|---|
| 정확한 배지 값 | 지원, 표준 aps.badge | 최선의 노력, 런처에 따라 다름 | – | 푸시 페이로드, SDK가 적용 |
상대 값 +1과 -1 | 지원, Pushwoosh SDK 6.4.0+ | 프리셋의 +n, 런처에 따라 다름 | – | 푸시, /setBadge로 카운터 동기화 |
0으로 초기화 | 지원 | 런처에 따라 다름 | – | 푸시 페이로드 또는 앱 실행 시 앱에서 |
| 노코드 Badges 필드 | 지원, 작성 화면과 프리셋 | 지원, 프리셋의 배지 값 | – | Pushwoosh Control Panel |
| 앱 코드에서 설정 또는 초기화 | setApplicationIconBadgeNumber | PushwooshBadge | – | Pushwoosh SDK를 통해 앱에서 |
| 표시 전 숫자 변경 | 지원, Notification Service Extension에서 | – | – | App Groups와 함께 PWNotificationExtensionManager |
| 알림 없이 배지 업데이트 | 지원 | 최선의 노력 | – | 같은 오디언스와 고객 여정의 사일런트 푸시 |
| 런처 및 기기 지원 범위 | 모든 iPhone에서 동일 | Sony, Samsung, LG, HTC, ASUS, ADW, APEX, NOVA, Huawei, ZUK, OPPO | – | 런처 권한과 함께 com.pushwoosh:pushwoosh-badge |
| Pixel 및 미지원 런처 | 해당 없음 | – | – | 네이티브 Android 배지 API가 없어 표시되지 않음 |
| OS에서 현재 숫자 읽기 | – | – | – | iOS는 읽기 API를 제공하지 않으므로 숫자는 앱이나 서버에서 관리 |
| 앱 아이콘 배지 자체 | 지원 | 런처에 따라 다름 | – | 브라우저에는 웹 푸시에 해당하는 영역이 없음 |
aps.badge+1과 -1+n, 런처에 따라 다름/setBadge로 카운터 동기화0으로 초기화setApplicationIconBadgeNumberPushwooshBadgePWNotificationExtensionManagercom.pushwoosh:pushwoosh-badge보안 및 호스팅
Pushwoosh는 미국과 독일에 있는 자체 하드웨어에서 운영되며, GDPR을 준수합니다.
작동 방식
배지 설정은 노코드이며 모든 요금제에서 무료입니다. 개발 작업은 두 곳에만 필요하며, iOS 기본 사용은 여기에 해당하지 않습니다.
-
숫자 작성 (노코드)
Send-Push 양식이나 프리셋의 Badges 필드에 숫자,
+n,-n또는0을 입력하거나, Messages API로ios_badges와android_badges를 보내세요. iOS 기본 사용에는 앱에서 할 일이 없습니다. SDK가 도착한 값을 적용합니다. -
필요한 두 곳 연결 (개발자)
Android에는
com.pushwoosh:pushwoosh-badge라이브러리와 매니페스트의 런처별 권한이 필요합니다. 푸시 오픈과 앱 실행 시 초기화는 SDK 호출 한 번이면 되며, App Groups를 사용하는 Notification Service Extension은 표시 전에 숫자를 바꿔야 할 때만 필요합니다.
알아 두어야 할 제한 사항
관련 제품 살펴보기
Pushwoosh 모바일 푸시 알림 서비스로 모든 기기에 도달하세요. 리치 콘텐츠, 정밀 타겟팅, 크로스채널 고객 여정, 99% 안정적인 발송 성능을 제공하며 SOC 2·ISO 27001 인증을 획득했습니다.
앱과 웹사이트에 알림 보관함을 추가하세요. 사일런트 발송으로 푸시를 거부한 사용자에게도 도달하고, 저장된 메시지는 원할 때 다시 볼 수 있습니다.
하나의 시각적 도구로 캠페인을 매핑하고 간소화하세요. Pushwoosh 고객 여정 빌더를 사용하여 소통하고, 참여를 유도하며, 유지하고, 전환시키고, 세분화하고, 실험하세요.
Pushwoosh 인앱 메시지: 사용자가 앱에 집중하는 순간 온보딩, 업셀, 공지, 피드백 수집을 완료하세요. 노코드 에디터, 네이티브 SDK 렌더링, 요소별 분석. ISO 27001·SOC 2 인증, EU 데이터센터. 무료로 시작하세요.
이미 보내는 푸시에 iOS 중단 수준을 설정해 사기 알림, 배달원 도착, 탑승구 변경이 집중 모드와 예약 요약을 뚫고 전달되게 하세요. 노코드로 설정합니다.
게임용 앱 전용 모바일 푸시 알림 플랫폼입니다. 개인화된 알림, 특별 혜택, 이벤트 리마인더를 보내어 플레이어가 다시 돌아오도록 유도하세요.