Deferred deep linking en Android

Las traducciones se realizan con IA. Si algunas traducciones son incorrectas, por favor háganoslo saber en hello@onelink.to

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

  1. 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%3D3for2
    onelink_url es 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 de onelink_url.
  2. Paso 2

    Añade la biblioteca

    Añade la Play Install Referrer Library al build.gradle.kts del módulo de la app:
    implementation("com.android.installreferrer:installreferrer:2.2")
  3. 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() {}
        })
    }
  4. Paso 4

    Actúa según el enlace

    Lee lo que tu app necesita del enlace: un dato adicional como campaign=3for2 para 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.
  5. 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.

Funciones de esta guía