Play Install Referrer API'si
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu dokümanda, Play Upload Referrer API'nin kullanımıyla ilgili teknik referans verilmektedir. Play Upload Referrer API, çoğunlukla Java dışındaki programcılar tarafından kullanılan bir AIDL Hizmet Arayüzü'dür.
Not: Play Upload Referrer Library, Play Upload Referrer API ile ilgili bir sarmalayıcı sunar ve Java programcılarının API'yi kullanmasına yardımcı olmak üzere tasarlanmıştır.
getInstallReferrer() yöntemi
Bu yöntem, bir Bundle (Tablo 1'de bulunan anahtar eşlemesi) üzerinden gönderilen belirli paket adına karşılık gelen uygulama yükleme yönlendiren bilgilerini döndürür. Google Play tarafından gönderilen Bundle yanıtında, yönlendirme bilgileri tablo 2'de ayrıntılı olarak verilen anahtarlarla eşlenen alanlarda depolanır.
Tablo 1. getInstallReferrer() paket verisi isteği.
|
Parametre
|
Tür
|
Açıklama
|
package_name
|
String
|
Arayanın paket adı (belirsizliği gidermek için kullanılır).
|
Tablo 2. Bir getInstallReferrer() isteğindeki yanıt verileri.
|
Anahtar
|
Tür
|
Açıklama
|
install_referrer
|
String
|
Yüklü paketin yönlendiren URL'si.
|
referrer_click_timestamp_seconds
|
long
|
Yönlendiren tıklamasının gerçekleştiği saniye cinsinden istemci tarafı zaman damgası.
|
install_begin_timestamp_seconds
|
long
|
Uygulama yüklemenin başladığı zamanın saniye cinsinden istemci tarafı zaman damgası.
|
referrer_click_timestamp_server_seconds
|
long
|
Yönlendiren tıklamasının gerçekleştiği sunucu tarafı zaman damgası (saniye cinsinden).
|
install_begin_timestamp_server_seconds
|
long
|
Uygulama yükleme işleminin başladığı sunucu tarafı zaman damgası (saniye cinsinden).
|
install_version
|
string
|
Uygulamanın, uygulamanın ilk yüklendiği sıradaki sürümü.
|
google_play_instant
|
boolean
|
Uygulamanızın hazır uygulama deneyiminin son 7 gün içinde başlatılıp başlatılmadığını belirtir.
|
Dikkat: Yükleme yönlendireni bilgileri 90 gün boyunca kullanılabilir ve uygulama yeniden yüklenmediği sürece değişmez. Uygulamanızda gereksiz API çağrıları olmasını önlemek için API'yi yüklemeden sonraki ilk yürütme sırasında yalnızca bir kez çağırmanız gerekir.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[null,null,["Son güncelleme tarihi: 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."]]
