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
- 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%3D3for2onelink_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 deonelink_url. - Passo 2
Adicionar a biblioteca
Adicione a Play Install Referrer Library aobuild.gradle.ktsdo módulo do app:implementation("com.android.installreferrer:installreferrer:2.2") - 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() {} }) } - Passo 4
Agir com base no link
Leia do link o que o seu app precisa: um extra comocampaign=3for2para 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. - 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.