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 задава дийп линка, към който потребителят ще отиде, ако приложението вече е инсталирано. За нови потребители се активира механизмът за отложен дийп линкинг: след инсталация и първо стартиране, SDK определя запазените параметри и насочва потребителя към нужния екран. Параметърът af_click_lookback определя прозореца на атрибуция — периода, в който кликът се счита за довел до инсталация.

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

След клик върху OneLink връзка, AppsFlyer записва клика и го свързва с уникален идентификатор на клик. Когато потребителят инсталира и отвори приложението, AppsFlyer SDK изпраща заявка до сървъра с идентификатор на устройството (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 (цена на инсталация), CR (коефициент на конверсия) и ROAS (възвръщаемост на рекламните разходи) за всеки източник.

Ретаргетинг и повторно ангажиране

За потребители, които вече са инсталирали приложението, OneLink поддържа ретаргетинг кампании. Когато съществуващ потребител кликне върху връзка, OneLink отваря приложението и предава промоционални параметри, като персонална отстъпка или бонус. AppsFlyer различава новите потребители от завърналите се чрез флага is_retargeting и създава отделни отчети за всеки тип трафик — важно за правилното изчисляване на LTV (стойност през целия живот).

Отложен дийп линкинг за органичен трафик

OneLink се използва не само в платени кампании, но и за органичен трафик: връзки в имейл бюлетини, SMS, QR кодове и социални мрежи. Ако потребителят няма инсталирано приложение, OneLink го насочва към App Store или Google Play, а след инсталация — към целевия екран: страница на продукт, статия, профил или промоционална оферта. Отложеният дийп линкинг е критичен за конверсия, тъй като премахва триенето между желанието на потребителя да извърши действие и необходимостта ръчно да търси нужния раздел.

Партньорски програми и influencer marketing

OneLink поддържа генериране на уникални връзки за всеки партньор или инфлуенсър. Параметърът af_sub1 може да съдържа ID на партньора, af_sub2 — името на публикацията или видеото. Това позволява на маркетолозите да видят кое съдържание носи най-много инсталации и конверсии и да оптимизират бюджета въз основа на данни, а не на предположения.

Настройка на OneLink в проект

За правилната работа на OneLink е необходима интеграция на AppsFlyer SDK в мобилното приложение. Процесът включва инсталиране на SDK, конфигуриране на домейна на OneLink и обработка на входящи дийп линкове чрез системните механизми на платформата — Universal Links на iOS и App Links на Android.

Интеграция на AppsFlyer SDK

Инсталирането на SDK се извършва чрез стандартни мениджъри на зависимости. На Android се добавя зависимост в Gradle, на iOS — чрез CocoaPods или Swift Package Manager. След инсталация, SDK се инициализира с dev ключ, получен от контролния панел на 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 ключ. Методът 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+ и по-високи версии, изисквайки потвърждение от потребителя. В такива условия fingerprinting се превръща в основен метод за атрибуция и неговата точност зависи пряко от качеството на данните — колкото повече подписи събира SDK, толкова по-голяма е вероятността за правилно съпоставяне на клик с инсталация.