Настройка атрибуции установок (Install Attribution) мобильного приложения

Настройка атрибуции установок (Install Attribution) мобильного приложения

Рекламный бюджет размазан по пяти каналам: Google UAC, Meta Ads, TikTok, Telegram, ASA. Приложение устанавливают, пользователи покупают — но маркетинг не знает, какой канал принёс покупателей, а какой тянет деньги впустую. Без корректно настроенной атрибуции установок это стандартная ситуация.

Как работает атрибуция: MMP в середине цепочки

Mobile Measurement Partner (MMP) — это независимая третья сторона между рекламными сетями и вашим приложением. Принцип: когда пользователь кликает на рекламу, MMP фиксирует клик с параметрами кампании. При установке приложение стартует SDK — MMP сопоставляет устройство с ранее зафиксированным кликом и возвращает атрибуцию источнику.

Ключевые игроки: AppsFlyer, Adjust, Branch, Kochava. Для российского рынка AppsFlyer и Adjust — наиболее распространённые.

Механика матчинга после iOS 14.5 разделилась:

• Deterministic (точный): через SKAdNetwork-постбэки — когда пользователь дал разрешение на ATT
• Probabilistic (вероятностный): по fingerprint (IP + User-Agent + время клика) — без разрешения ATT, с ограниченной точностью

На Android ситуация проще: Google Play Referrer API даёт точный атрибуционный токен без разрешений пользователя.

Интеграция AppsFlyer на практике

iOS (Swift)

// AppDelegate.swift
import AppsFlyerLib

func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    AppsFlyerLib.shared().appsFlyerDevKey = "YOUR_DEV_KEY"
    AppsFlyerLib.shared().appleAppID = "123456789"
    AppsFlyerLib.shared().delegate = self

    // Включить debug только в dev-сборке
    AppsFlyerLib.shared().isDebug = false

    // Запускать start() после ATT-запроса, не раньше
    return true
}

// В SceneDelegate или после ответа ATT:
func applicationDidBecomeActive(_ application: UIApplication) {
    AppsFlyerLib.shared().start()
}

Критичный момент: start() нельзя вызывать до того, как пользователь ответил на ATT-запрос. Если вызвать раньше — SDK отправит событие без consent-флага, и Apple может заблокировать постбэк. Правильная последовательность: показать ATT → дождаться ответа → вызвать start().

Android (Kotlin)

// В Application.onCreate()
AppsFlyerLib.getInstance().init("YOUR_DEV_KEY", object : AppsFlyerConversionListener {
    override fun onConversionDataSuccess(data: Map<String, Any>) {
        val campaign = data["campaign"] as? String
        val mediaSource = data["media_source"] as? String
        // media_source = "googleadwords_int" для Google UAC
        Log.d("AF", "Attributed to: $mediaSource / $campaign")
    }
    override fun onConversionDataFail(error: String) {}
    override fun onAppOpenAttribution(data: Map<String, Any>) {}
    override fun onAttributionFailure(error: String) {}
}, this)

AppsFlyerLib.getInstance().start(this)

На Android важно добавить Google Play Referrer API как зависимость — без него атрибуция через Google UAC будет probabilistic:

// build.gradle
implementation("com.android.installreferrer:installreferrer:2.2")

Deeplink-атрибуция: где чаще всего ломается

OneLink / Universal Links / App Links позволяют атрибутировать не только установку, но и конкретный deeplink. Пользователь кликает по ссылке в Telegram, устанавливает приложение — и попадает сразу на нужный экран с корректной атрибуцией.

Типичная ошибка: Universal Links перестают работать после обновления приложения, если не обновили apple-app-site-association файл на сервере или Bundle ID поменяли без регенерации associated domains. В этом случае iOS fallback на HTTP-редирект, атрибуция теряется.

Ещё одна проблема — отсутствие onAppOpenAttribution обработчика при сценарии «приложение уже установлено». onConversionDataSuccess срабатывает только при первой установке. Повторные deep link переходы требуют отдельного обработчика.

Постбэки и верификация

После настройки MMP необходимо настроить постбэки в рекламные сети — иначе Google UAC и Meta не получают сигнал о конверсии и не могут оптимизировать кампании под целевое действие (in-app event вместо просто установки).

Проверка корректности атрибуции:

1. Используем тестовый девайс, добавляем IDFA/GAID в MMP dashboard как тестовое устройство
2. Кликаем по тестовой ссылке кампании
3. Устанавливаем приложение
4. Смотрим в MMP dashboard: атрибуция должна появиться за 1–2 минуты

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

• Выбор MMP под бюджет и рекламные каналы
• Интеграция SDK на iOS и Android (или Flutter)
• Настройка ATT-flow для iOS
• Конфигурация постбэков в Google, Meta, TikTok
• Настройка OneLink / Branch Links для deeplink-атрибуции
• Тестирование через тестовые девайсы и верификация постбэков

Сроки

Базовая интеграция одного MMP на обе платформы: 3–5 дней. С настройкой deeplink и всех рекламных постбэков — до 7 дней. Стоимость рассчитывается индивидуально.