API de referencia de instalación de Play

En esta documentación, se proporciona una referencia técnica para usar la API de referencia de instalación de Play. La API de referencia de instalación de Play 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 datos del paquete 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 La marca de tiempo, en segundos, de cuando se produjo un clic de referencia.
install_begin_timestamp_seconds long La marca de tiempo, en segundos, de cuando comenzó una instalación.

Precaución: La información de referencia 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 cuando se ejecute la app por primera vez después de instalarla.