Реализация In-App Messages в мобильном приложении

Реализация In-App Messages в мобильном приложении

In-App Messages — это не push. Они показываются только когда приложение открыто, не требуют разрешений, не попадают в notification center. Модальное окно при открытии приложения, баннер внизу экрана при нужном событии, fullscreen оффер после первой покупки — это всё IAM. Главная техническая задача: показывать их в правильный момент, не раздражая пользователя.

Платформенные решения vs собственная реализация

Два пути: использовать SDK (OneSignal IAM, Firebase In-App Messaging, Braze, Intercom, Appcues) или реализовать собственный механизм. SDK — быстрый старт, но ограниченная кастомизация UI. Собственное решение — полный контроль над внешним видом и логикой показа.

Firebase In-App Messaging — бесплатно, интегрируется с Firebase Analytics events:

// iOS — автоматически показывает IAM при логировании указанного события
Analytics.logEvent("checkout_started", parameters: [
    "cart_value": 450.0
])
// В Firebase Console: триггер IAM = событие "checkout_started", условие cart_value > 200

// Android
FirebaseAnalytics.getInstance(context).logEvent("checkout_started") {
    param("cart_value", 450.0)
}

Firebase IAM показывает сообщение автоматически — приложению ничего дополнительно делать не нужно. Ограничение: UI редактируется только через Firebase Console (шаблоны), нет полного контроля над анимациями и стилями.

Собственная реализация: архитектура

Для полного контроля реализуем собственный IAM-движок. Компоненты:

1. Campaign Manager — получает список активных кампаний с бэкенда (или из Remote Config).
2. Trigger Engine — отслеживает события приложения, сопоставляет с условиями кампаний.
3. Display Controller — управляет очередью показа, anti-spam правилами.
4. UI Layer — рендерит конкретный тип сообщения.

// Android — Display Controller
class InAppMessageController(
    private val campaignRepo: CampaignRepository,
    private val displayHistory: DisplayHistoryDao
) {
    suspend fun onEvent(eventName: String, params: Map<String, Any> = emptyMap()) {
        val campaigns = campaignRepo.getActiveCampaigns()
        val eligible = campaigns.filter { campaign ->
            campaign.trigger.eventName == eventName &&
            matchesConditions(campaign, params) &&
            !wasShownRecently(campaign.id)
        }

        // Показываем только одно сообщение за раз — приоритет по score
        eligible.maxByOrNull { it.priority }?.let { campaign ->
            displayHistory.record(campaign.id, System.currentTimeMillis())
            showMessage(campaign)
        }
    }

    private suspend fun wasShownRecently(campaignId: String): Boolean {
        val lastShown = displayHistory.getLastShownTime(campaignId) ?: return false
        val cooldownMs = 24 * 60 * 60 * 1000L // 24 часа
        return System.currentTimeMillis() - lastShown < cooldownMs
    }
}

Типы UI и как их показывать

Modal (центральный попап). На iOS — через UIViewController с modalPresentationStyle = .overCurrentContext и прозрачным фоном:

let iamVC = InAppMessageViewController(campaign: campaign)
iamVC.modalPresentationStyle = .overCurrentContext
iamVC.modalTransitionStyle = .crossDissolve
topViewController?.present(iamVC, animated: true)

Найти topViewController при сложной навигации (TabBar + NavigationController + модалки) — отдельная задача. Рекурсивный хелпер по presentedViewController и children.

Bottom Sheet / Banner. На Android — BottomSheetDialogFragment или кастомный View, добавляемый через WindowManager поверх текущего контента. Второй вариант работает даже в фрагментах без необходимости знать текущий экран, но требует SYSTEM_ALERT_WINDOW разрешения — нежелательно.

Лучше — BottomSheet через supportFragmentManager:

class InAppBottomSheet : BottomSheetDialogFragment() {
    // ... биндинг данных кампании
    override fun onCreateView(...) = InAppBottomSheetBinding.inflate(inflater).also {
        binding = it
    }.root
}

InAppBottomSheet.newInstance(campaign).show(supportFragmentManager, "iam_bottom_sheet")

Fullscreen. Отдельный Activity с FLAG_FULLSCREEN — самое надёжное на Android. На iOS — UIViewController с modalPresentationStyle = .fullScreen.

Таргетинг и условия показа

Без частотного капа IAM превращается в раздражитель. Хранить время последнего показа каждой кампании — в Room (Android) или Core Data / UserDefaults (iOS, если данных мало).

Аналитика

Минимальный набор событий для аналитики IAM:

• iam_displayed — сообщение показано
• iam_dismissed — закрыто без действия
• iam_action_clicked — нажата кнопка действия (с указанием action_id)
• iam_converted — целевое событие после показа (покупка, регистрация)

Analytics.logEvent("iam_action_clicked", parameters: [
    "campaign_id": campaign.id,
    "action_id": "upgrade_now",
    "screen": currentScreenName
])

Сроки

Интеграция Firebase IAM с триггерами по событиям — 2–3 дня. Собственный IAM-движок с Campaign Manager, Trigger Engine, тремя типами UI (modal, banner, fullscreen), аналитикой и частотными капами — 10–15 рабочих дней.