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
- 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%3D3for2onelink_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 daonelink_url. - Passo 2
Aggiungi la libreria
Aggiungi la Play Install Referrer Library albuild.gradle.ktsdel modulo dell’app:implementation("com.android.installreferrer:installreferrer:2.2") - 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() {} }) } - Passo 4
Agisci in base al link
Leggi dal link ciò che serve alla tua app: un extra comecampaign=3for2per 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. - 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.