OneLink: ce este, tehnologia deep linking și atribuția instalărilor

Ce este OneLink?

OneLink este o tehnologie de creare a deep link-urilor inteligente de la AppsFlyer care permite transmiterea parametrilor de atribuție printr-un link și atribuirea acțiunilor utilizatorului unei surse publicitare specifice. Rezolvă problema cheie a marketingului mobil: legătura dintre clicul pe un anunț și instalarea aplicației.

Un deep link obișnuit deschide aplicația și poate transmite parametri de bază, dar pierde informațiile despre sursa de trafic la trecerea prin magazinul de aplicații. OneLink folosește o combinație de parametri URL, identificatorul dispozitivului și tehnologia de fingerprinting pentru a restabili atribuția după instalare. Acest lucru permite marketerilor să vadă ce campanie, creativă și canal au dus la conversie — înregistrare, achiziție sau alt eveniment țintă.

OneLink funcționează pe toate platformele: iOS (Universal Links), Android (App Links), browsere web și chiar aplicații desktop. Linkurile sunt generate prin panoul de control AppsFlyer sau programatic prin REST API, permițând inserarea dinamică a parametrilor pentru fiecare campanie în timp real.

Cum funcționează OneLink?

Principiul de funcționare al OneLink se bazează pe trei etape consecutive: clic pe link, instalarea aplicației și potrivirea evenimentelor. În fiecare etapă, OneLink păstrează și transmite datele de atribuție, folosind o combinație de metode pentru determinarea exactă a sursei de trafic.

Structura linkului OneLink

Linkul OneLink are un format special care include domeniul AppsFlyer, identificatorul aplicației și parametrii campaniei. Șablonul standard arată ca https://app.onelink.me/{app-id}?pid={source}&c={campaign}&af_dp={deeplink}. Parametrul pid (media source) indică sursa de trafic, c — numele campaniei, af_dp — deep link-ul în aplicație.

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

Parametrul af_dp setează deep link-ul la care va merge utilizatorul dacă aplicația este deja instalată. Pentru utilizatorii noi, se activează mecanismul de deferred deep linking: după instalare și prima lansare, SDK-ul determină parametrii salvați și direcționează utilizatorul către ecranul dorit. Parametrul af_click_lookback definește fereastra de atribuție — perioada în care clicul este considerat a fi dus la instalare.

Mecanismul de atribuție

După clicul pe un link OneLink, AppsFlyer înregistrează clicul și îl asociază cu un identificator unic de clic. Când utilizatorul instalează și deschide aplicația, SDK-ul AppsFlyer trimite serverului o cerere cu identificatorul dispozitivului (IDFA pe iOS, GAID pe Android). Serverul potrivește identificatorul de clic cu instalarea și determină sursa de trafic.

Dacă nu se găsește o potrivire exactă după ID (de exemplu, utilizatorul a dezactivat identificatorul publicitar), se folosește fingerprinting — analiza adresei IP, modelului dispozitivului, versiunii sistemului de operare și a timestamp-ului. Conform datelor AppsFlyer, fingerprinting asigură o acuratețe a atribuției de 92–95% pe iOS și 95–97% pe Android chiar și fără ID publicitar. Combinația metodelor deterministe (IDFA/GAID) și probabiliste (fingerprinting) oferă cea mai completă imagine a surselor de trafic.

OneLink vs deep link obișnuit

Diferența cheie dintre OneLink și un deep link obișnuit constă în capacitatea de a păstra atribuția pe întregul parcurs al utilizatorului. Un deep link obișnuit (de exemplu, myapp://screen) deschide aplicația, dar nu poate determina de unde a venit utilizatorul dacă tocmai a instalat aplicația din magazin.

OneLink folosește propriul SDK pentru urmărirea evenimentelor în aplicație și atribuirea automată a acestora la datele de atribuție. Acest lucru permite crearea de rapoarte pe întreaga pâlnie: de la afișarea anunțului până la achiziție, rambursare sau păstrarea utilizatorului în ziua a 7-a. Deep link-urile obișnuite nu oferă această posibilitate — ele funcționează exclusiv ca mecanism de navigare, fără strat de analitică și atribuție de marketing.

Unde se folosește OneLink

OneLink este utilizat într-o gamă largă de scenarii de marketing unde este necesară atribuirea precisă a acțiunilor utilizatorului la sursele publicitare. Principalele domenii de aplicare includ atragerea de noi utilizatori, reimplicarea celor existenți și măsurarea eficienței fiecărui canal.

Campanii publicitare pentru instalări

La lansarea reclamelor pentru instalări (campanii UA), linkurile OneLink sunt plasate în anunțurile de pe Facebook Ads, Google Ads, TikTok, Snapchat și alte platforme. Parametrul pid identifică unic platforma, iar parametrul suplimentar c (campaign) — campania specifică. AppsFlyer potrivește automat clicurile cu instalările și afișează raportul CPI (cost per install), CR (conversion rate) și ROAS (return on ad spend) pentru fiecare sursă.

Retargeting și reimplicare

Pentru utilizatorii care au instalat deja aplicația, OneLink suportă campanii de retargeting. Când un utilizator existent face clic pe un link, OneLink deschide aplicația și transmite parametri promoționali, cum ar fi reducere personală sau bonus. AppsFlyer diferențiază utilizatorii noi de cei care revin prin flag-ul is_retargeting și creează rapoarte separate pentru fiecare tip de trafic — important pentru calculul corect al LTV (lifetime value).

Deferred deep linking pentru trafic organic

OneLink este folosit nu doar în campanii plătite, ci și pentru trafic organic: linkuri în newslettere email, SMS, coduri QR și rețele sociale. Dacă utilizatorul nu are aplicația instalată, OneLink îl direcționează către App Store sau Google Play, iar după instalare — către ecranul țintă: pagina de produs, articol, profil sau ofertă promoțională. Deferred deep linking este critic pentru conversie, deoarece elimină frecarea dintre dorința utilizatorului de a acționa și necesitatea de a căuta manual secțiunea dorită.

Programe partenere și influencer marketing

OneLink suportă generarea de linkuri unice pentru fiecare partener sau influencer. Parametrul af_sub1 poate conține ID-ul partenerului, af_sub2 — numele postării sau videoclipului. Acest lucru permite marketerilor să vadă ce conținut aduce cele mai multe instalări și conversii și să optimizeze bugetul pe baza datelor, nu a presupunerilor.

Configurarea OneLink în proiect

Pentru funcționarea corectă a OneLink este necesară integrarea SDK-ului AppsFlyer în aplicația mobilă. Procesul include instalarea SDK-ului, configurarea domeniului OneLink și procesarea deep link-urilor primite prin mecanismele sistemului platformei — Universal Links pe iOS și App Links pe Android.

Integrarea SDK-ului AppsFlyer

Instalarea SDK-ului se face prin managerii de dependențe standard. Pe Android se adaugă o dependență în Gradle, pe iOS — prin CocoaPods sau Swift Package Manager. După instalare, SDK-ul este inițializat cu cheia de dezvoltator obținută din panoul de control AppsFlyer și începe automat să urmărească instalările și evenimentele.

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

În exemplul de mai sus, SDK-ul este inițializat în metoda onCreate a Activity-ului principal folosind cheia de dezvoltator. Metoda onNewIntent este obligatorie pentru procesarea deep link-urilor dacă aplicația este deja pornită. Fără acest apel, atribuția pentru deschiderile repetate din linkurile OneLink nu va fi înregistrată, ceea ce va distorsiona statisticile campaniilor de retargeting.

Configurarea Universal Links (iOS)

Pentru iOS este necesar să configurați Universal Links: să adăugați entitlements cu domeniul OneLink (app.onelink.me) și să plasați fișierul apple-app-site-association pe server. AppsFlyer generează automat acest fișier la configurarea OneLink în panou, dezvoltatorul trebuie doar să adauge entitlement și să proceseze linkurile primite în 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
    }
}

Metoda continue userActivity este apelată de sistem la trecerea printr-un Universal Link. În interiorul ei, este apelată metoda AppsFlyerLib.shared().continue, care extrage parametrii de atribuție din link și îi trimite la server. O abordare similară este folosită pe Android prin Intent Filter cu auto-verify pentru App Links.

După finalizarea integrării, linkurile OneLink pot fi generate prin panoul AppsFlyer sau API pentru fiecare campanie publicitară. Este important să testați linkurile pe toate platformele: în aplicația proaspăt instalată (deferred), în aplicația deja instalată (direct) și pe pagina web dacă aplicația nu este instalată. Testarea se face prin instrumentul AppsFlyer Test Link, care simulează comportamentul pe toate platformele fără a fi nevoie de publicare în magazine.

La lucrul cu OneLink trebuie luate în considerare limitările platformelor: pe iOS, după introducerea App Tracking Transparency (ATT), accesul la IDFA necesită consimțământul explicit al utilizatorului, ceea ce reduce acuratețea atribuției deterministe. Google limitează și el utilizarea GAID pe Android 14+ și superior, solicitând confirmarea utilizatorului. În astfel de condiții, fingerprinting devine metoda principală de atribuție, iar acuratețea sa depinde direct de calitatea datelor — cu cât SDK-ul colectează mai multe semnături, cu atât este mai mare probabilitatea potrivirii corecte a clicului cu instalarea.