Questa documentazione fornisce riferimenti tecnici per l'utilizzo dell'API Play Install Referrer. L'API Play Install Referrer è un'AIDL Service Interface utilizzata principalmente da programmatori non Java.
Nota: la libreria dei referrer di installazione di Play fornisce un wrapper per l'API Play Install Referrer ed è progettata per aiutare i programmatori Java a utilizzare l'API.
Il metodo getInstallReferrer()
Questo metodo restituisce le informazioni del referrer di installazione dell'app corrispondenti al nome del pacchetto specificato inviate tramite un codice Bundle (chiave mappata nella tabella 1). Nella risposta Bundle inviata da Google Play, le informazioni sui referral vengono archiviate in campi mappati alle chiavi dettagliate nella tabella 2.
Tabella 1. Richiesta di dati del pacchetto getInstallReferrer().
| Parametro | Tipo | Descrizione |
|---|---|---|
package_name
|
String
|
Il nome del pacchetto del chiamante, utilizzato per la disambiguazione. |
Tabella 2. Dati di risposta a una richiesta getInstallReferrer().
| Chiave | Tipo | Descrizione |
|---|---|---|
install_referrer
|
String
|
L'URL referrer del pacchetto installato. |
referrer_click_timestamp_seconds
|
long
|
Il timestamp lato client, in secondi, in cui si è verificato il clic del referrer. |
install_begin_timestamp_seconds
|
long
|
Il timestamp lato client, in secondi, in cui è iniziata l'installazione dell'app. |
referrer_click_timestamp_server_seconds
|
long
|
Il timestamp lato server, in secondi, in cui si è verificato il clic referrer. |
install_begin_timestamp_server_seconds
|
long
|
Il timestamp lato server, in secondi, dell'inizio dell'installazione dell'app. |
install_version
|
string
|
La versione dell'app alla data della sua prima installazione. |
google_play_instant
|
boolean
|
Indica se l'app istantanea della tua app è stata lanciata negli ultimi 7 giorni. |
Attenzione: le informazioni sul referrer di installazione saranno disponibili per 90 giorni e non cambieranno a meno che l'applicazione non venga reinstallata. Per evitare chiamate API non necessarie nella tua app, devi richiamare l'API solo una volta durante la prima esecuzione dopo l'installazione.