Appy
← Bloga dön
Rehber

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.

Appy•13 Kasım 2026•7 dk okuma

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
Ücretsiz linkimi oluştur
Şununla özetleChatGPTClaudePerplexity

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

  1. https://play.google.com/store/apps/details

    Mağaza sayfası

    Bir uygulamanın standart Google Play adresi.

  2. ?id=com.example.myshop

    Paket adı

    Uygulamanızın application ID’si, Play Console’daki haliyle birebir.

  3. &referrer=

    Referrer parametresi

    Ondan sonra gelen her şey yüklemeden sonra uygulamanıza iletilir.

  4. 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.

Loglarda tanıyacağınız bir değer kullanın. Eksiksiz gelirse hem kodlama hem iletim çalışıyor demektir.

Baştan sona test edin

01

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.

02

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.

03

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.

04

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.

05

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.

06

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.

07

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() {}
    })
}
Google referrer’ı 90 gün saklar ve uygulamalardan API’yi yalnızca bir kez, yüklemeden sonraki ilk çalıştırmada çağırmalarını ister.

Sonucu izleyin

Terminal

adb logcat -s InstallReferrer
Uygulamayı açmadan önce, test telefonu USB ile bağlıyken çalıştırın.

Boş ya da tuhaf sonuçlar ve anlamları

Android Studio’dan yüklemeden sonra hiç kampanya yok
Olası neden: Uygulama Google Play’den yüklenmedi
Ne yapmalı: Play URL’si üzerinden bir test kanalından yükleyin
utm_source=google-play&utm_medium=organic
Olası neden: Yükleme sizin linkinizden gelmedi; organik yüklemelerde olağan değer budur
Ne yapmalı: Uygulamayı kaldırın, sonra telefonda Play URL’sinden başlayın
Önceki bir testten kalma eski bir değer
Olası neden: Uygulama yeniden yüklenmedi, ilk referrer hâlâ geçerli
Ne yapmalı: Kaldırın ve yeni URL’den tekrar yükleyin
Yalnızca utm_source geliyor, gerisi yok
Olası neden: Referrer kodlanmadı, & onu erken bitirdi
Ne yapmalı: Değeri kodlayın: = yerine %3D, & yerine %26
SERVICE_UNAVAILABLE ya da FEATURE_NOT_SUPPORTED
Olası neden: Play Store uygulaması güncelleniyor, yok ya da çok eski
Ne yapmalı: Play Store’u güncelleyin ve bir sonraki açılışta tekrar deneyin
Google Play olmayan bir Huawei telefonda hiçbir şey yok
Olası neden: Play Store yok, dolayısıyla Play referrer’ı da yok
Ne yapmalı: AppGallery’nin kendi mağazasından gelen yüklemeler için ayrı bir referrer’ı var
Organik değer, Google’ın 2016’da duyurduğu ve çoğu SDK’nın hâlâ raporladığı değerdir; bunu bir hata olarak değil, “kampanya yok” olarak okuyun.

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

Kaynaklar (13 Kasım 2026’da okundu)

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

Rehber
Oct 21, 2026
8 dk okuma

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ı.

attribution
fingerprinting
privacy
install attribution
Yazıyı oku
Rehber
Oct 15, 2026
4 dk okuma

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.

meta install referrer
facebook ads
instagram ads
android
Yazıyı oku
Rehber
Aug 14, 2026
11 dk okuma

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.

deferred deep linking
install referrer
ios
android
Yazıyı oku

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.