Cette documentation fournit des références techniques sur l'utilisation de l'API Play Install Referrer. L'API Play Install Referrer est une interface de service AIDL principalement utilisée par les programmeurs non Java.
Remarque : La bibliothèque Play Install Referrer fournit un wrapper pour l'API Play Install Referrer et est conçue pour aider les programmeurs Java à utiliser l'API.
La méthode getInstallReferrer()
Cette méthode renvoie les informations de provenance de l'installation de l'application correspondant au nom de package donné envoyé via Bundle (clé mappée dans le tableau 1). Dans la réponse Bundle envoyée par Google Play, les informations de provenance sont stockées dans des champs mappés sur les clés détaillées dans le tableau 2.
Tableau 1 : Requête de données du bundle getInstallReferrer().
| Paramètre | Type | Description |
|---|---|---|
package_name
|
String
|
Nom de package de l'appelant, utilisé pour lever l'ambiguïté. |
Tableau 2 : Données de réponse d'une requête getInstallReferrer().
| Clé | Type | Description |
|---|---|---|
install_referrer
|
String
|
L'URL de provenance du package installé. |
referrer_click_timestamp_seconds
|
long
|
L'horodatage côté client (en secondes) correspondant au clic sur l'URL de provenance. |
install_begin_timestamp_seconds
|
long
|
L'horodatage côté client, en secondes, correspondant au début de l'installation de l'application. |
referrer_click_timestamp_server_seconds
|
long
|
L'horodatage (en secondes) côté serveur, lorsque le clic sur l'URL de provenance s'est produit. |
install_begin_timestamp_server_seconds
|
long
|
L'horodatage côté serveur correspondant au début de l'installation de l'application. |
install_version
|
string
|
La version de l'application lors de sa première installation. |
google_play_instant
|
boolean
|
Indique si l'expérience instantanée de votre application a été lancée au cours des sept derniers jours. |
Attention : Les informations sur l'URL de provenance de l'installation sont disponibles pendant 90 jours et ne changent pas, sauf si l'application est réinstallée. Pour éviter des appels d'API inutiles dans votre application, vous ne devez appeler l'API qu'une seule fois lors de la première exécution après l'installation.