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

Что такое OneLink?

OneLink — это технология создания умных диплинков от AppsFlyer, которая позволяет передавать атрибуционные параметры через ссылку и привязывать действия пользователя к конкретному рекламному источнику. Она решает ключевую проблему мобильного маркетинга: связь между кликом по объявлению и установкой приложения.

Обычный диплинк открывает приложение и может передать базовые параметры, но теряет информацию об источнике трафика при переходе через магазин приложений. OneLink использует комбинацию URL-параметров, идентификатора устройства и технологии fingerprinting для восстановления атрибуции после установки. Это позволяет маркетологам видеть, какая кампания, креатив и канал привели к конверсии — регистрации, покупке или другому целевому событию.

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 — диплинк внутри приложения.

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

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

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

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

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

OneLink vs обычный диплинк

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

OneLink использует собственный SDK для отслеживания событий внутри приложения и автоматической привязки их к атрибуционным данным. Это позволяет строить отчёты по всей воронке: от показа объявления до покупки, возврата средств или удержания пользователя на 7-й день. Обычные диплинки такой возможности не предоставляют — они работают исключительно как механизм навигации, без слоя аналитики и маркетинговой атрибуции.

Где применяется OneLink

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

Рекламные кампании по установкам

При запуске рекламы на установки (UA-кампании) OneLink-ссылки подставляются в объявления на Facebook Ads, Google Ads, TikTok, Snapchat и других платформах. Параметр pid однозначно идентифицирует платформу, а дополнительный параметр c (campaign) — конкретную кампанию. AppsFlyer автоматически сопоставляет клики с установками и показывает отчёт по CPI (cost per install), CR (conversion rate) и ROAS (return on ad spend) для каждого источника.

Ретаргетинг и повторное вовлечение

Для пользователей, которые уже установили приложение, OneLink поддерживает ретаргетинговые кампании. Когда существующий пользователь переходит по ссылке, OneLink открывает приложение и передаёт промо-параметры, такие как персональная скидка или бонус. AppsFlyer отличает новых пользователей от вернувшихся по флагу is_retargeting и строит отдельные отчёты для каждого типа трафика — важно для корректного расчёта LTV (lifetime value).

Deferred диплинкинг для органики

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

Партнёрские программы и influencer marketing

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, и автоматически начинает отслеживать установки и события.

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)
    }
}

В приведённом примере 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 для каждой рекламной кампании. Важно протестировать ссылки на всех платформах: в свежеустановленном приложении (deferred), в уже установленном (direct) и на веб-странице, если приложение не установлено. Тестирование выполняется через инструмент AppsFlyer Test Link, который симулирует поведение на всех платформах без необходимости публикации в магазины.

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