---
title: "Как проверить Google Play Install Referrer | Appy"
description: "Проверка install referrer на реальном телефоне: внутреннее тестирование, закодированный URL Play, чтение на Kotlin и что значит пустой результат."
source: "https://appy.to/ru/blog/test-google-play-install-referrer"
---

[← Назад в блог](https://appy.to/ru/blog)

Гайд

# Как проверить Google Play Install Referrer на реальном устройстве

У сборки из Android Studio install referrer нет, поэтому большинство тестов читают пустое значение и на этом заканчиваются. Как получить настоящий: закодированный URL Play, трек внутреннего тестирования, чистая установка и чтение на Kotlin при первом запуске. И что значит каждый пустой или странный результат.

Appy•13 ноября 2026•7 минут

Ссылки, которые сами передают referrer в Google Play

-   Одна ссылка для Google Play, App Store и вашего сайта
-   Кампания и название ссылки сохраняются после установки
-   Бесплатный тариф, без банковской карты

[Создать бесплатную ссылку](https://appy.to/ru/account/register)

Краткий пересказ в[ChatGPT](https://chatgpt.com/?q=%D0%9A%D1%80%D0%B0%D1%82%D0%BA%D0%BE%20%D0%BF%D0%B5%D1%80%D0%B5%D1%81%D0%BA%D0%B0%D0%B6%D0%B8%20%D1%8D%D1%82%D1%83%20%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%83%20%D0%B8%20%D0%BF%D0%B5%D1%80%D0%B5%D1%87%D0%B8%D1%81%D0%BB%D0%B8%20%D0%B3%D0%BB%D0%B0%D0%B2%D0%BD%D1%8B%D0%B5%20%D1%82%D0%B5%D0%B7%D0%B8%D1%81%D1%8B%3A%20https%3A%2F%2Fappy.to%2Fru%2Fblog%2Ftest-google-play-install-referrer) [Claude](https://claude.ai/new?q=%D0%9A%D1%80%D0%B0%D1%82%D0%BA%D0%BE%20%D0%BF%D0%B5%D1%80%D0%B5%D1%81%D0%BA%D0%B0%D0%B6%D0%B8%20%D1%8D%D1%82%D1%83%20%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%83%20%D0%B8%20%D0%BF%D0%B5%D1%80%D0%B5%D1%87%D0%B8%D1%81%D0%BB%D0%B8%20%D0%B3%D0%BB%D0%B0%D0%B2%D0%BD%D1%8B%D0%B5%20%D1%82%D0%B5%D0%B7%D0%B8%D1%81%D1%8B%3A%20https%3A%2F%2Fappy.to%2Fru%2Fblog%2Ftest-google-play-install-referrer) [Perplexity](https://www.perplexity.ai/search?q=%D0%9A%D1%80%D0%B0%D1%82%D0%BA%D0%BE%20%D0%BF%D0%B5%D1%80%D0%B5%D1%81%D0%BA%D0%B0%D0%B6%D0%B8%20%D1%8D%D1%82%D1%83%20%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%83%20%D0%B8%20%D0%BF%D0%B5%D1%80%D0%B5%D1%87%D0%B8%D1%81%D0%BB%D0%B8%20%D0%B3%D0%BB%D0%B0%D0%B2%D0%BD%D1%8B%D0%B5%20%D1%82%D0%B5%D0%B7%D0%B8%D1%81%D1%8B%3A%20https%3A%2F%2Fappy.to%2Fru%2Fblog%2Ftest-google-play-install-referrer)

Короткий ответ

## Как проверить Google Play Install Referrer на реальном устройстве?

Опубликуйте сборку в трек внутреннего тестирования, удалите приложение с тестового телефона, откройте на нём URL Play с referrer в URL-кодировке, установите приложение со страницы Play и прочитайте значение через Play Install Referrer Library при первом запуске. У сборки, установленной из Android Studio или через adb, referrer кампании не бывает.

Главное

-   Referrer закрепляется за установкой и хранится 90 дней; чтобы проверить ещё раз, удалите приложение и установите его заново по URL Play.
-   Кодируйте значение, чтобы = и & остались внутри параметра referrer, и укладывайтесь в 512 символов.
-   utm\_source=google-play&utm\_medium=organic значит, что установка пришла не по вашей ссылке.

## Короткий ответ

Google Play передаёт referrer только для установок через приложение Play Store. За debug-сборкой, установленной из Android Studio или через adb, нет установки из Play, поэтому данных о кампании там просто нет.

Чтобы проверить по-настоящему, опубликуйте сборку в трек внутреннего тестирования, удалите приложение с тестового телефона, откройте на нём URL Play с закодированным referrer, установите приложение с открывшейся страницы Play и прочитайте значение при первом запуске. Когда трек настроен, весь цикл занимает около десяти минут.

## URL Play для теста

Обычная ссылка на стор с одним дополнительным параметром.

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

Страница в сторе

Стандартный адрес приложения в Google Play.

2.  ?id=com.example.myshop

Пакет

Ваш application ID, точно как в Play Console.

3.  &referrer=

Параметр referrer

Всё, что идёт после него, передаётся вашему приложению после установки.

4.  utm\_source%3Dqa\_test%26utm\_campaign%3Dreferrer\_check

Закодированное значение

utm\_source=qa\_test&utm\_campaign=referrer\_check в URL-кодировке, чтобы = и & остались внутри referrer. Google просит укладываться в 512 символов.


Возьмите значение, которое легко узнать в логах. Если оно пришло целиком, работают и кодирование, и доставка.

## Проверка от начала до конца

01

### Добавьте библиотеку и чтение

Подключите com.android.installreferrer:installreferrer:2.2 и вызывайте чтение при первом запуске, как в коде ниже. Пишите значение в лог, чтобы видеть его в logcat.

02

### Опубликуйте во внутреннее тестирование

Загрузите сборку в трек внутреннего тестирования в Play Console и добавьте свой аккаунт Google в тестировщики. Во внутреннем тестировании может быть до 100 тестировщиков, и новые сборки доходят до них за считаные минуты. Самая первая публикация может занять несколько часов.

03

### Присоединитесь к тесту на телефоне

Откройте ссылку для участия со вкладки «Тестировщики» под тем же аккаунтом Google, с которым выполнен вход в Play Store на тестовом телефоне.

04

### Удалите приложение

Referrer закрепляется за установкой и не меняется, пока приложение не переустановят. Удалите все прежние копии, включая ту, что поставил Android Studio.

05

### Откройте URL Play на телефоне

Нажмите на него в Chrome, в мессенджере или отсканируйте QR-код, чтобы он открыл приложение Play Store на этом телефоне. Установка с play.google.com в браузере на компьютере идёт другим путём. Проверяйте тот, которым идут ваши пользователи.

06

### Установите и откройте приложение

Установите приложение с открывшейся страницы Play и запустите его один раз. Следите в adb logcat за referrer и двумя временными метками.

07

### Сравните с тем, что отправили

Вы должны увидеть utm\_source=qa\_test&utm\_campaign=referrer\_check, время клика и время начала установки. Чтобы проверить ещё раз, удалите приложение и начните с URL Play.

## Чтение при первом запуске

Kotlin, на основе примера Google. Код читает referrer один раз, пишет его в лог и закрывает соединение.

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 дней и просит вызывать API только один раз, при первом запуске после установки.

## Смотрите результат

Терминал

```
adb logcat -s InstallReferrer
```

Запустите команду до того, как откроете приложение. Тестовый телефон должен быть подключён по USB.

## Пустой или странный результат: что он значит

Что вы видите

Вероятная причина

Что делать

Никакой кампании после установки из Android Studio

Вероятная причина: Приложение установлено не из Google Play

Что делать: Установите из тестового трека по URL Play

utm\_source=google-play&utm\_medium=organic

Вероятная причина: Установка пришла не по вашей ссылке; это обычное значение для органических установок

Что делать: Удалите приложение и начните с URL Play на телефоне

Старое значение из прошлого теста

Вероятная причина: Приложение не переустанавливали, поэтому действует первый referrer

Что делать: Удалите и установите заново по новому URL

Приходит только utm\_source, остального нет

Вероятная причина: Referrer не закодировали, и & его оборвал

Что делать: Закодируйте значение: = превращается в %3D, & в %26

SERVICE\_UNAVAILABLE или FEATURE\_NOT\_SUPPORTED

Вероятная причина: Play Store обновляется, отсутствует или слишком старый

Что делать: Обновите Play Store и попробуйте снова при следующем запуске

Пусто на телефоне Huawei без Google Play

Вероятная причина: Нет Play Store, значит, нет и referrer от Play

Что делать: У AppGallery есть свой referrer для установок из AppGallery

Органическое значение Google объявил в 2016 году, и большинство SDK до сих пор его передают. Считайте его признаком «нет кампании», а не ошибкой.

## Чем здесь поможет Appy

Ссылки Appy сами добавляют referrer для Google Play вместе с названием ссылки, так что для теста достаточно нажать на свою ссылку. На Enterprise SDK Appy читает referrer при первом запуске и засчитывает установку этой ссылке как подтверждённую. Для разовых URL кампаний без Appy referrer закодирует генератор ссылок на кампанию App Store.

## Инструменты и гайды

-   [Генератор ссылок на кампанию App Store и Google PlayДобавляет токены кампании в ссылки App Store и закодированный referrer в ссылки Google Play.](https://appy.to/ru/tools/app-store-campaign-link)
-   [Что такое install referrer?Короткое определение: что он может сказать и чего не может.](https://appy.to/ru/glossary/install-referrer)
-   [UTM-метки для кампаний приложенийКак UTM-метки проходят через стор на Android и почему теряются на iPhone.](https://appy.to/ru/blog/utm-parameters-for-app-campaigns)
-   [Android SDK AppyЧитает referrer при первом запуске и засчитывает установку ссылке.](https://appy.to/docs/sdk/android)

## Источники, проверены 13 ноября 2026 года

-   [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)

## Частые вопросы

### Можно ли проверить install referrer, не публикуя приложение?

Настоящий referrer нельзя. Google Play передаёт его только для установок из Play Store, поэтому сборка должна быть в треке. Быстрее всего через внутреннее тестирование: до 100 тестировщиков, и новые сборки доступны за считаные минуты.

### Почему install referrer пустой?

Чаще всего приложение установили из Android Studio или через adb, или оно уже стояло на телефоне, когда вы открыли URL Play. Удалите его, откройте URL Play на телефоне и установите со страницы Play.

### Сколько хранится install referrer?

Google хранит его 90 дней, и он не меняется, пока приложение не переустановят. Прочитайте его один раз, при первом запуске, и сохраните то, что нужно.

### Нужно ли кодировать значение referrer?

Да. Закодируйте всё значение, чтобы = и & остались внутри параметра referrer. Кроме того, по рекомендациям Google оно должно быть не длиннее 512 символов.

### Можно ли ещё тестировать через старый broadcast INSTALL\_REFERRER?

Нет. Используйте Play Install Referrer Library: она читает значение из приложения Play Store. Тесты, где старый broadcast отправляют через adb, не показывают, что происходит при настоящей установке.

## Продолжить изучение

Гайд

21 окт. 2026 г.

8 мин чтения

### Как измерять установки приложения без фингерпринтинга

Apple не допускает фингерпринтинг, даже если пользователь согласился на отслеживание, а европейские регуляторы считают отслеживание по IP-адресу доступом к устройству. Разбираем, что по-прежнему измеряет установки с доказательством на iPhone и Android, и собираем план, который никогда не гадает.

attribution

fingerprinting

privacy

install attribution

[Читать статью](https://appy.to/ru/blog/measure-app-installs-without-fingerprinting)

Гайд

15 окт. 2026 г.

4 мин чтения

### Как расшифровать Meta Install Referrer на Android

Facebook и Instagram сообщают приложению кампанию, группу объявлений и объявление за установкой, а расшифровать данные можно только вашим ключом.

meta install referrer

facebook ads

instagram ads

android

[Читать статью](https://appy.to/ru/blog/meta-install-referrer-decryption)

Гайд

14 авг. 2026 г.

11 мин чтения

### Deferred deep linking без SDK: как это работает

Контекст ссылки можно пронести через установку приложения, не встраивая SDK атрибуции. Разбираем, что реально переживает границу стора на Android и iOS, что ломается и во что каждый обходной путь обходится приватности.

deferred deep linking

install referrer

ios

android

[Читать статью](https://appy.to/ru/blog/deferred-deep-linking-without-sdk)

Ищете другое? Посмотрите все темы в [блоге](https://appy.to/ru/blog).

## Пусть referrer передаёт ссылка

Ссылки Appy отправляют Android в Google Play с уже добавленным referrer, а iPhone в App Store. Бесплатный тариф, без банковской карты.

[Создать бесплатную ссылку](https://appy.to/ru/account/register)
