Google Play Install Referrer Gerçek Cihazda Nasıl Test Edilir
Android Studio’dan yüklenen bir build’de install referrer hiç olmaz; bu yüzden çoğu test boş bir değer okuyup orada kalır. Gerçek bir değeri nasıl alırsınız: kodlanmış bir Play URL’si, dahili test kanalı, temiz bir yükleme ve ilk açılışta Kotlin ile okuma. Ayrıca boş ya da tuhaf her sonucun ne anlama geldiği.
Google Play’e referrer’ı kendisi taşıyan linkler
- Google Play, App Store ve web siteniz için tek link
- Kampanya ve link adı yüklemeden sonra da korunur
- Ücretsiz plan, kredi kartı gerekmez
Kısa yanıt
Google Play Install Referrer gerçek cihazda nasıl test edilir?
Build’i dahili test kanalında yayınlayın, uygulamayı test telefonundan kaldırın, referrer’ı URL-encode edilmiş bir Play URL’sini o telefonda açın, Play sayfasından yükleyin ve değeri ilk açılışta Play Install Referrer Library ile okuyun. Android Studio’dan ya da adb ile yüklenen bir build hiçbir zaman kampanya referrer’ı taşımaz.
Öne çıkanlar
- Referrer bir yüklemeye sabitlenir ve 90 gün saklanır; tekrar test etmek için uygulamayı kaldırıp Play URL’sinden yeniden yükleyin.
- Değeri kodlayın ki = ve & referrer parametresinin içinde kalsın; en fazla 512 karakter olsun.
- utm_source=google-play&utm_medium=organic, yüklemenin sizin linkinizden gelmediği anlamına gelir.
Kısa cevap
Google Play referrer’ı yalnızca Play Store uygulaması üzerinden gelen yüklemelerde iletir. Android Studio’dan ya da adb ile yüklenen bir debug build’in arkasında Play’den bir yükleme yoktur; dolayısıyla okunacak kampanyaya özel bir değer de yoktur.
Gerçekten test etmek için build’i dahili test kanalında yayınlayın, uygulamayı test telefonundan kaldırın, referrer’ı kodlanmış bir Play URL’sini o telefonda açın, açılan Play sayfasından yükleyin ve değeri ilk açılışta okuyun. Kanal bir kez kurulduktan sonra bu döngünün tamamı yaklaşık on dakika sürer.
Test için kullanacağınız Play URL’si
Fazladan tek bir parametresi olan normal bir mağaza linki.
https://play.google.com/store/apps/details?id=com.example.myshop&referrer=utm_source%3Dqa_test%26utm_campaign%3Dreferrer_check
https://play.google.com/store/apps/details
Mağaza sayfası
Bir uygulamanın standart Google Play adresi.
?id=com.example.myshop
Paket adı
Uygulamanızın application ID’si, Play Console’daki haliyle birebir.
&referrer=
Referrer parametresi
Ondan sonra gelen her şey yüklemeden sonra uygulamanıza iletilir.
utm_source%3Dqa_test%26utm_campaign%3Dreferrer_check
Kodlanmış değer
utm_source=qa_test&utm_campaign=referrer_check; içindeki = ve & referrer’ın içinde kalsın diye URL-encode edilmiş hali. Google en fazla 512 karakter istiyor.
Baştan sona test edin
Kütüphaneyi ve okuma kodunu ekleyin
com.android.installreferrer:installreferrer:2.2 bağımlılığını ekleyin ve aşağıdaki kodda olduğu gibi okumayı ilk açılışta çağırın. Değeri logcat’te görebilmek için loglayın.
Dahili test kanalında yayınlayın
Build’i Play Console’da dahili test kanalına yükleyin ve Google hesabınızı test kullanıcısı olarak ekleyin. Dahili testler en fazla 100 test kullanıcısı alır ve yeni build’ler onlara dakikalar içinde ulaşır; ilk yayın birkaç saat sürebilir.
Telefonda teste katılın
Test kullanıcıları sekmesindeki katılım linkini, test telefonundaki Play Store uygulamasında oturum açmış olan Google hesabıyla açın.
Uygulamayı kaldırın
Referrer bir yüklemeye sabitlenir ve uygulama yeniden yüklenene kadar değişmez. Android Studio’nun yüklediği dahil, önceki her kopyayı kaldırın.
Play URL’sini telefonda açın
Chrome’da, bir sohbette ya da bir QR koddan dokunarak açın ki o telefonda Play Store uygulaması açılsın. Masaüstü tarayıcıda play.google.com üzerinden yüklemek başka bir yoldur; kullanıcılarınızın izlediği yolu test edin.
Yükleyin ve uygulamayı açın
Açılan Play sayfasından yükleyin, sonra uygulamayı bir kez başlatın. adb logcat’te referrer’ı ve iki zaman damgasını izleyin.
Gönderdiğinizle karşılaştırın
utm_source=qa_test&utm_campaign=referrer_check değerini, bir tıklama zamanını ve bir yükleme başlangıç zamanını görmelisiniz. Tekrar test etmek için uygulamayı kaldırın ve Play URL’sinden yeniden başlayın.
İlk açılışta okuyun
Google’ın örneğine dayanan Kotlin kodu. Referrer’ı bir kez okur, loglar ve istemciyi kapatır.
build.gradle.kts
dependencies {
implementation("com.android.installreferrer:installreferrer:2.2")
}InstallReferrer.kt
import android.content.Context
import android.util.Log
import com.android.installreferrer.api.InstallReferrerClient
import com.android.installreferrer.api.InstallReferrerClient.InstallReferrerResponse
import com.android.installreferrer.api.InstallReferrerStateListener
fun readInstallReferrerOnce(context: Context) {
val prefs = context.getSharedPreferences("install_referrer", Context.MODE_PRIVATE)
if (prefs.getBoolean("read", false)) return
val client = InstallReferrerClient.newBuilder(context).build()
client.startConnection(object : InstallReferrerStateListener {
override fun onInstallReferrerSetupFinished(responseCode: Int) {
when (responseCode) {
InstallReferrerResponse.OK -> {
val details = client.installReferrer
Log.d("InstallReferrer", "referrer=${details.installReferrer}")
Log.d("InstallReferrer", "clickTime=${details.referrerClickTimestampSeconds}")
Log.d("InstallReferrer", "installBegin=${details.installBeginTimestampSeconds}")
prefs.edit().putBoolean("read", true).apply()
}
InstallReferrerResponse.FEATURE_NOT_SUPPORTED ->
Log.d("InstallReferrer", "Play Store app doesn't support the API")
InstallReferrerResponse.SERVICE_UNAVAILABLE ->
Log.d("InstallReferrer", "Play Store service unavailable, try again later")
}
client.endConnection()
}
override fun onInstallReferrerServiceDisconnected() {}
})
}Sonucu izleyin
Terminal
adb logcat -s InstallReferrerBoş ya da tuhaf sonuçlar ve anlamları
Appy nerede devreye girer
Appy linkleri Google Play’e referrer’ı link adıyla birlikte kendiliğinden ekler; test, kendi linkinize bir dokunuştan ibaret olur. Enterprise’da Appy SDK referrer’ı ilk açılışta okur ve yüklemeyi doğrulanmış yükleme olarak o linke yazar. Appy kullanmadan hazırlanan tek seferlik kampanya URL’leri için App Store kampanya linki oluşturucu referrer’ı sizin yerinize kodlar.
Araçlar ve rehberler
- App Store ve Google Play kampanya linki oluşturucuApp Store linklerine kampanya token’ları, Google Play linklerine kodlanmış bir referrer ekler.
- Install Referrer nedir?Kısa tanım ve size neyi söyleyip neyi söyleyemeyeceği.
- Uygulama kampanyaları için UTM parametreleriUTM’ler Android’de mağazadan nasıl sağ çıkar, iPhone’da neden çıkamaz.
- Appy Android SDKReferrer’ı ilk açılışta okur ve yüklemeyi linke yazar.
Kaynaklar (13 Kasım 2026’da okundu)
- Android Developers · Play Install Referrer Librarydeveloper.android.com/google/play/installreferrer/library
- Android Developers · ReferrerDetails referencedeveloper.android.com/reference/com/android/installreferrer/api/ReferrerDetails
- Play Console Help · Set up an open, closed or internal testsupport.google.com/googleplay/android-developer/answer/9845334
- Android Developers · Referrer format for Google Play URLs (Play Games on PC)developer.android.com/games/playgames/user-acquisition
Sık sorulan sorular
Install referrer uygulamayı yayınlamadan test edilebilir mi?
Gerçek bir referrer ile hayır. Google Play referrer’ı yalnızca Play Store’dan gelen yüklemelerde iletir; bu yüzden build’in bir kanalda olması gerekir. En hızlısı dahili test kanalı: en fazla 100 test kullanıcısı ve dakikalar içinde erişilen yeni build’ler.
Install referrer neden boş geliyor?
Çoğu zaman uygulama Android Studio’dan ya da adb ile yüklenmiştir veya Play URL’sini açtığınızda zaten yüklüdür. Uygulamayı kaldırın, Play URL’sini telefonda açın ve Play sayfasından yükleyin.
Install referrer ne kadar süre alınabilir?
Google onu 90 gün saklar ve uygulama yeniden yüklenmedikçe değişmez. İlk açılışta bir kez okuyun ve ihtiyacınız olanı saklayın.
Referrer değeri URL-encode edilmeli mi?
Evet. Değerin tamamını kodlayın ki içindeki = ve & referrer parametresinin içinde kalsın. Google’ın yönergeleri ayrıca değeri 512 karakterle sınırlıyor.
Eski INSTALL_REFERRER broadcast’i hâlâ test için kullanılabilir mi?
Hayır. Değeri Play Store uygulamasından okuyan Play Install Referrer Library’yi kullanın. Eski broadcast’i adb ile göndermeye dayanan testler gerçek bir yüklemede olanı yansıtmaz.
Diğer yazılar
Cihaz Parmak İzi Olmadan Uygulama Yüklemelerini Ölçmek
Apple, kullanıcı takibe izin verse bile cihaz parmak izine izin vermiyor; AB’de veri koruma kurulları IP’ye dayalı takibi cihaza erişim sayıyor. iPhone’da ve Android’de yüklemeleri hâlâ kanıtla ölçen yöntemler ve hiç tahmin yürütmeyen bir ölçüm planı.
Android’de Meta Install Referrer’ın Şifresi Nasıl Çözülür
Facebook ve Instagram yüklemelerinde kampanya, reklam seti ve reklam bilgisini okumak ve şifresini çözmek.
SDK Olmadan Deferred Deep Linking Nasıl Çalışır?
Link bağlamını, uygulamanıza bir attribution SDK’sı gömmeden kurulum sınırından geçirebilirsiniz. Android ve iOS’ta mağaza sınırını gerçekte neyin aştığını, neyin kırıldığını ve her geçici çözümün gizlilik maliyetini anlatıyoruz.
Başka konular için blogda gezin.
Referrer’ı link taşısın
Appy linkleri Android telefonları referrer’ı eklenmiş halde Google Play’e, iPhone’ları App Store’a gönderir. Ücretsiz plan, kredi kartı gerekmez.