Cuando alguien toca tu Onelink e instala tu app desde Google Play, la Google Play Install Referrer API pone a disposición de tu app el enlace que tocó, con datos adicionales como
?campaign=3for2, durante 90 días después de la instalación. Deferred deep linking (Android) está incluido en el plan Team y superiores.Requiere cambios en tu app
- Paso 1
Actívalo
En el editor de Onelink, en "Other settings", marca Enable Android deferred deep linking (Play install referrer) y guarda. En un plazo de 5 minutos, tu app recibe tras una instalación un referrer como este:onelink_url=https%3A%2F%2Fonelink.to%2Fautumn%3Fcampaign%3D3for2onelink_urles el enlace que tocó el visitante, con sus datos adicionales. Pon los datos adicionales después de?: todo lo que va después de#se queda en el navegador del visitante y nunca llega a Onelink.to. Si el enlace de Google Play o el enlace tocado ya lleva un referrer, es ese el que llega sin cambios a tu app.Onelink.to mantiene el referrer dentro de 512 caracteres, codificado como URL, el límite que documenta Google. Si el enlace tocado con sus datos adicionales lo haría más largo, se omiten los datos adicionales deonelink_url. - Paso 2
Añade la biblioteca
Añade la Play Install Referrer Library albuild.gradle.ktsdel módulo de la app:implementation("com.android.installreferrer:installreferrer:2.2") - Paso 3
Lee el referrer en el primer inicio
Google Play conserva el referrer durante 90 días después de la instalación. Llama a esta función desde tu actividad de inicio. Lee el referrer una sola vez y entrega el enlace tocado: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() {} }) } - Paso 4
Actúa según el enlace
Lee lo que tu app necesita del enlace: un dato adicional comocampaign=3for2para aplicar una oferta, o la ruta para abrir una pantalla. Si tu app ya abre enlaces de tu propio dominio, pasa el enlace a ese código — consulta Abrir enlaces en tu app (deep linking). Cualquiera puede añadir datos adicionales a un enlace, así que compruébalos antes de actuar en consecuencia, como harías con cualquier enlace que llegue de fuera de la app. - Paso 5
Prueba con una instalación real
Google Play solo establece el referrer cuando la instalación sigue a un toque en tu Onelink, y las instalaciones desde canales de pruebas internas y cerradas pueden llegar sin él. Cuando la versión que lee el referrer esté publicada en Google Play, elimina la app de un teléfono, toca tu Onelink en ese teléfono, instálala y abre la app.