API Play Install Referrer
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]
