앱 사용 중 도착하는 푸시를 브랜드 스타일로
앱이 열려 있을 때 푸시가 도착하면 iOS는 그 순간을 앱에 맡깁니다. Pushwoosh iOS SDK는 이 푸시를 브랜드 색상과 폰트를 적용한 애니메이션 배너로 표시하며, iOS 26에서는 Apple의 Liquid Glass 소재를 사용합니다.
80,000개 이상의 기업이 고객 참여 확대를 위해 Pushwoosh를 선택했습니다
포그라운드 푸시, 한눈에 보기
앱이 포그라운드에 있을 때 도착한 푸시는 앱이 처리해야 합니다. iOS는 앱 화면 위에 단순한 시스템 배너를 띄우거나 아무것도 표시하지 않으며, 고객 여정 전체를 설계해 만든 메시지가 회색 시스템 UI로 도착합니다. PushwooshForegroundPush 모듈은 같은 페이로드를 직접 디자인한 배너로 표시합니다.
Liquid Glass (iOS 26)
useLiquidView를 켜면 배너가 Apple의 Liquid Glass 소재로 표시되어, 화면 위에 덧붙인 레이어가 아니라 iOS 26의 일부처럼 보입니다.
표준 배너 (iOS 13~25)
iOS 26 미만에서는 같은 호출이 브랜드 그라디언트와 색상의 단색 배너를 표시하며, 이전 Swift 툴체인에서는 블러 효과 뷰로 대체됩니다. 하나의 설정으로 세 가지 경우를 모두 처리합니다.
카드 이미지와 GIF
제목, 메시지, 카드 이미지, 애니메이션 GIF를 모두 푸시에 이미 담긴 페이로드에서 읽어옵니다.
모션, 햅틱, 표시 시간
진입 애니메이션, balls 또는 regularPush 닫힘 애니메이션, 일곱 단계 중 선택하는 도착 햅틱, 배너가 자동으로 사라지기까지의 시간(초).
제어할 수 있는 항목
| 속성 | 설정 내용 | 값 |
|---|---|---|
useLiquidView | iOS 26의 Liquid Glass 소재 | Bool, 기본값 false |
gradientColors, backgroundColor | 배너가 표시되는 배경 | 브랜드 색상 |
titlePushColor, messagePushColor | 두 줄 텍스트의 색상 | 브랜드 색상 |
titlePushFont, messagePushFont | 두 줄 텍스트의 서체 | 앱에 포함된 모든 폰트 |
usePushAnimation | 진입 애니메이션 | Bool, 기본값 true |
duration | 배너가 사라지기 전까지 표시되는 시간 | 초 |
vibration | 도착 시 햅틱 | none, light, medium, heavy, soft, rigid, notification |
disappearedPushAnimation | 배너가 화면에서 사라지는 방식 | balls 또는 regularPush |
style | 기본 제공 레이아웃 | style1, 현재 유일한 옵션 |
useLiquidViewfalsegradientColors, backgroundColortitlePushColor, messagePushColortitlePushFont, messagePushFontusePushAnimationtruedurationvibrationnone, light, medium, heavy, soft, rigid, notificationdisappearedPushAnimationballs 또는 regularPushstylestyle1, 현재 유일한 옵션설정 위치
앱 실행 시 호출 한 번
didFinishLaunchingWithOptions에서 foregroundNotificationWith(style:duration:vibration:disappearedPushAnimation:)를 호출하고 외관 속성을 지정합니다. 앱 전체에 한 번만 설정합니다.
도착 시 호출 한 번
PWMessagingDelegate.onMessageReceived 콜백에서 showForegroundPush(userInfo:)를 호출하면 메시지 페이로드로 바로 배너를 표시합니다.
탭 처리용 델리게이트 하나
PWForegroundPushDelegate.didTapForegroundPush(userInfo:)가 전체 페이로드를 전달하므로, 탭하면 캠페인이 의도한 위치로 정확히 딥 링크됩니다.
고객 여정 안에서 하는 역할
하나의 푸시, 세 가지 표시 방식
포그라운드 배너는 이미 발송하는 메시지의 표시 방식 중 하나입니다. 같은 세그먼트, 같은 트리거, 같은 페이로드, 같은 고객 여정의 같은 단계입니다. 달라지는 것은 메시지가 도착했을 때 기기가 처리하는 방식뿐입니다.
앱이 닫혀 있으면 메시지는 일반 시스템 푸시로 도착하거나 Live Activity를 업데이트합니다. 앱이 열려 있으면 SDK가 이 배너를 표시합니다. 혜택이나 양식을 담은 전체 화면이 필요한 순간에는 같은 고객 여정이 인앱 메시지로 전환합니다.
독자가 기사를 읽는 중에 속보가 터질 때
편집 이벤트가 고객 여정을 시작합니다. 사일런트 푸시가 독자 모르게 백그라운드에서 기사를 미리 불러오고, 1초 뒤 알림이 이어집니다.
앱이 닫힌 독자는 잠금 화면에서 시스템 푸시를 봅니다. 이미 앱 안에 있는 독자에게는 매체 고유의 배너가 썸네일과 함께 읽던 기사 위로 내려오고, 한 번 탭하면 새 기사로 딥 링크됩니다. 어느 경우든 메시지 인박스에 알림이 보관됩니다.
활용 사례
배너는 사용자가 앱 안에 있을 때만 표시되므로, 효과는 세션 중 도달 밀도에 따라 달라집니다. 즉, 발송한 메시지 중 얼마나 많은 비율이 이미 열린 화면에 도착하는지에 달려 있습니다. 세션이 긴 앱이 가장 큰 효과를 보고, 메시지가 주머니 속 휴대폰에 도착하는 앱은 효과가 거의 없습니다.
| 상황 | 메시지 내용 | 배너가 적합한 이유 |
|---|---|---|
| 미디어 및 뉴스: 기사를 읽는 중 속보 발생 | 판결이 나왔습니다 | 독자가 이미 앱 안에 있고, 시스템 배너는 매체 고유의 디자인을 방해함 |
| 스트리밍: 에피소드 시청 중 신작 공개 | 시즌 3이 공개되었습니다 | 시스템 UI 대신 작품 아트를 담아 알림을 전달할 수 있음 |
| 모바일 게임: 경기 중 이벤트 또는 보상 | 내 차례입니다, 5분 후 레이드 시작 | 세션이 길어 대부분의 푸시가 플레이 중 도착하며, 아트에 맞춘 배너가 게임 UI와 어울림 |
| 크리에이터 및 구독 앱: 신규 콘텐츠 또는 체험판 안내 | 팔로우한 아티스트의 새 콘텐츠 | 공들여 디자인한 앱이 이 순간만 시스템에 맡길 이유가 없으며, 탭하면 결제 화면으로 딥 링크 |
| 라이브 스포츠: 앱에서 시청 중 득점 | 1-0, 68분 | 사용자가 경기를 보려고 앱을 열었고, 푸시가 도착할 때 시청 중 |
| 이커머스 및 마켓플레이스: 둘러보는 중 가격 인하 | 내 사이즈 재입고 | 스크롤 중 스타일이 적용된 배너는 방해가 아니라 스토어의 일부처럼 보임 |
| 핀테크: 앱에서 작업 중 확인 알림 | 송금 완료 | 사용자가 결과를 기다리는 순간, 브랜드 확인 배너가 자연스럽게 느껴짐 |
다른 방식이 더 적합한 경우
배너는 단순한 시스템 알림과 전체 화면 인앱 사이에서 한눈에 볼 수 있는 중간 단계입니다. 많은 상황이 그 양쪽에 해당합니다.
- 앱이 닫힌 상태에서 도착하는 순간: 문 앞의 배송 기사, 탑승구 변경, 이상 거래 알림. 일반 푸시, 인터럽션 수준 또는 Live Activity를 사용하세요.
- 순간이 아니라 진행 중인 상태: 처리 중인 주문, 이동 중인 차량, 진행 중인 경기 점수. Live Activity를 사용하세요.
- 메시지에 전체 화면이 필요한 경우: 혜택, 양식, 결제 화면. 노코드로 작성하는 더 풍부한 인앱 메시지를 사용하세요.
- 메시지 수신 대상이나 내용을 바꾸려는 경우: 이 기능은 표시 방식만 바꾸며, 도달 범위는 모바일 푸시가 담당합니다.
플랫폼 및 기술 지원 범위
이 모듈은 iOS용입니다. Android는 알림 채널로 포그라운드 동작을 제어하며, 채널은 앱이 코드로 등록하는 대신 Pushwoosh SDK가 푸시 페이로드로 생성합니다. 웹에는 비교할 만한 영역이 없습니다. 이 기능의 대부분은 서버가 아니라 앱에서 동작하므로, 마지막 열에 실제로 배너를 그리는 주체를 명시했습니다.
| 기능 | iOS | Android | Web | 제공 주체 |
|---|---|---|---|---|
| 커스텀 포그라운드 배너 | iOS 13.0+, Pushwoosh SDK 6.10.0+ | – | – | 앱의 PushwooshForegroundPush 모듈 |
| Liquid Glass 소재 | iOS 26, Swift 5.13+ | – | – | useLiquidView로 켜는 Apple 소재 |
| 단색 배너 대체 | iOS 26 미만, Swift 5.13+ | – | – | SDK가 그리는 표준 뷰 |
| 블러 배너 대체 | 모든 iOS, Swift 5.13 미만 | – | – | SDK가 그리는 블러 효과 뷰 |
| 제목, 메시지, 카드 이미지, GIF | 지원 | – | – | 변경 없는 푸시 페이로드 |
| 브랜드 색상, 그라디언트, 폰트 | 지원 | – | – | 모듈의 정적 외관 속성 |
| 햅틱, 진입 및 닫힘 애니메이션, 표시 시간 | 지원 | – | – | 앱 실행 시 foregroundNotificationWith |
| 탭 처리와 딥 링크 | 지원 | – | – | PWForegroundPushDelegate.didTapForegroundPush |
| 노코드 외관 설정 | – | – | – | 현재 미지원, 스타일은 앱 코드에서 관리 |
| 다른 플랫폼의 비교 가능한 세션 내 영역 | 인앱 메시지, Live Activities | 인앱 메시지 | 인앱 메시지 | Control Panel에서 노코드로 작성하는 별도 제품 |
PushwooshForegroundPush 모듈useLiquidView로 켜는 Apple 소재foregroundNotificationWithPWForegroundPushDelegate.didTapForegroundPush보안 및 호스팅
Pushwoosh는 미국과 독일에 있는 자체 하드웨어에서 운영되며, GDPR을 준수합니다.
작동 방식
이 기능에는 개발 작업이 필요하며, 이를 숨기지 않습니다. 포그라운드 외관을 설정하는 Control Panel 작성 도구가 없으므로 개발자가 앱에서 한 번 연결하고, 그 이후는 지금 하는 발송 그대로입니다.
-
모듈을 추가하고 포그라운드를 앱에 넘기기 (개발자)
PushwooshFramework,PushwooshCore,PushwooshBridge,PushwooshLiveActivities와 함께PushwooshForegroundPush를 추가한 뒤,Info.plist에서Pushwoosh_SHOW_ALERT를false로 설정하세요. 배너는 시스템 알림과 함께 표시되지 않고 대체하므로, iOS가 자체 알림을 그리지 않도록 합니다. -
외관을 한 번 설정 (개발자)
didFinishLaunchingWithOptions에서foregroundNotificationWith(style:duration:vibration:disappearedPushAnimation:)를 호출하고 색상, 그라디언트, 폰트 외관 속성을 지정하세요.onMessageReceived에서showForegroundPush(userInfo:)로 각 메시지를 표시하고,didTapForegroundPush에서 탭을 처리합니다. -
지금과 똑같이 발송 (노코드)
캠페인을 Control Panel에서 보내든 Messages API로 보내든, 같은 오디언스, 같은 고객 여정, 같은 페이로드를 사용합니다. 배너는 그 푸시가 열린 앱에 도착했을 때 표시되는 방식입니다.
알아 두어야 할 제한 사항
관련 제품 살펴보기
Pushwoosh 모바일 푸시 알림 서비스로 모든 기기에 도달하세요. 리치 콘텐츠, 정밀 타겟팅, 크로스채널 고객 여정, 99% 안정적인 발송 성능을 제공하며 SOC 2·ISO 27001 인증을 획득했습니다.
Pushwoosh 인앱 메시지: 사용자가 앱에 집중하는 순간 온보딩, 업셀, 공지, 피드백 수집을 완료하세요. 노코드 에디터, 네이티브 SDK 렌더링, 요소별 분석. ISO 27001·SOC 2 인증, EU 데이터센터. 무료로 시작하세요.
이미 보내는 푸시에 액션 버튼을 추가해 사용자가 한 번의 탭으로 수락, 수령, 승인, 배송 조회를 하게 하세요. iOS 버튼 세트는 Pushwoosh Control Panel에서 노코드로 만듭니다.
주문, 배차, 배송 진행 상황을 Android 16 잠금 화면의 카드 한 장으로 실시간 갱신합니다. Pushwoosh가 서버에서 시작, 업데이트, 종료까지 관리합니다.
iOS 푸시 하나에 여러 이미지를 담아 펼친 알림에서 스와이프하게 하세요. Pushwoosh가 알림 콘텐츠 확장을 제공하며, 다른 푸시와 같은 캠페인과 고객 여정에서 발송합니다.
앱과 웹사이트에 알림 보관함을 추가하세요. 사일런트 발송으로 푸시를 거부한 사용자에게도 도달하고, 저장된 메시지는 원할 때 다시 볼 수 있습니다.