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 desenvolvida 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
|
Nome do pacote do autor da chamada, usado para desambiguação. |
Tabela 2. Dados de resposta de uma solicitação getInstallReferrer().
| Chave | Tipo | Descrição |
|---|---|---|
install_referrer
|
String
|
O URL referenciador do pacote instalado. |
referrer_click_timestamp_seconds
|
long
|
O carimbo de data/hora do lado do cliente, em segundos, de quando o clique no referenciador ocorreu. |
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 ocorreu. |
install_begin_timestamp_server_seconds
|
long
|
O carimbo de data/hora do lado do servidor, em segundos, de quando a instalação do aplicativo começou. |
install_version
|
string
|
A versão do app no momento em que o app 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.