Интеграция аналитики Adjust в мобильное приложение

Настройка атрибуции в мобильном продукте — задача, которую многие откладывают, пока не столкнутся с отсутствием данных по источникам установок. Например, при запуске рекламной кампании вы можете обнаружить, что 60% установок приходят из 'organic' — это верный признак неработающей атрибуции. Причина часто кроется в неправильной конфигурации environment или отсутствии деплинков.

Мы сталкивались с проектами, где из-за неверного обращения с Adjust SDK терялось до 80% данных. В этой статье разберём 5 ключевых шагов к правильной интеграции.

Почему атрибуция утекает без правильной интеграции?

Adjust — один из ключевых MMP (Mobile Measurement Partner) для европейского и азиатского рынков. Он отслеживает установки, in-app события и атрибуцию через цепочку кликов. Если SDK подключён неверно, вы теряете до 80% данных об источниках. Особенно критично это для e-commerce, где каждое событие покупки должно точно атрибутироваться рекламному каналу.

Подготовка и подключение SDK

iOS через Swift Package Manager

Добавляем пакет adjust/ios_sdk в Xcode и инициализируем в AppDelegate:

import Adjust

func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    let config = ADJConfig(
        appToken: "YOUR_APP_TOKEN",
        environment: ADJEnvironmentProduction
    )
    config?.logLevel = ADJLogLevelError
    config?.delegate = self

    Adjust.appDidLaunch(config)
    return true
}

На этапе разработки используйте ADJEnvironmentSandbox — продакшен токен в песочнице не влияет на статистику, но частая ошибка — выкатить релиз с sandbox-окружением. Поменяйте на production перед публикацией.

Android через Gradle

Подключаем зависимость и инициализируем:

implementation("com.adjust.sdk:adjust-android:4.+")

val config = AdjustConfig(this, "YOUR_APP_TOKEN", AdjustConfig.ENVIRONMENT_PRODUCTION)
config.setLogLevel(LogLevel.ERROR)
Adjust.onCreate(config)

На Android обязательно зарегистрируйте AdjustLifecycleCallbacks в Application.onCreate() либо вызывайте onResume/onPause в каждой Activity вручную.

Отслеживание событий и защита от дублирования

В Adjust каждое событие создаётся в дашборде и получает уникальный Event Token (четырёхсимвольный код). Пример отслеживания покупки:

let event = ADJEvent(eventToken: "abc123")
event?.addCallbackParameter("product_id", value: "sku_789")
event?.addCallbackParameter("category", value: "electronics")
event?.setRevenue(990.0, currency: "RUB")
event?.setOrderId("order_\(orderId)") // дедупликация
Adjust.trackEvent(event)

setOrderId критически важен: если запрос на сервер Adjust retry, без дедупликации покупка учтётся дважды. На стороне бэкенда также стоит проверять уникальность orderId.

Как настроить SKAdNetwork и ATT для iOS 14 и новее?

Начиная с iOS 14, без разрешения пользователя IDFA недоступен. Adjust управляет conversion values автоматически через конфигурацию в дашборде. Запросите разрешение ATT до инициализации Adjust: Adjust.requestTrackingAuthorization { status in }. Без этого атрибуция работает только через SKAdNetwork с задержкой до 72 часов. Настройте схему кодирования conversion values в Adjust Suite — определите последовательность событий, которые кодируются в 6 бит. Это позволит получать данные даже при отказе пользователя.

Deeplink атрибуция: Universal Links и App Links

// Universal Links
func application(_ application: UIApplication,
                 continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    if userActivity.activityType == NSUserActivityTypeBrowsingWeb,
       let url = userActivity.webpageURL {
        Adjust.appWillOpen(url)
    }
    return true
}

// URL Schemes
func application(_ app: UIApplication, open url: URL,
                 options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
    Adjust.appWillOpen(url)
    return true
}

Убедитесь, что Universal Links (iOS) и App Links (Android) настроены на сервере. Adjust автоматически свяжет клик по ссылке с последующей установкой.

Сравнение Adjust и AppsFlyer

По внутренним тестам, Adjust обрабатывает события в 1.5 раза быстрее, чем AppsFlyer, что особенно заметно при высокой нагрузке.

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

• Аудит текущей аналитики и требований
• Подключение Adjust SDK для iOS, Android или Flutter
• Настройка событий и conversion values
• Интеграция deeplink (Universal Links, App Links)
• Конфигурация ATT и SKAdNetwork
• Тестирование через Adjust Testing Console
• Документация и передача доступов
• Пост-релизный мониторинг и поддержка (1 месяц)

Типичные ошибки и как их избежать

• Окружение SDK не переключено на production — самый частый инцидент. Проверьте перед релизом.
• Пропущен AdjustLifecycleCallbacks на Android — без него сессии не закрываются, атрибуция сбивается.
• Нет setOrderId — дублирование покупок в отчётах.
• ATT запрос после инициализации Adjust без conversion values — данные по SKAdNetwork неполные.
• Отсутствие deeplink обработчиков — ссылки не атрибутируются, пользователь попадает в приложение без контекста.

Процесс интеграции под ключ

1. Аудит текущей аналитики — оцениваем, какие данные нужны клиенту.
2. Подключение SDK (iOS/Android/Flutter) — ручная или через менеджеры пакетов.
3. Настройка events и conversion values — создаём токены, привязываем к коду.
4. Конфигурация ATT и SKAdNetwork — для iOS 14+.
5. Интеграция deeplink — Universal Links, App Links, URL Schemes.
6. Тестирование через Adjust Testing Console — проверяем все сценарии.
7. Деплой и мониторинг — после релиза следим за корректностью данных.

Сроки и стоимость

Базовая атрибуция с событиями занимает 1–2 дня. Если нужны deeplink и SKAdNetwork — до 3 дней. Более сложные сценарии, включающие интеграцию с партнёрами и настройку fraud prevention, могут потребовать до недели. Стоимость рассчитывается индивидуально — свяжитесь с нами для оценки.

Наша команда имеет 5+ лет опыта в интеграции мобильной аналитики. Мы выполнили более 30 проектов с Adjust и AppsFlyer. Гарантируем корректную атрибуцию после деплоя. Закажите интеграцию под ключ — и вы забудете о потерянных данных.

Аналитика мобильных приложений: 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 успешных проектов в сфере мобильной разработки. Мы гарантируем корректность данных и прозрачность каждого этапа.

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