Оформите пуш, который приходит, когда приложение открыто
Когда пуш приходит при открытом приложении, iOS оставляет этот момент вам. Pushwoosh iOS SDK отрисовывает его как анимированный баннер в ваших цветах и шрифтах, с материалом Apple Liquid Glass на iOS 26.
Более 80 000 компаний масштабируют вовлечение с Pushwoosh
Формат целиком
Пуш, пришедший, когда приложение на переднем плане, — забота самого приложения. iOS покажет поверх вашего интерфейса простой системный баннер или не покажет ничего, и сообщение, вокруг которого вы выстроили целый Customer Journey, приходит серым системным элементом. Модуль PushwooshForegroundPush отрисовывает тот же payload как баннер, оформлением которого управляете вы.
Liquid Glass (iOS 26)
Включите useLiquidView, и баннер будет отрисован в материале Apple Liquid Glass — он воспринимается как часть iOS 26, а не как слой, наклеенный поверх экрана.
Стандартный баннер (iOS 13–25)
Ниже iOS 26 тот же вызов отрисовывает сплошной баннер в вашем градиенте и цветах, а на старых версиях Swift используется размытый фон. Одна конфигурация покрывает все три варианта.
Картинка и GIF
Заголовок, текст, картинка-карточка и анимированный GIF — всё берётся из payload, который пуш уже несёт.
Анимация, хаптика и время показа
Анимация появления, исчезновение balls или regularPush, хаптика при получении на выбор из семи уровней и длительность в секундах, после которой баннер скрывается сам.
Чем вы управляете
| Свойство | Что оно задаёт | Значения |
|---|---|---|
useLiquidView | Материал Liquid Glass на iOS 26 | 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, пока единственный доступныйГде это настраивается
Один вызов при запуске
foregroundNotificationWith(style:duration:vibration:disappearedPushAnimation:) в didFinishLaunchingWithOptions плюс свойства оформления. Настраивается один раз для всего приложения.
Один вызов при получении
showForegroundPush(userInfo:) из колбэка PWMessagingDelegate.onMessageReceived отрисовывает баннер прямо из payload сообщения.
Один делегат для тапа
PWForegroundPushDelegate.didTapForegroundPush(userInfo:) передаёт вам полный payload, так что тап ведёт по deep link ровно туда, куда задумала кампания.
Как это работает внутри сценария
Один пуш, три варианта отображения
Foreground-баннер — это режим отображения сообщения, которое вы и так отправляете. Тот же сегмент, тот же триггер, тот же payload, тот же шаг в том же Customer Journey. Меняется только то, что устройство делает с ним при получении.
Если приложение закрыто, сообщение приходит обычным системным пушем или обновляет Live Activity. Если открыто — SDK отрисовывает этот баннер. Когда моменту нужен весь экран с предложением или формой, тот же сценарий переходит к in-app сообщению.
Срочная новость выходит, пока читатель в середине статьи
Редакционное событие запускает сценарий. Silent push незаметно для читателя заранее подгружает статью в фоне, а алерт приходит через секунду после него.
Читатели с закрытым приложением видят системный пуш на экране блокировки. Те, кто уже внутри, видят фирменный баннер издания, который выезжает поверх читаемой статьи с миниатюрой, и один тап ведёт их по deep link к новому материалу. Message Inbox в любом случае сохраняет алерт.
Где это применять
Баннер срабатывает только тогда, когда человек внутри приложения, поэтому его ценность зависит от «плотности сессий»: какая доля ваших отправок приходит на уже открытый экран. Больше всего выигрывают приложения с длинными сессиями — игры, медиа, стриминг, — а приложения, чьи сообщения приходят на телефон в кармане, почти ничего не получают.
| Момент | Что говорит сообщение | Почему подходит баннер |
|---|---|---|
| Медиа и новости: новость выходит во время чтения | Вердикт вынесен | Читатель уже в приложении, а системный баннер ломает собственный дизайн издания |
| Стриминг: релиз выходит во время эпизода | Третий сезон уже доступен | Алерт может нести обложку сериала, а не приходить системным элементом |
| Мобильные игры: ивент или награда во время матча | Ваш ход: Рейд через 5 минут | Длинные сессии означают, что большинство пушей приходит во время игры, и баннер в стиле игровой графики вписывается в интерфейс |
| Приложения для креаторов и подписочные сервисы: новый дроп или напоминание о триале | Новинка от автора, на которого вы подписаны | Тщательно продуманное приложение не должно отдавать системе даже этот момент, а тап ведёт по deep link на пейвол |
| Live-спорт: гол, пока пользователь смотрит в приложении | 1:0, 68-я минута | Пользователь открыл приложение ради события и смотрит его, когда приходит пуш |
| E-commerce и маркетплейсы: снижение цены во время просмотра | Ваш размер снова в наличии | Стилизованный баннер посреди скролла воспринимается как часть магазина, а не как помеха |
| FinTech: подтверждение во время задачи в приложении | Перевод отправлен | Фирменное подтверждение выглядит нативно именно в тот момент, когда пользователь его ждёт |
Когда правильнее другая поверхность
Баннер — это промежуточная ступень, которую видно с первого взгляда, между простым системным алертом и полноэкранным in-app. По обе стороны от неё хватает своих моментов.
- Момент наступает, когда приложение закрыто: курьер у двери, смена гейта, алерт о мошенничестве. Это обычный пуш, уровень прерывания или Live Activity.
- Состояние длящееся, а не мгновенное: заказ в работе, поездка в пути, текущий счёт. Это Live Activity.
- Сообщению нужен весь экран: предложение, форма, пейвол. Это in-app сообщение — богаче и собирается без кода.
- Вы хотите изменить, кто получает сообщение или что в нём сказано. Баннер меняет только внешний вид, а охват остаётся за мобильными пуш-уведомлениями.
Платформы и техническое покрытие
Это модуль для iOS. В Android поведение на переднем плане определяется каналами уведомлений, которые Pushwoosh SDK создаёт из payload пуша, а не ваше приложение регистрирует в коде, а в вебе сопоставимой поверхности нет. Последний столбец показывает, что именно отрисовывает баннер, потому что большая часть этого живёт в вашем приложении, а не на сервере.
| Возможность | iOS | Android | Web | Чем обеспечивается |
|---|---|---|---|---|
| Кастомный foreground-баннер | iOS 13.0+, Pushwoosh SDK 6.10.0+ | – | – | Модуль PushwooshForegroundPush в вашем приложении |
| Материал Liquid Glass | iOS 26 со Swift 5.13+ | – | – | Материал Apple, включается через useLiquidView |
| Фолбэк на сплошной баннер | iOS ниже 26, Swift 5.13+ | – | – | Стандартный view, отрисованный SDK |
| Фолбэк на размытый баннер | Любая iOS, Swift ниже 5.13 | – | – | Размытый effect view, отрисованный SDK |
| Заголовок, текст, картинка, GIF | Да | – | – | Payload пуша без изменений |
| Фирменные цвета, градиенты и шрифты | Да | – | – | Статические свойства оформления модуля |
| Хаптика, анимация появления и исчезновения, длительность | Да | – | – | foregroundNotificationWith при запуске приложения |
| Обработка тапа и deep link | Да | – | – | PWForegroundPushDelegate.didTapForegroundPush |
| Настройка внешнего вида без кода | – | – | – | Пока недоступна, оформление живёт в коде приложения |
| Сопоставимая поверхность внутри сессии на других платформах | In-app сообщения, Live Activities | In-app сообщения | In-app сообщения | Отдельные продукты, собираются без кода в Control Panel |
PushwooshForegroundPush в вашем приложенииuseLiquidViewforegroundNotificationWith при запуске приложенияPWForegroundPushDelegate.didTapForegroundPushБезопасность и хостинг
Pushwoosh работает на собственном оборудовании в США и Германии в соответствии с GDPR.
Как это работает
Здесь нужно время разработчика, и мы говорим об этом прямо. Редактора внешнего вида foreground-баннера в Control Panel нет, поэтому разработчик один раз подключает его в приложении, а дальше вы просто отправляете сообщения, как и раньше.
-
Добавьте модуль и передайте передний план приложению (разработчик)
Добавьте
PushwooshForegroundPushрядом сPushwooshFramework,PushwooshCore,PushwooshBridgeиPushwooshLiveActivities, затем установитеPushwoosh_SHOW_ALERTвfalseвInfo.plist. Так iOS перестанет рисовать собственный алерт: баннер заменяет его, а не появляется вместе с ним. -
Один раз настройте внешний вид (разработчик)
Вызовите
foregroundNotificationWith(style:duration:vibration:disappearedPushAnimation:)вdidFinishLaunchingWithOptionsи задайте свойства оформления для цветов, градиентов и шрифтов. Отрисовывайте каждое сообщение черезshowForegroundPush(userInfo:)изonMessageReceived, а тапы обрабатывайте вdidTapForegroundPush. -
Отправляйте так же, как сейчас (без кода)
Та же аудитория, тот же Customer Journey, тот же payload — неважно, запущена кампания из Control Panel или через Messages API. Баннер — это то, как пуш отображается, когда застаёт приложение открытым.
Ограничения, о которых стоит знать
Другие продукты
Push-уведомления Pushwoosh: охват всех устройств, rich-контент, точный таргетинг, Journey и 99% аптайм. Превращайте уведомления в платящих клиентов.
In-app сообщения Pushwoosh — онбординг, апселл, анонсы и сбор фидбэка ровно в тот момент, когда пользователи сфокусированы на приложении. No-code редактор, нативные SDK-шаблоны, аналитика по каждому элементу. Соответствует GDPR. Начните бесплатно.
Кнопки действий в пуше, который вы уже отправляете: принять, получить, подтвердить или отследить в один тап. Наборы для iOS — без кода.
Live Updates показывают заказ, поездку или доставку на экране блокировки Android 16 одной карточкой, которая обновляется сама, — с сервера Pushwoosh.
Несколько изображений в одном iOS-пуше, которые пользователь листает в развёрнутом уведомлении. Из той же кампании и сценария, что и любой пуш.
Message Inbox — центр уведомлений внутри приложения и сайта. Тихая доставка охватывает всех, включая отказавшихся от пушей, а сообщения остаются доступны.