Как проверить Google Play Install Referrer на реальном устройстве
У сборки из Android Studio install referrer нет, поэтому большинство тестов читают пустое значение и на этом заканчиваются. Как получить настоящий: закодированный URL Play, трек внутреннего тестирования, чистая установка и чтение на Kotlin при первом запуске. И что значит каждый пустой или странный результат.
Ссылки, которые сами передают referrer в Google Play
- Одна ссылка для Google Play, App Store и вашего сайта
- Кампания и название ссылки сохраняются после установки
- Бесплатный тариф, без банковской карты
Короткий ответ
Как проверить 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
https://play.google.com/store/apps/details
Страница в сторе
Стандартный адрес приложения в Google Play.
?id=com.example.myshop
Пакет
Ваш application ID, точно как в Play Console.
&referrer=
Параметр referrer
Всё, что идёт после него, передаётся вашему приложению после установки.
utm_source%3Dqa_test%26utm_campaign%3Dreferrer_check
Закодированное значение
utm_source=qa_test&utm_campaign=referrer_check в URL-кодировке, чтобы = и & остались внутри referrer. Google просит укладываться в 512 символов.
Проверка от начала до конца
Добавьте библиотеку и чтение
Подключите com.android.installreferrer:installreferrer:2.2 и вызывайте чтение при первом запуске, как в коде ниже. Пишите значение в лог, чтобы видеть его в logcat.
Опубликуйте во внутреннее тестирование
Загрузите сборку в трек внутреннего тестирования в Play Console и добавьте свой аккаунт Google в тестировщики. Во внутреннем тестировании может быть до 100 тестировщиков, и новые сборки доходят до них за считаные минуты. Самая первая публикация может занять несколько часов.
Присоединитесь к тесту на телефоне
Откройте ссылку для участия со вкладки «Тестировщики» под тем же аккаунтом Google, с которым выполнен вход в Play Store на тестовом телефоне.
Удалите приложение
Referrer закрепляется за установкой и не меняется, пока приложение не переустановят. Удалите все прежние копии, включая ту, что поставил Android Studio.
Откройте URL Play на телефоне
Нажмите на него в Chrome, в мессенджере или отсканируйте QR-код, чтобы он открыл приложение Play Store на этом телефоне. Установка с play.google.com в браузере на компьютере идёт другим путём. Проверяйте тот, которым идут ваши пользователи.
Установите и откройте приложение
Установите приложение с открывшейся страницы Play и запустите его один раз. Следите в adb logcat за referrer и двумя временными метками.
Сравните с тем, что отправили
Вы должны увидеть 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() {}
})
}Смотрите результат
Терминал
adb logcat -s InstallReferrerПустой или странный результат: что он значит
Чем здесь поможет Appy
Ссылки Appy сами добавляют referrer для Google Play вместе с названием ссылки, так что для теста достаточно нажать на свою ссылку. На Enterprise SDK Appy читает referrer при первом запуске и засчитывает установку этой ссылке как подтверждённую. Для разовых URL кампаний без Appy referrer закодирует генератор ссылок на кампанию App Store.
Инструменты и гайды
- Генератор ссылок на кампанию App Store и Google PlayДобавляет токены кампании в ссылки App Store и закодированный referrer в ссылки Google Play.
- Что такое install referrer?Короткое определение: что он может сказать и чего не может.
- UTM-метки для кампаний приложенийКак UTM-метки проходят через стор на Android и почему теряются на iPhone.
- Android SDK AppyЧитает referrer при первом запуске и засчитывает установку ссылке.
Источники, проверены 13 ноября 2026 года
- 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
Частые вопросы
Можно ли проверить 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, не показывают, что происходит при настоящей установке.
Продолжить изучение
Как измерять установки приложения без фингерпринтинга
Apple не допускает фингерпринтинг, даже если пользователь согласился на отслеживание, а европейские регуляторы считают отслеживание по IP-адресу доступом к устройству. Разбираем, что по-прежнему измеряет установки с доказательством на iPhone и Android, и собираем план, который никогда не гадает.
Как расшифровать Meta Install Referrer на Android
Facebook и Instagram сообщают приложению кампанию, группу объявлений и объявление за установкой, а расшифровать данные можно только вашим ключом.
Deferred deep linking без SDK: как это работает
Контекст ссылки можно пронести через установку приложения, не встраивая SDK атрибуции. Разбираем, что реально переживает границу стора на Android и iOS, что ломается и во что каждый обходной путь обходится приватности.
Ищете другое? Посмотрите все темы в блоге.
Пусть referrer передаёт ссылка
Ссылки Appy отправляют Android в Google Play с уже добавленным referrer, а iPhone в App Store. Бесплатный тариф, без банковской карты.