En esta documentación, se proporciona una referencia técnica para usar la API de Play Install Referrer. La API de Play Install Referrer es una interfaz de servicio de AIDL que usan principalmente los programadores que no utilizan el lenguaje Java.
Nota: La biblioteca de referencia de instalación de Play proporciona un wrapper que rodea la API de referencia de instalación de Play y está diseñada para ayudar a los programadores de Java a usar la API.
El método getInstallReferrer()
Este método muestra información sobre la referencia de instalación de la app correspondiente al nombre del paquete determinado que se envió mediante un elemento Bundle (clave asignada en la tabla 1). En el elemento Bundle de respuesta que envía Google Play, la información de referencia se almacena en campos asignados a las claves que se detallan en la tabla 2.
Tabla 1: Solicitud de paquete de datos de getInstallReferrer()
| Parámetro | Tipo | Descripción |
|---|---|---|
package_name
|
String
|
El nombre del paquete del emisor, que se usa para la desambiguación. |
Tabla 2: Datos de respuesta de una solicitud getInstallReferrer()
| Clave | Tipo | Descripción |
|---|---|---|
install_referrer
|
String
|
La URL de referencia del paquete instalado |
referrer_click_timestamp_seconds
|
long
|
Es la marca de tiempo del cliente, en segundos, de cuando se produjo el clic de referencia. |
install_begin_timestamp_seconds
|
long
|
Es la marca de tiempo del cliente, en segundos, de cuando comenzó la instalación de la app. |
referrer_click_timestamp_server_seconds
|
long
|
Es la marca de tiempo del servidor, en segundos, de cuando se produjo el clic de referencia. |
install_begin_timestamp_server_seconds
|
long
|
Es la marca de tiempo del servidor, en segundos, de cuando comenzó la instalación de la app. |
install_version
|
string
|
La versión de la app en el momento en que esta se instaló por primera vez |
google_play_instant
|
boolean
|
Indica si la experiencia instantánea de tu app se lanzó en los últimos 7 días. |
Precaución: La información del referente de instalación estará disponible durante 90 días y no cambiará, a menos que se reinstale la aplicación. Para evitar llamadas innecesarias a la API en tu app, debes invocar la API solo una vez durante la primera ejecución después de la instalación.