AndroidAndroid Deep linkingGoogleTécnico

Guia técnico para Deep Linking em Android: Google Play Referrer

By outubro 30, 2017 No Comments

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.

Google Play Referrer Google Deep Linking

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:

  1. market://details?id=io.branch.testbed
  2. 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.