API de referência de instalação do Google Play

Esta documentação oferece referência técnica para o uso da API Play Install Referrer. A API Play Install Referrer é uma interface de serviço da AIDL usada principalmente por programadores não Java.

Observação:a biblioteca Play Install Referrer oferece um wrapper para a API Play Install Referrer e foi projetada para ajudar os programadores Java a usar a API.

Método getInstallReferrer()

Esse método retorna as informações de referência de instalação do app correspondentes ao nome do pacote fornecido, enviado por meio de um Bundle (chave mapeada na Tabela 1). Na resposta Bundle enviada pelo Google Play, as informações de referência são armazenadas nos campos mapeados para as chaves detalhadas na Tabela 2.

Tabela 1. Solicitação de dados do pacote getInstallReferrer().

Parâmetro Tipo Descrição
package_name String O nome do pacote do autor da chamada, usado para desambiguação.

Tabela 2. Dados de resposta de uma solicitação getInstallReferrer().

Tecla Tipo Descrição
install_referrer String O URL referenciador do pacote instalado.
referrer_click_timestamp_seconds long Carimbo de data/hora do lado do cliente, em segundos, de quando o clique no referenciador aconteceu.
install_begin_timestamp_seconds long O carimbo de data/hora do lado do cliente, em segundos, de quando a instalação do app começou.
referrer_click_timestamp_server_seconds long O carimbo de data/hora do lado do servidor, em segundos, de quando o clique no referenciador aconteceu.
install_begin_timestamp_server_seconds long O carimbo de data/hora do lado do servidor, em segundos, de quando a instalação do app começou.
install_version string A versão do app no momento em que ele foi instalado pela primeira vez.
google_play_instant boolean Indica se a experiência instantânea do seu app foi iniciada nos últimos sete dias.

Atenção: as informações de referência da instalação ficarão disponíveis por 90 dias e não serão alteradas, a menos que o app seja reinstalado. Para evitar chamadas de API desnecessárias no app, invoque a API apenas uma vez durante a primeira execução após a instalação.