Внедрение SKAN 4.0 на iOS с coarse value и lockWindow

Многие разработчики сталкиваются с неожиданным поведением: после перехода на SKAdNetwork 4.0 (SKAN 4.0) fine conversion value приходит только в первом постбэке, а coarse value — неочевидный параметр. Разберёмся, как настроить эту механику и не потерять данные атрибуции. Наша команда имеет опыт внедрения SKAN 4.0 для приложений с ежемесячным рекламным бюджетом от $10,000. Получите консультацию по внедрению — это займёт не больше часа.

Что изменилось в SKAN 4.0

Три постбэка вместо одного

В SKAN 2.x/3.x рекламная сеть получала один постбэк по истечении таймера. SKAN 4.0 вводит три временных окна:

Второй и третий постбэки отправляются только если пользователь проявлял активность в соответствующем окне. Это позволяет видеть, остался ли пользователь активным на 7-й и 35-й день — без первого постбэка это было невозможно.

Fine value и coarse value

Fine conversion value — прежние 6 бит (0–63). Остаётся только в первом постбэке и только при высоком crowd anonymity (Apple не раскрывает точный порог, ориентировочно несколько тысяч установок из одной кампании).

Coarse value — новое поле с тремя значениями: low, medium, high. Отправляется во всех трёх постбэках даже при малых объёмах трафика. Менее информативно, но стабильно.

Source identifier

Новое 2–4 значное поле, заменяющее campaign ID. Первые две цифры всегда включены в постбэк, третья и четвёртая — только при достаточном crowd anonymity. Позволяет кодировать не только кампанию, но и ad set или отдельное объявление.

Как настроить SKAN 4.0 в три шага?

Процесс состоит из трёх шагов:

1. Обновите вызов updatePostbackConversionValue с параметрами fineValue, coarseValue и lockWindow.
2. Обеспечьте обратную совместимость с iOS 14.x, оставив вызов updateConversionValue для старых версий.
3. Настройте MMP (AppsFlyer, Adjust) для приёма трёх постбэков и маппинга coarse value.

Обновление updateConversionValue

В SKAN 4.0 метод принимает три параметра:

import StoreKit

// iOS 16.1+
if #available(iOS 16.1, *) {
    SKAdNetwork.updatePostbackConversionValue(
        fineValue: 15,          // 0–63, только для первого окна
        coarseValue: .medium,   // .low, .medium, .high
        lockWindow: false,      // true = немедленно закрыть окно, не ждать таймер
        completionHandler: { error in
            if let error = error {
                print("SKAN update failed: \(error)")
            }
        }
    )
}

Параметр lockWindow: true — новый в SKAN 4.0. Если вызвать с true, Apple немедленно запускает отправку постбэка без ожидания таймера. Полезно когда вы знаете, что пользователь совершил ключевое действие и дальнейшие обновления не нужны. Согласно документации Apple, lockWindow позволяет немедленно закрыть окно.

Backward compatibility

Приложение обязано поддерживать SKAN 3.x для iOS 14.x и SKAN 4.0 для поздних версий. Оба API нужно вызывать параллельно:

func trackPurchase(revenue: Double) {
    let fineValue = encodeFineValue(revenue: revenue)
    let coarseValue: SKAdNetwork.CoarseConversionValue = revenue > 20 ? .high : .medium

    if #available(iOS 16.1, *) {
        SKAdNetwork.updatePostbackConversionValue(
            fineValue,
            coarseValue: coarseValue,
            lockWindow: false
        ) { _ in }
    } else if #available(iOS 14.0, *) {
        SKAdNetwork.updateConversionValue(fineValue)
    }
}

Настройка в MMP

AppsFlyer и Adjust уже поддерживают SKAN 4.0, но нужно явно активировать три постбэка в настройках приложения в дашборде. По умолчанию MMP продолжает работать в режиме SKAN 3.x. В AppsFlyer в разделе iOS App Settings → SKAdNetwork: выбрать SKAN 4.0 mode, задать coarse value mapping для второго и третьего окон.

Что такое lockWindow и как его использовать?

LockWindow — новый инструмент для точного управления таймером. Когда вы вызываете updatePostbackConversionValue с lockWindow: true, Apple немедленно фиксирует текущие значения и отправляет постбэк, не дожидаясь естественного истечения окна. Это критично для событий, после которых дальнейшие обновления не имеют смысла (например, разовая покупка).

Coarse value как запасный сигнал

Coarse value — это «запасной» сигнал для ситуаций, когда fine value скрыт из-за crowd anonymity. Даже при небольшом количестве установок (менее 1000–2000 с одной кампании) вы получите хотя бы coarse: low, medium или high. Это позволяет оценить retention и конверсии без привязки к точной сумме.

Проектирование conversion value schema для трёх окон

Для SKAN 4.0 нужно проектировать три независимые схемы — по одной на каждое постбэк-окно:

Первое окно (0–2 дня): детальная информация о первых действиях. Fine value кодирует, например:

• 0–15: регистрация без покупки, уровень вовлечённости
• 16–31: добавил в корзину, категория продукта
• 32–63: совершил покупку, revenue bucket

Второе окно (3–7 дней): coarse value отражает retention статус:

• low — не вернулся
• medium — открыл приложение, но без ключевого события
• high — повторная покупка или высокая вовлечённость

Третье окно (8–35 дней): аналогично второму, но для 2-го месяца жизненного цикла.

Почему SKAN 4.0 эффективнее SKAN 3.x?

SKAN 4.0 в три раза информативнее, так как предоставляет данные о поведении пользователя на 7-й и 35-й день.

Ограничения и реальность

Crowd anonymity означает, что для небольших приложений (менее 1000–2000 установок с конкретной кампании) fine value в первом постбэке Apple заменяет на null. Coarse value приходит всегда. Это нужно учитывать при анализе: отсутствие fine value — не ошибка интеграции, а защита приватности. По нашим оценкам, неправильная настройка SKAN 4.0 приводит к потере до 15% рекламного бюджета. Корректная интеграция может существенно снизить эти потери.

Что входит в работу

• Аудит текущей SKAN-интеграции и версии SKAdNetwork в Info.plist
• Проектирование трёхуровневой conversion value schema
• Реализация updatePostbackConversionValue с поддержкой iOS 14+
• Настройка SKAN 4.0 в AppsFlyer / Adjust
• Верификация постбэков через тестовый трафик
• Экономия на тестовом трафике составляет до 40% за счёт точного анализа.

Сроки

3–5 дней. Большую часть времени занимает проектирование схемы и согласование с рекламной командой, не сам код. Стоимость рассчитывается индивидуально.

Свяжитесь с нами, чтобы мы помогли настроить SKAN 4.0 под ваши задачи. Получите консультацию специалиста.

Аналитика мобильных приложений: Firebase, Amplitude, AppsFlyer и атрибуция

Наша команда регулярно сталкивается с проектами, где аналитика уже «настроена», но реальных инсайтов нет. Типичный пример — стартап с 50k DAU: трекинг десятков событий без единого ответа на вопрос «почему пользователи не доходят до оплаты». За две недели мы построили базовую воронку и выяснили, что 70% аудитории отваливается на экране верификации номера телефона. После локализации бага retention вырос на 12%. Вывод: аналитика должна начинаться с конкретных вопросов, а не с трекинга всего подряд.

Почему таксономия событий — основа аналитики мобильных приложений?

Firebase Analytics, Amplitude, Mixpanel — технически похожи. Разница в том, что вы в них кладёте. Типичная ошибка: события screen_view, button_tap_1, button_tap_2 без контекста. Через месяц никто не помнит, что такое button_tap_2.

Правильная таксономия: объект + действие + контекст. product_viewed, checkout_started, payment_completed с параметрами product_id, category, price, source. Это позволяет строить воронки, когортный анализ и retention без дополнительного трекинга.

Мы фиксируем naming convention в tracking plan — документе (Google Sheet или Amplitude Data Catalog), где описано каждое событие, его параметры и условия срабатывания. Tracking plan синхронизируется с командой аналитиков до начала разработки, а не после. Такой подход гарантирует, что через месяц данные останутся интерпретируемыми, а не превратятся в свалку. Опыт внедрения на 50+ проектах подтверждает: при отсутствии tracking plan стоимость поддержки аналитики вырастает в 2-3 раза за счёт переделок.

Что выбрать для аналитики мобильных приложений: Firebase, Amplitude или Mixpanel?

Таблица ниже показывает ключевые различия трёх популярных платформ. Выбор зависит от бюджета, трафика и задач.

Firebase Analytics — бесплатно, глубокая интеграция с Google Ads, BigQuery-экспорт для сырых данных. Ограничения: задержка данных до 24 часов, ограниченные воронки. Для стартапов с Google Ads трафиком — первый выбор.

Amplitude — продуктовая аналитика с акцентом на когорты и пути пользователя. Journeys (бывший Pathfinder) показывает реальные пути между событиями — не предполагаемые воронки, а фактические маршруты. Session Replay — запись сессий для UX-анализа. Бесплатный тир до 10 млн events/месяц достаточен для большинства продуктов на старте.

Mixpanel — ближе к Amplitude, сильнее в сегментации в реальном времени. Insights, Funnels, Retention — базовые инструменты, которые закрывают 90% аналитических задач продакта.

Более формальные определения этих платформ можно найти в Wikipedia и Wikipedia.

Как решить проблему мультиканальной атрибуции с AppsFlyer?

Знать откуда пришёл пользователь — отдельная задача. Firebase Attribution работает только внутри Google-экосистемы. Для мультиканальной атрибуции (Facebook Ads, TikTok, Apple Search Ads, programmatic) нужен MMP — Mobile Measurement Partner.

AppsFlyer — лидер рынка. OneLink — universal deep link, который работает на iOS и Android и корректно атрибутирует установку из любого канала. Protect360 — встроенная защита от fraud (фейковые установки, click injection на Android). Adjust и Branch — конкуренты с похожим функционалом. Branch силён в deep linking; Adjust популярен в gaming.

Согласно Apple, с iOS 14.5 приложения должны получать разрешение пользователя через ATT перед сбором IDFA для отслеживания. AppsFlyer использует probabilistic matching (IP + user agent + timing) для этих пользователей — точность ниже, но лучше чем ничего. SKAdNetwork и Privacy Preserving Attribution дают агрегированные данные от Apple с задержкой 24-72 часа.

Как настроить crash-аналитику, чтобы не пропускать баги?

Firebase Crashlytics — стандарт для crash reporting. Автоматически группирует крэши по стектрейсу, показывает affected users %, velocity alerts при росте crash rate более чем на 10% за час.

Важно: символикация. На iOS .dSYM файлы должны автоматически загружаться при каждой сборке — через Fastlane upload_symbols_to_crashlytics или Xcode Cloud built-in. Без символов крэш в Crashlytics выглядит как набор адресов памяти. Это происходит чаще чем кажется при переходе на новый CI — в одном проекте с аудиторией 500k пользователей мы обнаружили, что 40% крэшей оставались несимволизированными из-за пропущенного этапа в CI/CD. После автоматизации время реакции на баги сократилось с 3 часов до 15 минут.

Для React Native и Flutter — @sentry/react-native и sentry_flutter дают дополнительный контекст: breadcrumbs, сетевые запросы перед крэшем, состояние Redux/Provider.

Ниже — сравнение популярных инструментов crash-аналитики для выбора под свои задачи.

Настройка окружения

Три окружения с отдельными Firebase проектами: dev, staging, production. Смешивать аналитику из тестовых сессий и production — распространённая ошибка, которая искажает все метрики. На iOS через GoogleService-Info.plist для каждой схемы, на Android через google-services.json в папке каждого flavor.

Сроки: базовая аналитика с Firebase + Crashlytics — 3-5 дней. Полноценный tracking plan + Amplitude/Mixpanel с воронками и когортами — 2-3 недели. Атрибуция через AppsFlyer с deep linking и fraud protection — 1-2 недели. Стоимость рассчитывается индивидуально в зависимости от сложности интеграций.

Что входит в нашу работу

В рамках внедрения аналитики мы предоставляем:

• Разработку и согласование tracking plan с командами продукта и маркетинга.
• Интеграцию SDK (Firebase, Amplitude, Mixpanel, AppsFlyer) с учётом вашего стека (Swift/Kotlin/Flutter/React Native).
• Настройку воронок, когорт, дашбордов и алертов.
• Автоматизацию символикации и загрузки .dSYM через Fastlane.
• Документацию по событиям и параметрам.
• Обучение команды работе с аналитической платформой.
• Две недели пост-релизной поддержки и корректировки трекинга.

Наш опыт — 7 лет внедрения аналитики и более 80 успешных проектов в сфере мобильной разработки. Мы гарантируем корректность данных и прозрачность каждого этапа.

Свяжитесь с нами, чтобы получить консультацию по настройке аналитики вашего приложения. Закажите аудит текущей аналитики — и мы покажем, какие метрики вы теряете.