API de referencia de instalación de Play
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-27 (UTC)"],[],[],null,["# Play Install Referrer API\n\nThis documentation provides technical reference for using the\nPlay Install Referrer API. The Play Install Referrer API is an\n[AIDL Service Interface](https://developer.android.com/guide/components/aidl.html)\nprimarily used by non-Java programmers.\n\n\n**Note:** The\n[Play Install Referrer Library](/google/play/installreferrer/library)\nprovides a wrapper around the Play Install Referrer API and is designed to help Java\nprogrammers use the API.\n\nThe getInstallReferrer() method\n-------------------------------\n\nThis method returns the app install referrer information corresponding to the\ngiven package name sent through a `Bundle` (key mapped in table 1). In the\nresponse `Bundle` sent by Google Play, the referral information is stored in\nfields mapped to the keys detailed in table 2.\n\n\n**Table 1.** `getInstallReferrer()` bundle data\nrequest.\n\n| Parameter | Type | Description |\n|----------------|----------|----------------------------------------------------------|\n| `package_name` | `String` | The package name of the caller, used for disambiguation. |\n\n\n**Table 2.** Response data from a `getInstallReferrer()`\nrequest.\n\n| Key | Type | Description |\n|-------------------------------------------|-----------|--------------------------------------------------------------------------------------|\n| `install_referrer` | `String` | The referrer URL of the installed package. |\n| `referrer_click_timestamp_seconds` | `long` | The client-side timestamp, in seconds, when the referrer click happened. |\n| `install_begin_timestamp_seconds` | `long` | The client-side timestamp, in seconds, when app installation began. |\n| `referrer_click_timestamp_server_seconds` | `long` | The server-side timestamp, in seconds, when the referrer click happened. |\n| `install_begin_timestamp_server_seconds` | `long` | The server-side timestamp, in seconds, when app installation began. |\n| `install_version` | `string` | The app's version at the time when the app was first installed. |\n| `google_play_instant` | `boolean` | Indicates whether your app's instant experience was launched within the past 7 days. |\n\n**Caution:** The install referrer information will be\navailable for 90 days and **won't change** unless the application is\nreinstalled. To avoid unnecessary API calls in your app, you should invoke the\nAPI **only once** during the first execution after install."]]
