OneSignal push-повідомлення: SDK, API, сегментація

У вас вже 10 000 користувачів, а push-повідомлення надсилаються із затримками та без аналітики? Така проблема знайома: бекенд-команда надсилає повідомлення напряму через APNs/FCM, і це перетворюється на зоопарк — окремий код для iOS, окремий для Android, немає аналітики відкриттів, немає сегментів, ретраї написані вручну. У підсумку доставка падає до 85%, а кастомна реалізація забирає 3–4 тижні. Наша команда з 5+ роками досвіду спеціалізується на OneSignal інтеграції для iOS та Android з повною підтримкою SDK та API. OneSignal вирішує весь цей стек єдиним API та SDK. OneSignal краще за APNs/FCM у 5 разів за швидкістю реалізації: 5 днів замість 3 тижнів. Економія часу — до 70%, а економія на обслуговуванні push-інфраструктури становить до $2,000 на місяць для проекту з 50,000 користувачів. Ми реалізували десятки таких інтеграцій під ключ — з нуля або з міграцією від вбудованої логіки. Гарантуємо доставку 99.9% (на основі статистики OneSignal) та маємо 30+ успішних проектів.

Для одного маркетплейсу з 20 000 активних користувачів ми замінили самописну push-систему на OneSignal. Результат: час доставки скоротився з 8 секунд до 1.2 секунди, відсоток відкриттів зріс на 40% завдяки сегментації, а витрати на обслуговування зменшилися втричі.

Як OneSignal вирішує проблему єдиного API?

OneSignal SDK версії 5.x перейшов на модульну архітектуру: OneSignal.User, OneSignal.Notifications, OneSignal.InAppMessages — окремі неймспейси. Це важливо при оновленні з версії 3.x, де все було плоским API. Міграція не тривіальна: sendTag замінився на OneSignal.User.addTag, setExternalUserId — на OneSignal.login. Нижче — ініціалізація для iOS та Android.

// iOS — AppDelegate.swift
OneSignal.initialize("YOUR_APP_ID", withLaunchOptions: launchOptions)
OneSignal.Notifications.requestPermission({ accepted in
    print("Permission granted: \(accepted)")
}, fallbackToSettings: true)

// Android — Application.kt
OneSignal.initWithContext(this, "YOUR_APP_ID")
OneSignal.Notifications.requestPermission({ accepted ->
    Log.d("OneSignal", "Permission: $accepted")
}, this, true)

Чому OneSignal вигідніше власної інтеграції?

Власна інтеграція обходиться в 2–3 тижні розробки плюс постійні доробки. OneSignal — 3–5 днів, і аналітика з сегментами йдуть «з коробки». Економія часу — до 70%, а конверсія від push-повідомлень зростає в 2–3 рази за рахунок правильної сегментації.

Як налаштувати OneSignal за 5 кроків

1. Створіть проект в OneSignal Dashboard та згенеруйте ключі APNs/FCM.
2. Встановіть SDK через CocoaPods/Swift Package Manager для iOS або Gradle для Android.
3. Ініціалізуйте SDK з app_id та налаштуйте permission (див. приклади вище).
4. Реалізуйте обробник відкриття повідомлень для deep linking.
5. Додайте теги для сегментації та протестуйте відправку через REST API.

Як ідентифікувати користувачів та налаштувати теги?

За замовчуванням OneSignal створює анонімний Player ID (device-level ідентифікатор). Для бізнес-логіки потрібна прив'язка до користувача системи:

// Після логіну користувача
OneSignal.login("user_internal_id_12345")

// Атрибути для сегментації
OneSignal.User.addTag("plan", "premium")
OneSignal.User.addTag("city", "kyiv")
OneSignal.User.addTag("last_purchase_days", "3")

Теги — основа для сегментації в подальшому. Їх варто проектувати заздалегідь: 10–15 ключових тегів достатньо для більшості сценаріїв. Якщо теги розрізнені, аналітика втрачає точність.

Відправка через REST API

Серверна частина — HTTP REST. Мінімальний запит на відправку по external_id:

POST https://onesignal.com/api/v1/notifications
{
  "app_id": "YOUR_APP_ID",
  "include_aliases": { "external_id": ["user_12345"] },
  "target_channel": "push",
  "contents": { "en": "Your order is ready", "ru": "Ваш заказ готов" },
  "data": { "order_id": "98765", "screen": "order_detail" }
}

Поле data — payload для deep link. На мобільному клієнті його обробляє OSNotificationOpenedHandler:

// iOS
OneSignal.Notifications.addClickListener { event in
    if let orderId = event.notification.additionalData?["order_id"] as? String {
        AppRouter.navigate(to: .orderDetail(id: orderId))
    }
}

Доставка та аналітика

OneSignal надає delivery rate (99.9% в середньому), click rate, influenced opens (користувач відкрив додаток протягом 60 секунд без кліку). Для e-commerce це важлива метрика — повідомлення спрацювало, але користувач відкрив додаток інакше. Якщо потрібна більш глибока аналітика — OneSignal інтегрується з Mixpanel, Amplitude через outcome events. Наприклад, відправка події покупки: OneSignal.Session.addOutcome("purchase_completed") та addOutcomeWithValue("purchase_amount", 149.99). Ці дані дозволяють будувати воронки та оцінювати ROI push-кампаній.

Що входить в інтеграцію під ключ

Терміни та як почати

Базова інтеграція OneSignal SDK (iOS + Android або Flutter/RN), налаштування APNs/FCM сертифікатів, прив'язка external user ID, обробник відкриттів — 3–5 робочих днів. Якщо додається серверна логіка відправки, налаштування сегментів та шаблонів в OneSignal Dashboard — ще 2–3 дні.

Замовте аудит поточної архітектури push-повідомлень — це безкоштовно. Зв'яжіться з нами для консультації: наші інженери з 5+ роками досвіду оцінять ваш проект і запропонують оптимальний план. Зверніться до нас, і ми налаштуємо OneSignal під ваш стек за лічені дні.

Push-сповіщення в мобільному застосунку: APNs, FCM, сегментація, rich push

Ми впровадили push-сповіщення в мобільному застосунку для 50+ проєктів — від стартапів до enterprise з аудиторією 10M+ користувачів. Нерелевантне або технічно зламане сповіщення гірше за його відсутність: користувач вимикає push або видаляє застосунок. Згідно з Localytics, відмова від push-дозволів на iOS сягає 40% у перший тиждень — причина майже завжди в нерелевантності, а не в механіці. Вже через 2 тижні після впровадження якісної сегментації конверсія відкриття зростає на 25–30%. Зв'яжіться з нами для аудиту поточної реалізації — ми оцінимо проєкт і запропонуємо оптимальний стек за один день.

Як працює інфраструктура: APNs та FCM

APNs — єдиний канал доставки на iOS. Все інше (OneSignal, Braze, Airship) — обгортки поверх нього. APNs приймає запит по HTTP/2, аутентифікація через JWT-токен (p8-ключ) або сертифікат. JWT кращий: один ключ для всіх застосунків в акаунті, не закінчується щороку на відміну від сертифіката. (Докладніше — Wikipedia)

Критичний момент: APNs розрізняє apns-push-type — alert, background, voip, complication, fileprovider, mdm. Неправильно вказаний тип на iOS 13+ призводить до того, що background-сповіщення не розбудить застосунок. Бачили проєкти, де content-available: 1 відправляли без apns-push-type: background — застосунок не отримував silent push на частині пристроїв, і команда місяць шукала «баг у застосунку».

FCM на Android працює через Google Play Services. Для пристроїв без GMS (Huawei, частина китайського ринку) потрібен Huawei Push Kit або прямий WebSocket — окреме завдання. FCM підтримує data-повідомлення (обробляються в onMessageReceived) та notification-повідомлення (система відображає автоматично, якщо застосунок у фоні). Змішувати їх потрібно обережно: якщо в notification-блоці є click_action, а deep link у застосунку не зареєстрований, тап по сповіщенню просто відкриє головний екран без навігації.

Чому сегментація — основа ефективних push-сповіщень?

Відправляти всім підряд — значить швидко вичерпати лояльність користувачів. Персоналізовані повідомлення клікають у 3 рази частіше масових, а правильна сегментація знижує відтік на 25% (на одному з проєктів це принесло додатковий дохід +3 млн грн за квартал). Вартість налаштування сегментації в OneSignal або кастомному бекенді становить індивідуальну суму залежно від складності фільтрів.

Нормальна сегментація будується на кількох рівнях.

Теми — для широких категорій: «нові акції», «оновлення статусу замовлення». Користувач підписується через FirebaseMessaging.getInstance().subscribeToTopic("orders"). Просто, але нема гнучкої фільтрації.

Сегменти за атрибутами — через OneSignal, Braze або кастомний бекенд. Зберігаємо в профілі користувача: мова, тип пристрою, остання активність, LTV-сегмент. Сповіщення йде тільки тим, у кого last_active < 7_days та plan = premium. OneSignal дозволяє будувати такі фільтри в інтерфейсі без коду.

Персоналізовані — за конкретним device_token. Важно зберігати токени правильно: токен оновлюється при перевстановленні застосунку, при відновленні з бекапу на новий телефон, при скиданні налаштувань. На iOS використовуємо UNUserNotificationCenter + didRegisterForRemoteNotificationsWithDeviceToken, зберігаємо на бекенд при кожному запуску, не тільки при першому. Інакше через 3 місяці 30% токенів у базі застарілі.

Що таке rich push і як він підвищує конверсію?

Стандартне сповіщення з заголовком і текстом клікають рідше, ніж rich push із картинкою та кнопками дій — у 3 рази. Але реалізація rich push — окрема робота на кожній платформі.

На iOS rich content вимагає UNNotificationServiceExtension (для модифікації payload) та UNNotificationContentExtension (кастомний UI). Розширення запускається в окремому процесі з обмеженим часом і пам'яттю. Якщо розширення падає або перевищує таймаут, система показує оригінальний payload без медіа. Типова помилка — намагатися завантажити зображення по HTTP (не HTTPS): ATS заблокує запит, розширення мовчки завершиться, користувач побачить сповіщення без картинки.

На Android з API 26+ сповіщення прив'язані до NotificationChannel. Якщо канал створений з IMPORTANCE_LOW, звук і вібрація недоступні. Різні типи сповіщень (транзакційні, маркетингові) повинні бути в різних каналах, щоб користувач міг вимкнути маркетинг, не втрачаючи сповіщень про замовлення. BigPictureStyle, MessagingStyle, InboxStyle — шаблони для розширених сповіщень. MessagingStyle з Person та аватарками — найкращий вибір для чатів.

Як відстежити доставку та конверсію push-сповіщень?

Відправити сповіщення — половина справи. Важно знати: доставлено воно, відкрито, чи привело до цільової дії.

FCM віддає MessageId при відправці, але не гарантує колбек про доставку — це by design. Для tracking відкриттів потрібна кастомна логіка: при тапі на сповіщення в onMessageReceived або через getInitialNotification() / onNotificationOpenedApp (OneSignal SDK) відправляємо подію в аналітику з notification_id.

OneSignal надає вбудовану аналітику доставки та CTR. Для більш детального аналізу — інтегруємо з Amplitude або Mixpanel через webhook на подію відкриття. Бюджет такого дашборда залежить від обсягу подій і обговорюється індивідуально.

Як ми впроваджуємо push-сповіщення: типовий процес

1. Аудит поточної реалізації — перевіряємо зберігання токенів, обробку оновлень, типи сповіщень.
2. Проектування архітектури — вибираємо транспорт (FCM + APNs), шар сегментації (OneSignal/Braze/кастом), спосіб персоналізації.
3. Реалізація — пишемо код реєстрації, обробки вхідних, rich push, deep linking.
4. Тестування — відправляємо тестові кампанії, перевіряємо доставку на різних пристроях, симуляторах, регіонах.
5. Моніторинг та аналітика — налаштовуємо дашборд, події відкриття та конверсій.
6. Документація та навчання — передаємо команді матеріали по експлуатації.

Типовий стек: FCM + APNs на транспортному рівні, OneSignal або Firebase Notifications Composer для сегментації, кастомний бекенд для персоналізованих подійних сповіщень. Для великих застосунків з >1M користувачів OneSignal має цінові обмеження — тоді використовуємо Braze або власну реалізацію на AWS SNS.

Що входить у роботу (deliverables)

• Документація — архітектурна схема push-потоків, інструкція для розробників, опис сегментів
• Кодова база — репозиторій з реалізацією реєстрації, обробки, rich push, deep linking
• Доступи — налаштовані проектні конфігурації в Firebase Console, App Store Connect, OneSignal/Braze
• Дашборд — аналітика доставки та відкриттів (Amplitude або Mixpanel)
• Навчання команди — воркшоп 2 години з поясненням особливостей експлуатації

Типові помилки, яких варто уникнути

• Не зберігати оновлені device_token при кожному запуску — через 3 місяці 30% токенів застарівають.
• Плутати apns-push-type — background-сповіщення не пробуджують застосунок.
• Створювати один NotificationChannel для всіх типів сповіщень — користувач не зможе вимкнути маркетинг, не втративши транзакції.
• Завантажувати медіа в rich push по HTTP — ATS блокує запит на iOS.
• Не перевіряти deep link у таргетингу — переходи йдуть на головний екран.

Терміни та вартість

Терміни залежать від складності: базова інтеграція FCM+APNs з транзакційними сповіщеннями — 1–2 тижні. Повноцінна система з сегментацією, rich push, аналітикою та A/B-тестуванням контенту — 4–8 тижнів. Вартість розраховується індивідуально після аудиту.

Закажіть аудит поточної push-інфраструктури або отримайте консультацію по впровадженню push-сповіщень у мобільному застосунку — ми зв'яжемося з вами протягом дня та надамо точну оцінку.