Deferred Deep Link: cos'è, come funziona e viene utilizzato nello sviluppo

Cos'è Deferred Deep Link?

Deferred Deep Link è un tipo di deep link che funziona in due fasi: prima l'utente clicca sul link prima che l'app sia installata, poi il sistema ripristina il contesto dopo il completamento dell'installazione. Un deep link normale apre l'app solo se è già installata, mentre deferred salva tutti i parametri di transizione e li trasmette al primo avvio.

La tecnologia è diventata particolarmente richiesta con la crescita del marketing mobile, dove le campagne pubblicitarie spesso mirano a utenti che non hanno ancora installato l'app. Senza deferred deep link, ciascuna di queste transizioni finirebbe semplicemente con il download dell'app senza alcun contesto — l'utente arriverebbe sulla schermata principale invece di quella di destinazione.

Differenza dal deep link normale

Un deep link normale apre il contenuto di destinazione in un'app già installata. Se l'app non è installata, il browser mostra un errore. Deferred Deep Link funziona attraverso un server intermedio che reindirizza l'utente al negozio e, dopo l'installazione, notifica l'app dei parametri salvati. Pertanto, un link deferred non richiede la pre-installazione dell'app e fornisce un percorso utente completo dall'annuncio al contenuto.

Come funziona Deferred Deep Link

L'elaborazione del deferred deep link consiste in tre fasi. Nella prima fase, l'utente clicca sul link — il server determina se l'app è installata. Se non lo è, genera un identificatore di sessione univoco, salva i parametri di transizione e reindirizza l'utente all'App Store o a Google Play con questo identificatore.

Nella seconda fase, l'utente installa l'app dal negozio. Dopo l'installazione e il primo avvio, l'SDK della piattaforma contatta il server, trasmette l'identificatore del dispositivo e riceve i parametri di transizione salvati. Nella terza fase, l'app elabora i dati ricevuti e reindirizza automaticamente l'utente alla schermata di destinazione.

Ciclo di vita del link deferred

Per salvare i parametri tra il clic sul link e l'installazione, vengono utilizzati vari meccanismi. Su iOS, si tratta del portachiavi iCloud (iCloud Keychain) o degli appunti; su Android, dell'Install Referrer API. Firebase Dynamic Links utilizza una combinazione di localStorage del browser e del link di referral del negozio per trasmettere l'identificatore di sessione. Branch.io impiega il proprio protocollo con backup dei dati in più archivi.

Deferred Deep Link su iOS

Su iOS, deferred deep link viene implementato attraverso una combinazione di Universal Links e Shared Web Credentials. Quando un utente clicca su un Universal Link per il sito web dell'app, Safari salva i parametri di transizione nel portachiavi iCloud associato al dominio dell'app. Dopo aver installato l'app dall'App Store, iOS verifica la presenza dei dati salvati e li trasmette all'app al primo avvio.

Apple non fornisce un'API integrata per deferred deep link — l'implementazione è interamente affidata a SDK di terze parti. Firebase Dynamic Links utilizza un meccanismo passive deferred, dove i dati vengono salvati nei cookie del browser e ripristinati tramite un reindirizzamento a un URL speciale al primo avvio dell'app.

Limitazioni su iOS

A partire da iOS 14, Apple ha inasprito le norme sulla privacy, influenzando i meccanismi di deferred deep link. Gli appunti non possono più essere utilizzati per leggere dati senza autorizzazione esplicita dell'utente. Anche il portachiavi iCloud ha limiti di volume dei dati — non più di 4 KB per scrittura. Ciò rende le soluzioni lato server con identificatore di sessione univoco il metodo preferito per trasmettere il contesto.

Deferred Deep Link su Android

Android offre opzioni più flessibili per deferred deep link tramite Install Referrer API. Quando un utente clicca su un link a Google Play, il negozio cattura il referrer — una stringa con parametri di transizione. Dopo l'installazione, l'app riceve questa stringa tramite Install Referrer API e ne estrae il contesto di destinazione. Questo è il meccanismo di deferred deep link più affidabile su Android.

Per le app distribuite al di fuori di Google Play, Android supporta un BroadcastReceiver di referral. Lo sviluppatore può inviare un Intent personalizzato con parametri dopo l'installazione e l'app lo riceverà tramite un BroadcastReceiver registrato nel manifest. Tuttavia, questo meccanismo è meno affidabile poiché dipende dall'implementazione dell'installer.

Install Referrer API

Install Referrer API fornisce informazioni sulla fonte di installazione, inclusi URL del referrer, ora del clic e ora dell'installazione. La lunghezza massima della stringa referrer è di 8 KB, sufficiente per trasmettere tutti i parametri necessari del deep link. L'API è disponibile su dispositivi con Google Play Store versione 8.3.73 e superiore, ed è supportata su Android 5.0 (API 21).

Implementazione con Firebase Dynamic Links

Firebase Dynamic Links è lo strumento gratuito più popolare per implementare deferred deep link su entrambe le piattaforme. Firebase gestisce automaticamente tutte le fasi della transizione deferred: reindirizzamento al negozio in assenza dell'app, memorizzazione dei parametri sul server Firebase e trasmissione all'SDK al primo avvio dell'app.

Per implementare, basta integrare l'SDK Firebase nel progetto, creare un Dynamic Link tramite Firebase Console specificando il deep link e i parametri della campagna. L'SDK Firebase viene chiamato automaticamente all'avvio dell'app e verifica la presenza di un Dynamic Link in arrivo tramite il metodo getDynamicLink().

Esempio di configurazione dell'elaborazione

Esempio di elaborazione di un Firebase Dynamic Link differito in un'Activity in Kotlin. Il codice funziona allo stesso modo per cold start e warm start all'avvio dell'app.

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        checkDeferredLink()
    }

    private fun checkDeferredLink() {
        FirebaseDynamicLinks.getInstance()
            .getDynamicLink(intent)
            .addOnSuccessListener link ->
                val deferredLink = link?.link.toString()
                if (deferredLink.isNotEmpty()) {
                    navigateToContent(deferredLink)
                }
            }
    }
}

Il metodo getDynamicLink() restituisce un PendingTask con un oggetto DynamicLink. Se l'app è stata installata dopo il clic sul link, il listener riceverà dati con parametri. Se l'app era già installata prima della transizione, il metodo restituirà gli stessi dati di un deep link normale. Il flag minimumAppVersion nei parametri del link consente di impostare la versione minima dell'app per l'elaborazione.

Vantaggi e limitazioni di Deferred Deep Link

Deferred Deep Link offre vantaggi significativi per le campagne di marketing: l'utente riceve il contenuto di destinazione dopo l'installazione senza azioni aggiuntive, aumentando la conversione e la fidelizzazione. Per i programmi di referral, i link deferred consentono di collegare in modo inequivocabile l'invito all'installazione e alle azioni del nuovo utente.

Tuttavia, la tecnologia ha anche dei limiti. Deferred deep link non funziona nei browser che bloccano i cookie di terze parti e su iOS dalla versione 14 richiede una configurazione aggiuntiva per iCloud Keychain. Inoltre, tra il clic sul link e l'installazione possono passare diversi giorni e non tutti gli SDK garantiscono la conservazione dei dati per tale periodo.

Quando utilizzare deferred deep link

Deferred deep link è obbligatorio per le campagne pubblicitarie mirate a nuovi utenti, newsletter via email con inviti e programmi di referral. Per gli utenti già installati, è sufficiente un deep link normale. Se l'app non utilizza campagne di marketing o meccanismi di referral, deferred deep link non è necessario — Universal Links e App Links sono sufficienti.

Quando si sceglie un'implementazione, considerare il costo: Firebase Dynamic Links è gratuito ma ha analisi limitate. Branch.io e AppsFlyer forniscono attribuzione avanzata ma richiedono un abbonamento. Per progetti piccoli, Firebase è la soluzione ottimale; per aziende con dozzine di canali pubblicitari, gli MMP commerciali sono la scelta.