OneLink: cos'è, tecnologia di deep linking e attribuzione delle installazioni

Cos'è OneLink?

OneLink è una tecnologia di deep link intelligenti di AppsFlyer che consente di passare parametri di attribuzione tramite un link e collegare le azioni dell'utente a una specifica fonte pubblicitaria. Risolve il problema chiave del marketing mobile: collegare un click su un annuncio a un'installazione dell'app.

Un deep link normale apre l'app e può passare parametri di base, ma perde le informazioni sulla fonte di traffico quando passa attraverso l'app store. OneLink utilizza una combinazione di parametri URL, ID dispositivo e tecnologia di fingerprinting per ripristinare l'attribuzione dopo l'installazione. Questo permette agli operatori di marketing di vedere quale campagna, creatività e canale hanno portato a una conversione — registrazione, acquisto o altro evento target.

OneLink funziona su tutte le piattaforme: iOS (Universal Links), Android (App Links), browser web e persino app desktop. I link vengono generati tramite il dashboard di AppsFlyer o programmaticamente tramite API REST, consentendo di impostare parametri dinamicamente per ogni campagna in tempo reale.

Come funziona OneLink?

Il principio di funzionamento di OneLink si basa su tre fasi sequenziali: click sul link, installazione dell'app e corrispondenza degli eventi. In ogni fase, OneLink conserva e trasmette i dati di attribuzione utilizzando una combinazione di metodi per determinare con precisione la fonte di traffico.

Struttura del link OneLink

Un link OneLink ha un formato speciale che include il dominio AppsFlyer, l'ID dell'app e i parametri della campagna. Il modello standard assomiglia a https://app.onelink.me/{app-id}?pid={source}&c={campaign}&af_dp={deeplink}. Il parametro pid (media source) indica la fonte di traffico, c è il nome della campagna, af_dp è il deep link all'interno dell'app.

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

Il parametro af_dp specifica il deep link che l'utente seguirà se l'app è già installata. Per i nuovi utenti, si attiva il meccanismo di deep linking differito: dopo l'installazione e il primo avvio, l'SDK determina i parametri salvati e indirizza l'utente alla schermata desiderata. Il parametro af_click_lookback imposta la finestra di attribuzione — il periodo durante il quale un click è considerato aver portato a un'installazione.

Meccanismo di attribuzione

Dopo aver cliccato su un link OneLink, AppsFlyer registra il click e lo associa a un ID click univoco. Quando l'utente installa e apre l'app, l'SDK AppsFlyer invia una richiesta al server con l'ID del dispositivo (IDFA su iOS, GAID su Android). Il server abbina l'ID click all'installazione e determina la fonte di traffico.

Se non viene trovata una corrispondenza esatta dell'ID (ad esempio, l'utente ha disattivato l'ID pubblicitario), viene utilizzato il fingerprinting — analisi dell'indirizzo IP, modello del dispositivo, versione del OS e timestamp. Secondo AppsFlyer, il fingerprinting fornisce una precisione di attribuzione del 92–95% su iOS e del 95–97% su Android anche senza ID pubblicitario. La combinazione di metodi deterministici (IDFA/GAID) e probabilistici (fingerprinting) fornisce il quadro più completo delle fonti di traffico.

OneLink vs deep link normale

La differenza principale tra OneLink e un deep link normale risiede nella capacità di preservare l'attribuzione lungo tutto il percorso dell'utente. Un deep link normale (ad esempio, myapp://screen) apre l'app ma non può determinare da dove è arrivato l'utente se ha appena installato l'app dallo store.

OneLink utilizza il proprio SDK per tracciare gli eventi all'interno dell'app e collegarli automaticamente ai dati di attribuzione. Ciò consente di creare report sull'intero imbuto, dall'impressione dell'annuncio all'acquisto, al rimborso o alla fidelizzazione dell'utente al giorno 7. I deep link normali non offrono questa capacità — funzionano esclusivamente come meccanismo di navigazione, senza un livello di analisi e attribuzione di marketing.

Dove si usa OneLink

OneLink è utilizzato in un'ampia gamma di scenari di marketing in cui è necessario collegare con precisione le azioni dell'utente alle fonti pubblicitarie. Le aree principali includono l'acquisizione di nuovi utenti, il re-engagement degli utenti esistenti e la misurazione dell'efficacia di ogni canale.

Campagne pubblicitarie di installazione

Quando si eseguono annunci di installazione (campagne UA), i link OneLink vengono inseriti negli annunci su Facebook Ads, Google Ads, TikTok, Snapchat e altre piattaforme. Il parametro pid identifica in modo univoco la piattaforma, e il parametro aggiuntivo c (campaign) identifica la campagna specifica. AppsFlyer abbina automaticamente i click alle installazioni e mostra report di CPI (costo per installazione), CR (tasso di conversione) e ROAS (ritorno sulla spesa pubblicitaria) per ogni fonte.

Retargeting e re-engagement

Per gli utenti che hanno già l'app installata, OneLink supporta campagne di retargeting. Quando un utente esistente clicca su un link, OneLink apre l'app e passa parametri promozionali come uno sconto personale o un bonus. AppsFlyer distingue i nuovi utenti dagli utenti di ritorno utilizzando il flag is_retargeting e crea report separati per ogni tipo di traffico — importante per il calcolo corretto del LTV (valore nel tempo).

Deep linking differito per traffico organico

OneLink è utilizzato non solo in campagne a pagamento ma anche per traffico organico: link in newsletter via email, SMS, codici QR e social network. Se l'utente non ha installato l'app, OneLink lo indirizza all'App Store o a Google Play, e dopo l'installazione — alla schermata di destinazione: pagina prodotto, articolo, profilo o offerta promozionale. Il deep linking differito è fondamentale per la conversione poiché elimina l'attrito tra il desiderio dell'utente di compiere un'azione e la necessità di trovare manualmente la sezione corretta.

Programmi partner e influencer marketing

OneLink supporta la generazione di link unici per ogni partner o influencer. Il parametro af_sub1 può contenere l'ID del partner, af_sub2 — il nome del post o del video. Ciò consente agli operatori di marketing di vedere quale contenuto genera il maggior numero di installazioni e conversioni e ottimizzare il budget basandosi sui dati, non sulle supposizioni.

Configurazione di OneLink in un progetto

Affinché OneLink funzioni correttamente, l'SDK AppsFlyer deve essere integrato nell'app mobile. Il processo include l'installazione dell'SDK, la configurazione del dominio OneLink e la gestione dei deep link in arrivo attraverso i meccanismi di sistema della piattaforma — Universal Links su iOS e App Links su Android.

Integrazione dell'SDK AppsFlyer

L'SDK viene installato tramite i gestori di dipendenze standard. Su Android, la dipendenza viene aggiunta in Gradle; su iOS, tramite CocoaPods o Swift Package Manager. Dopo l'installazione, l'SDK viene inizializzato con una chiave sviluppatore ottenuta dal dashboard di AppsFlyer e inizia automaticamente a tracciare installazioni ed eventi.

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

Nell'esempio sopra, l'SDK viene inizializzato nel metodo onCreate dell'Activity principale utilizzando la chiave sviluppatore. Il metodo onNewIntent è obbligatorio per gestire i deep link se l'app è già in esecuzione. Senza questa chiamata, l'attribuzione per le riaperture da link OneLink non verrà registrata, distorcendo le statistiche delle campagne di retargeting.

Configurazione Universal Links (iOS)

Per iOS, è necessario configurare Universal Links: aggiungere entitlements con il dominio OneLink (app.onelink.me) e posizionare il file apple-app-site-association sul server. AppsFlyer genera automaticamente questo file durante la configurazione di OneLink nel dashboard; lo sviluppatore deve solo aggiungere l'entitlement e gestire i link in arrivo nell'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
    }
}

Il metodo continue userActivity viene chiamato dal sistema quando si segue un Universal Link. Al suo interno, viene chiamato AppsFlyerLib.shared().continue, che estrae i parametri di attribuzione dal link e li invia al server. Un approccio simile viene utilizzato su Android con Intent Filter e auto-verify per App Links.

Dopo aver completato l'integrazione, i link OneLink possono essere generati tramite il dashboard di AppsFlyer o l'API per ogni campagna pubblicitaria. È importante testare i link su tutte le piattaforme: su un'app appena installata (differito), su un'app già installata (diretto) e su una pagina web se l'app non è installata. Il test viene effettuato tramite lo strumento Test Link di AppsFlyer, che simula il comportamento su tutte le piattaforme senza bisogno di pubblicare sugli store.

Quando si lavora con OneLink, è importante considerare le limitazioni delle piattaforme: su iOS, dopo l'introduzione di App Tracking Transparency (ATT), l'accesso all'IDFA richiede il consenso esplicito dell'utente, riducendo la precisione dell'attribuzione deterministica. Google limita anche l'uso di GAID su Android 14+ e superiori, richiedendo la conferma dell'utente. In queste condizioni, il fingerprinting diventa il metodo principale di attribuzione e la sua precisione dipende direttamente dalla qualità dei dati — più segnali l'SDK raccoglie, maggiore è la probabilità di abbinare correttamente un click a un'installazione.