OneLink: що це, технологія диплінкінгу та атрибуція встановлень

Що таке OneLink?

OneLink — це технологія створення розумних диплінків від AppsFlyer, яка дозволяє передавати атрибуційні параметри через посилання та прив'язувати дії користувача до конкретного рекламного джерела. Вона вирішує ключову проблему мобільного маркетингу: зв'язок між кліком по оголошенню та встановленням застосунку.

Звичайний диплінк відкриває застосунок і може передати базові параметри, але втрачає інформацію про джерело трафіку при переході через магазин застосунків. OneLink використовує комбінацію URL-параметрів, ідентифікатора пристрою та технології фінгепрінтінгу для відновлення атрибуції після встановлення. Це дозволяє маркетологам бачити, яка кампанія, креатив і канал привели до конверсії — реєстрації, покупки або іншої цільової події.

OneLink працює на всіх платформах: iOS (Universal Links), Android (App Links), веб-браузерах і навіть у десктопних застосунках. Посилання генеруються через панель керування AppsFlyer або програмно через REST API, що дає можливість динамічно підставляти параметри під кожну кампанію в реальному часі.

Як працює OneLink?

Принцип роботи OneLink ґрунтується на трьох послідовних етапах: перехід за посиланням, встановлення застосунку та зіставлення подій. На кожному етапі OneLink зберігає та передає атрибуційні дані, використовуючи комбінацію методів для точного визначення джерела трафіку.

Структура OneLink-посилання

OneLink-посилання має спеціальний формат, який включає домен AppsFlyer, ідентифікатор застосунку та параметри кампанії. Стандартний шаблон виглядає як https://app.onelink.me/{app-id}?pid={source}&c={campaign}&af_dp={deeplink}. Параметр pid (media source) вказує джерело трафіку, c — назву кампанії, af_dp — диплінк всередині застосунку.

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        AppsFlyerLib.getInstance()
            .start(this, "YOUR_DEV_KEY")
    }

    override fun onNewIntent(intent: Intent?) {
        super.onNewIntent(intent)
        AppsFlyerLib.getInstance()
            .onNewIntent(this, intent)
    }
}

Параметр af_dp задає диплінк, за яким перейде користувач, якщо застосунок уже встановлено. Для нових користувачів спрацьовує механізм відкладеного диплінкінгу: після встановлення та першого запуску SDK визначає збережені параметри та спрямовує користувача на потрібний екран. Параметр af_click_lookback задає вікно атрибуції — період, протягом якого клік вважається таким, що привів до встановлення.

Механізм атрибуції

Після переходу за OneLink-посиланням AppsFlyer записує клік і пов'язує його з унікальним ідентифікатором кліка. Коли користувач встановлює та відкриває застосунок, SDK AppsFlyer надсилає серверу запит з ідентифікатором пристрою (IDFA на iOS, GAID на Android). Сервер зіставляє ідентифікатор кліка з встановленням і визначає джерело трафіку.

Якщо точного збігу за ID не знайдено (наприклад, користувач вимкнув рекламний ідентифікатор), використовується фінгепрінтінг — аналіз IP-адреси, моделі пристрою, версії ОС та часової мітки. За даними AppsFlyer, фінгепрінтінг забезпечує точність атрибуції в 92–95% на iOS та 95–97% на Android навіть без рекламного ID. Комбінація детермінованого (IDFA/GAID) та ймовірнісного (фінгепрінтінг) методів дає найбільш повну картину джерел трафіку.

OneLink vs звичайний диплінк

Ключова відмінність OneLink від звичайного диплінка полягає в можливості збереження атрибуції на всьому шляху користувача. Звичайний диплінк (наприклад, myapp://screen) відкриває застосунок, але не може визначити, звідки прийшов користувач, якщо він щойно встановив застосунок із магазину.

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

Де застосовується OneLink

OneLink використовується в широкому спектрі маркетингових сценаріїв, де потрібна точна прив'язка дій користувача до рекламних джерел. Основні області застосування включають залучення нових користувачів, повернення існуючих та вимірювання ефективності кожного каналу.

Рекламні кампанії зі встановлень

При запуску реклами на встановлення (UA-кампанії) OneLink-посилання підставляються в оголошення на Facebook Ads, Google Ads, TikTok, Snapchat та інших платформах. Параметр pid однозначно ідентифікує платформу, а додатковий параметр c (campaign) — конкретну кампанію. AppsFlyer автоматично зіставляє кліки зі встановленнями та показує звіт по CPI (вартість за встановлення), CR (коефіцієнт конверсії) та ROAS (повернення на рекламні витрати) для кожного джерела.

Ретаргетинг і повторне залучення

Для користувачів, які вже встановили застосунок, OneLink підтримує ретаргетингові кампанії. Коли існуючий користувач переходить за посиланням, OneLink відкриває застосунок і передає промо-параметри, такі як персональна знижка або бонус. AppsFlyer відрізняє нових користувачів від тих, хто повернувся, за прапорцем is_retargeting та будує окремі звіти для кожного типу трафіку — важливо для коректного розрахунку LTV (життєвої цінності).

Відкладений диплінкінг для органіки

OneLink використовується не тільки в платних кампаніях, але й для органічного трафіку: посилання в email-розсилках, SMS, QR-кодах і соціальних мережах. Якщо користувач не встановив застосунок, OneLink спрямовує його в App Store або Google Play, а після встановлення — на цільовий екран: сторінку товару, статтю, профіль або промо-пропозицію. Відкладений диплінкінг критично важливий для конверсії, оскільки усуває тертя між бажанням користувача здійснити дію та необхідністю вручну шукати потрібний розділ.

Партнерські програми та інфлюенсер-маркетинг

OneLink підтримує генерацію унікальних посилань для кожного партнера або інфлюенсера. Параметр af_sub1 може містити ID партнера, af_sub2 — назву посту або відео. Це дозволяє маркетологам бачити, який контент приносить найбільше встановлень та конверсій, і оптимізувати бюджет на основі даних, а не здогадок.

Налаштування OneLink у проєкті

Для коректної роботи OneLink потрібна інтеграція SDK AppsFlyer у мобільний застосунок. Процес включає встановлення SDK, налаштування OneLink-домену та обробку вхідних диплінків через системні механізми платформи — Universal Links на iOS та App Links на Android.

Інтеграція SDK AppsFlyer

Встановлення SDK виконується через стандартні менеджери залежностей. На Android додається залежність в Gradle, на iOS — через CocoaPods або Swift Package Manager. Після встановлення SDK ініціалізується з dev key, отриманим у панелі керування AppsFlyer, та автоматично починає відстежувати встановлення та події.

https://app.onelink.me/A1b2C3d4?pid=facebook&c=summer_campaign&af_dp=myapp://promo/summer2026&af_click_lookback=7d

У наведеному прикладі SDK ініціалізується в методі onCreate головної Activity з використанням dev key. Метод onNewIntent обов'язковий для обробки диплінків, якщо застосунок уже запущено. Без цього виклику атрибуція для повторних відкриттів з OneLink-посилань не буде зафіксована, що спотворить статистику ретаргетингових кампаній.

Налаштування Universal Links (iOS)

Для iOS необхідно налаштувати Universal Links: додати entitlements з доменом OneLink (app.onelink.me) та розмістити файл apple-app-site-association на сервері. AppsFlyer автоматично генерує цей файл при налаштуванні OneLink у панелі; розробнику потрібно лише додати entitlement та обробити вхідні посилання в AppDelegate.

import AppsFlyerLib

class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        continue userActivity: NSUserActivity,
        restorationHandler: Any?
    ) -> Bool {
        AppsFlyerLib.shared()
            .continue(userActivity, restorationHandler: nil)
        return true
    }
}

Метод continue userActivity викликається системою при переході по Universal Link. Всередині нього викликається метод AppsFlyerLib.shared().continue, який витягує атрибуційні параметри з посилання та надсилає їх на сервер. Аналогічний підхід використовується на Android через Intent Filter з auto-verify для App Links.

Після завершення інтеграції OneLink-посилання можна генерувати через панель AppsFlyer або API для кожної рекламної кампанії. Важно протестувати посилання на всіх платформах: у щойно встановленому застосунку (відкладений), у вже встановленому (прямий) та на веб-сторінці, якщо застосунок не встановлено. Тестування виконується через інструмент AppsFlyer Test Link, який симулює поведінку на всіх платформах без необхідності публікації в магазини.

При роботі з OneLink важливо враховувати обмеження платформ: на iOS після введення App Tracking Transparency (ATT) доступ до IDFA вимагає явної згоди користувача, що знижує точність детермінованої атрибуції. Google також обмежує використання GAID на Android 14+ і вище, вимагаючи від користувача підтвердження. У таких умовах фінгепрінтінг стає основним методом атрибуції, і його точність безпосередньо залежить від якості даних — чим більше сигнатур збирає SDK, тим вища ймовірність коректного зіставлення кліка зі встановленням.