Play Install Referrer API
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Diese Dokumentation enthält eine technische Referenz für die Verwendung der Play Install Referrer API. Die Play Install Referrer API ist eine AIDL Service Interface, die hauptsächlich von Nicht-Java-Programmierern verwendet wird.
Hinweis:Die Play Install Referrer Library bietet einen Wrapper um die Play Install Referrer API und soll Java-Programmierern die Verwendung der API erleichtern.
Die getInstallReferrer()-Methode
Diese Methode gibt die Informationen zur Referrer-URL für die App-Installation zurück, die dem angegebenen Paketnamen entsprechen und über einen Bundle (Schlüssel zugeordnet in Tabelle 1) gesendet wurden. In der von Google Play gesendeten Antwort Bundle werden die Verweisinformationen in Feldern gespeichert, die den in Tabelle 2 beschriebenen Schlüsseln zugeordnet sind.
Tabelle 1 getInstallReferrer()-Anfrage für Datenbündel.
|
Parameter
|
Typ
|
Beschreibung
|
package_name
|
String
|
Der Paketname des Aufrufers, der zur Unterscheidung verwendet wird.
|
Tabelle 2 Antwortdaten aus einer getInstallReferrer()-Anfrage.
|
Schlüssel
|
Typ
|
Beschreibung
|
install_referrer
|
String
|
Die Referrer-URL des installierten Pakets.
|
referrer_click_timestamp_seconds
|
long
|
Clientseitiger Zeitstempel in Sekunden für die Zeit, zu der der Referrer-Klick erfolgte
|
install_begin_timestamp_seconds
|
long
|
Der clientseitige Zeitstempel in Sekunden für den Beginn der App-Installation.
|
referrer_click_timestamp_server_seconds
|
long
|
Serverseitiger Zeitstempel in Sekunden für die Zeit, zu der der Referrer-Klick erfolgte
|
install_begin_timestamp_server_seconds
|
long
|
Der serverseitige Zeitstempel in Sekunden für den Beginn der App-Installation.
|
install_version
|
string
|
Die Version der App zum Zeitpunkt der Installation.
|
google_play_instant
|
boolean
|
Gibt an, ob die Instant-Funktion Ihrer App in den letzten 7 Tagen eingeführt wurde.
|
Achtung:Die Informationen zur Verweis-URL für die Installation sind 90 Tage lang verfügbar und ändern sich nicht, sofern die App nicht neu installiert wird. Um unnötige API-Aufrufe in Ihrer Anwendung zu vermeiden, sollten Sie die API bei der ersten Ausführung nach der Installation nur einmal aufrufen.
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[null,null,["Zuletzt aktualisiert: 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."]]
