Deferred deep linking no Android

As traduções são feitas usando IA. Se algumas traduções estão incorretas, por favor nos informe em hello@onelink.to

Quando alguém toca no seu Onelink e instala o seu app pelo Google Play, a Google Play Install Referrer API deixa o link tocado, com extras como ?campaign=3for2, disponível para o seu app por 90 dias após a instalação. Deferred deep linking (Android) está incluído no plano Team e superiores.

Requer alterações no seu app

  1. Passo 1

    Ativar

    No editor de Onelink, em “Other settings”, marque Enable Android deferred deep linking (Play install referrer) e salve. Em até 5 minutos, o seu app recebe um referrer como este após uma instalação:
    onelink_url=https%3A%2F%2Fonelink.to%2Fautumn%3Fcampaign%3D3for2
    onelink_url é o link que o visitante tocou, com os seus extras. Coloque os extras depois de ?: tudo o que vem depois de # fica no navegador do visitante e nunca chega ao Onelink.to. Se o link do Google Play ou o link tocado já tiver um referrer, é esse que chega ao seu app, sem alterações.
    O Onelink.to mantém o referrer em até 512 caracteres, codificado como URL, o limite documentado pelo Google. Se o link tocado com os seus extras o deixasse mais longo, os extras saem de onelink_url.
  2. Passo 2

    Adicionar a biblioteca

    Adicione a Play Install Referrer Library ao build.gradle.kts do módulo do app:
    implementation("com.android.installreferrer:installreferrer:2.2")
  3. Passo 3

    Ler o referrer na primeira abertura

    O Google Play mantém o referrer por 90 dias após a instalação. Chame isto a partir da activity inicial do app. A função lê o referrer uma vez e entrega o link 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. Passo 4

    Agir com base no link

    Leia do link o que o seu app precisa: um extra como campaign=3for2 para aplicar uma oferta, ou o caminho para abrir uma tela. Se o seu app já abre links no seu próprio domínio, passe o link para lá — veja Abrir links no seu app (deep linking). Qualquer pessoa pode adicionar extras a um link, então verifique-os antes de agir com base neles, como faria com qualquer link vindo de fora do app.
  5. Passo 5

    Testar com uma instalação real

    O Google Play define o referrer apenas quando a instalação segue um toque no seu Onelink, e instalações por faixas de teste interno e fechado podem chegar sem ele. Quando a versão que lê o referrer estiver publicada no Google Play, remova o app de um celular, toque no seu Onelink nesse celular, instale e abra o app.

Funcionalidades neste guia