API de referencia de instalación de Play

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.