Deferred deep linking su Android

Le traduzioni sono realizzate con IA. Se alcune traduzioni non sono corrette, per favore fatecelo sapere su hello@onelink.to

Quando qualcuno tocca il tuo Onelink e installa la tua app da Google Play, la Google Play Install Referrer API rende il link toccato, con extra come ?campaign=3for2, disponibile alla tua app per 90 giorni dopo l’installazione. Deferred deep linking (Android) è incluso dal piano Team in su.

Richiede modifiche alla tua app

  1. Passo 1

    Attivalo

    Nell’editor del Onelink, in “Other settings”, spunta Enable Android deferred deep linking (Play install referrer) e salva. Entro 5 minuti, dopo un’installazione la tua app riceve un referrer come questo:
    onelink_url=https%3A%2F%2Fonelink.to%2Fautumn%3Fcampaign%3D3for2
    onelink_url è il link toccato dal visitatore, con i suoi extra. Metti gli extra dopo ?: tutto ciò che segue # resta nel browser del visitatore e non arriva mai a Onelink.to. Se il link di Google Play o il link toccato contiene già un referrer, è invece quello ad arrivare invariato alla tua app.
    Onelink.to mantiene il referrer entro 512 caratteri, con codifica URL, il limite documentato da Google. Se il link toccato con i suoi extra lo rendesse più lungo, vengono tolti gli extra da onelink_url.
  2. Passo 2

    Aggiungi la libreria

    Aggiungi la Play Install Referrer Library al build.gradle.kts del modulo dell’app:
    implementation("com.android.installreferrer:installreferrer:2.2")
  3. Passo 3

    Leggi il referrer al primo avvio

    Google Play conserva il referrer per 90 giorni dopo l’installazione. Chiama questa funzione dalla tua activity di avvio. Legge il referrer una sola volta e passa il link toccato:
    fun readInstallReferrer(context: Context, open: (Uri) -> Unit) {
        val prefs = context.getSharedPreferences("install_referrer", Context.MODE_PRIVATE)
        if (prefs.getBoolean("read", false)) return
        val client = InstallReferrerClient.newBuilder(context).build()
        client.startConnection(object : InstallReferrerStateListener {
            override fun onInstallReferrerSetupFinished(responseCode: Int) {
                if (responseCode == InstallReferrerClient.InstallReferrerResponse.OK) {
                    val referrer = client.installReferrer.installReferrer
                    prefs.edit().putBoolean("read", true).apply()
                    Uri.Builder().encodedQuery(referrer).build()
                        .getQueryParameter("onelink_url")
                        ?.let { open(Uri.parse(it)) }
                }
                client.endConnection()
            }
    
            override fun onInstallReferrerServiceDisconnected() {}
        })
    }
  4. Passo 4

    Agisci in base al link

    Leggi dal link ciò che serve alla tua app: un extra come campaign=3for2 per applicare un’offerta, o il percorso per aprire una schermata. Se la tua app apre già i link sul tuo dominio, passa lì il link — vedi Aprire i link nella tua app (deep linking). Chiunque può aggiungere extra a un link, quindi controllali prima di agire in base a essi, come faresti con qualsiasi link proveniente dall’esterno dell’app.
  5. Passo 5

    Prova con un’installazione reale

    Google Play imposta il referrer solo quando l’installazione segue un tocco sul tuo Onelink, e le installazioni da canali di test interni e chiusi possono arrivare senza. Quando la versione che legge il referrer è pubblicata su Google Play, rimuovi l’app da un telefono, tocca il tuo Onelink su quel telefono, installa e apri l’app.

Funzionalità in questa guida