---
title: "Google Play Install Referrer Nasıl Test Edilir | Appy"
description: "Install referrer’ı gerçek cihazda test edin: dahili test kanalı, kodlanmış Play URL’si, temiz yükleme ve Kotlin ile okuma. Boş ya da tuhaf sonuçların anlamı."
source: "https://appy.to/tr/blog/test-google-play-install-referrer"
---

[← Bloga dön](https://appy.to/tr/blog)

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](https://appy.to/tr/account/register)

Şununla özetle[ChatGPT](https://chatgpt.com/?q=Bu%20sayfay%C4%B1%20%C3%B6zetle%20ve%20ana%20noktalar%C4%B1n%C4%B1%20listele%3A%20https%3A%2F%2Fappy.to%2Ftr%2Fblog%2Ftest-google-play-install-referrer) [Claude](https://claude.ai/new?q=Bu%20sayfay%C4%B1%20%C3%B6zetle%20ve%20ana%20noktalar%C4%B1n%C4%B1%20listele%3A%20https%3A%2F%2Fappy.to%2Ftr%2Fblog%2Ftest-google-play-install-referrer) [Perplexity](https://www.perplexity.ai/search?q=Bu%20sayfay%C4%B1%20%C3%B6zetle%20ve%20ana%20noktalar%C4%B1n%C4%B1%20listele%3A%20https%3A%2F%2Fappy.to%2Ftr%2Fblog%2Ftest-google-play-install-referrer)

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ı

Gördüğünüz

Olası neden

Ne yapmalı

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

-   [App Store ve Google Play kampanya linki oluşturucuApp Store linklerine kampanya token’ları, Google Play linklerine kodlanmış bir referrer ekler.](https://appy.to/tr/tools/app-store-campaign-link)
-   [Install Referrer nedir?Kısa tanım ve size neyi söyleyip neyi söyleyemeyeceği.](https://appy.to/tr/glossary/install-referrer)
-   [Uygulama kampanyaları için UTM parametreleriUTM’ler Android’de mağazadan nasıl sağ çıkar, iPhone’da neden çıkamaz.](https://appy.to/tr/blog/utm-parameters-for-app-campaigns)
-   [Appy Android SDKReferrer’ı ilk açılışta okur ve yüklemeyi linke yazar.](https://appy.to/docs/sdk/android)

## Kaynaklar (13 Kasım 2026’da okundu)

-   [Android Developers · Play Install Referrer Librarydeveloper.android.com/google/play/installreferrer/library](https://developer.android.com/google/play/installreferrer/library)
-   [Android Developers · ReferrerDetails referencedeveloper.android.com/reference/com/android/installreferrer/api/ReferrerDetails](https://developer.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](https://support.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](https://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

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](https://appy.to/tr/blog/measure-app-installs-without-fingerprinting)

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](https://appy.to/tr/blog/meta-install-referrer-decryption)

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](https://appy.to/tr/blog/deferred-deep-linking-without-sdk)

Başka konular için [blogda gezin](https://appy.to/tr/blog).

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

[Ücretsiz link oluştur](https://appy.to/tr/account/register)
