Esta é a parte quatro de um guia técnico de quatro partes sobre deep linking em Android. As publicações anteriores falaram sobre esquemas de URI, Chrome Intents, e App Links.
Como usar o Google Play Referrer para Deep Linking
Uma técnica de deep linking é para um caso de uso de nicho onde o aplicativo não está instalado. Como desenvolvedor, você tem a opção de passar um parâmetro personalizado pela Google Play store que, então, é recebido em seu aplicativo depois que o usuário abri-lo pela primeira vez. Esta técnica permite que você saiba de onde veio este novo usuário caso gerencie esse parâmetro de maneira adequada, e você também pode criar páginas de destino personalizadas ou deep link por meio do processo de instalação.
Requisitos para o Android Install Referrer
- O aplicativo não deve estar instalado
- Não pode ser usado com o Chrome intents, já que você precisa estruturar o URL da Play Store
Configurando o Android Install Referrer
Para configurar seu aplicativo para receber o Android install referrer, você deve registrar seu aplicativo para receber a transmissão com.android.vending.INSTALL_REFERRER Insira o seguinte entre as tags <application /> em seu manifesto.
Neste caso, io.branch.testbed.InstallListener é o nome de sua classe personalizada que receberá as transmissões. Esta é uma subclasse simples do BroadcastReceiver. Aqui está o código boilerplate que você precisará para esta classe:
Como lidar com isso dentro do aplicativo
Quando tiver configurado seu BroadcastReceiver como descrito acima, é fácil lidar com a intenção! É um mecanismo muito parecido com o gerenciamento de intenções de esquema de URI, mas acontece de dentro da chamada onReceive. É possível ver um exemplo aqui:
Uso prático para Google Play Referrer
Para usar essa técnica adequadamente, você deve poder controlar o link para a Google Play Store com o qual o usuário interage. Digamos que o nome de nosso pacote de aplicativo seja io.branch.testbed, então sabemos que o Google Play pode ser aberto com algum dos seguintes:
- market://details?id=io.branch.testbed
- https://play.google.com/store/apps/details?id=io.branch.testbed
Para adicionar um indicador, você precisará adicionar apenas &referrer=specialparam a algum desses links. Para fazer isso, você precisará controlar o link em si.
Observação: Como você pode ter notado lendo pela seção do Chrome Intent, você não tem controle sobre o link da Play Store, o que significa que você não poderá usar este método.
Para controlar o parâmetro do indicador, recomendamos integrá-lo no JS do lado do cliente como descrito no método URI. Aqui está uma amostra do código que mostra como o indicador é adicionado à função de fallback ao link de mercado que é executada após tentar abrir o aplicativo:
Conclusão
Se seus olhos estão ficando cansados ao ler isso, nós entendemos. O deep linking do Google é extremamente complicado e há casos extremos em todos os lugares. Caso use a ferramenta da Branch, você pode confiar que seus links funcionarão em todos os lugares.