Cómo probar el install referrer de Google Play en un dispositivo real
Una build instalada desde Android Studio nunca trae install referrer, así que la mayoría de las pruebas leen un valor vacío y se quedan ahí. Cómo conseguir uno real: una URL de Play codificada, un canal de pruebas internas, una instalación limpia y una lectura en Kotlin en el primer arranque, y qué significa cada resultado vacío o raro.
Enlaces que llevan el referrer a Google Play por sí solos
- Un solo enlace para Google Play, la App Store y tu web
- La campaña y el nombre del enlace se conservan tras la instalación
- Plan gratis, sin tarjeta
Respuesta corta
¿Cómo se prueba el install referrer de Google Play en un dispositivo real?
Publica la build en un canal de pruebas internas, desinstala la app de un teléfono de prueba, abre en ese teléfono una URL de Play con el referrer codificado, instala desde la página de Play y lee el valor con la Play Install Referrer Library en el primer arranque. Una build instalada desde Android Studio o con adb nunca trae un referrer de campaña.
Puntos clave
- El referrer queda fijado para cada instalación y se guarda 90 días; para repetir la prueba, desinstala y reinstala desde la URL de Play.
- Codifica el valor para que = y & se queden dentro del parámetro referrer, y no pases de 512 caracteres.
- utm_source=google-play&utm_medium=organic significa que la instalación no vino de tu enlace.
La respuesta corta
Google Play solo entrega un referrer en las instalaciones que pasan por la app de Play Store. Una build de depuración instalada desde Android Studio o con adb no tiene detrás ninguna instalación desde Play, así que no hay nada de la campaña que leer.
Para probarlo de verdad, publica una build en un canal de pruebas internas, desinstala la app de un teléfono de prueba, abre en ese teléfono una URL de Play con el referrer codificado, instala desde la página de Play que se abre y lee el valor en el primer arranque. Con el canal ya configurado, la vuelta completa lleva unos diez minutos.
La URL de Play con la que se prueba
Un enlace normal a la tienda con un parámetro más.
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
Página de la tienda
La dirección estándar de Google Play para una app.
?id=com.example.myshop
Package
Tu application ID, exactamente como aparece en Play Console.
&referrer=
Parámetro referrer
Todo lo que va detrás se le entrega a tu app después de la instalación.
utm_source%3Dqa_test%26utm_campaign%3Dreferrer_check
Valor codificado
utm_source=qa_test&utm_campaign=referrer_check, codificado para URL para que sus = y & se queden dentro del referrer. Google pide 512 caracteres como máximo.
Pruébalo de principio a fin
Añade la biblioteca y la lectura
Añade com.android.installreferrer:installreferrer:2.2 y haz la lectura en el primer arranque, como en el código de abajo. Escribe el valor en el log para verlo con logcat.
Publica en pruebas internas
Sube la build al canal de pruebas internas en Play Console y añade tu cuenta de Google como tester. Las pruebas internas admiten hasta 100 testers y las builds nuevas les llegan en minutos; la primera publicación puede tardar unas horas.
Únete a la prueba en el teléfono
Abre el enlace de participación de la pestaña Testers con la misma cuenta de Google con la que está iniciada la app de Play Store en el teléfono de prueba.
Desinstala la app
El referrer queda fijado para cada instalación y no cambia hasta que se reinstala la app. Borra cualquier copia anterior, incluida la que puso Android Studio.
Abre la URL de Play en el teléfono
Tócala en Chrome, en un chat o desde un código QR, para que abra la app de Play Store en ese teléfono. Instalar desde play.google.com en un navegador de ordenador es otro camino; prueba el que siguen tus usuarios.
Instala y abre la app
Instala desde la página de Play que se abrió y abre la app una vez. Mira en adb logcat el referrer y las dos marcas de tiempo.
Compáralo con lo que enviaste
Deberías ver utm_source=qa_test&utm_campaign=referrer_check, una hora de clic y una hora de inicio de la instalación. Para repetir la prueba, desinstala y empieza otra vez desde la URL de Play.
Léelo en el primer arranque
Kotlin, basado en el ejemplo de Google. Lee el referrer una vez, lo escribe en el log y cierra la conexión.
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() {}
})
}Mira el resultado
Terminal
adb logcat -s InstallReferrerResultados vacíos o raros, y qué significan
Dónde encaja Appy
Los enlaces de Appy añaden por sí solos un referrer a Google Play, con el nombre del enlace, así que una prueba es solo tocar tu propio enlace. En Enterprise, el SDK de Appy lee el referrer en el primer arranque y atribuye la instalación a ese enlace como instalación verificada. Para URL de campaña sueltas sin Appy, el generador de enlaces de campaña de App Store codifica el referrer por ti.
Herramientas y guías
- Generador de enlaces de campaña de App Store y Google PlayAñade tokens de campaña a los enlaces de App Store y un referrer codificado a los de Google Play.
- ¿Qué es el install referrer?La definición corta, y lo que puede y no puede decirte.
- Parámetros UTM para campañas de appsCómo sobreviven los UTM a la tienda en Android, y por qué no en iPhone.
- SDK de Appy para AndroidLee el referrer en el primer arranque y atribuye la instalación al enlace.
Fuentes, consultadas el 13 de noviembre de 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
Preguntas frecuentes
¿Se puede probar el install referrer sin publicar la app?
No con un referrer real. Google Play solo lo pasa en las instalaciones que vienen de Play Store, así que la build tiene que estar en un canal. El de pruebas internas es el más rápido: hasta 100 testers, y las builds nuevas están disponibles en minutos.
¿Por qué el install referrer me llega vacío?
Lo más habitual es que la app se instalara desde Android Studio o con adb, o que ya estuviera instalada cuando abriste la URL de Play. Desinstálala, abre la URL de Play en el teléfono e instala desde la página de Play.
¿Cuánto tiempo está disponible el install referrer?
Google lo guarda durante 90 días, y no cambia salvo que se reinstale la app. Léelo una vez, en el primer arranque, y guarda lo que necesites.
¿Hay que codificar el valor del referrer?
Sí. Codifica el valor entero para que sus = y & se queden dentro del parámetro referrer. Las indicaciones de Google también lo limitan a 512 caracteres.
¿Sigue sirviendo el antiguo broadcast INSTALL_REFERRER para probar?
No. Usa la Play Install Referrer Library, que lee el valor de la app de Play Store. Las pruebas que envían el broadcast antiguo con adb no reflejan lo que pasa en una instalación real.
Seguir explorando
Cómo medir instalaciones de apps sin fingerprinting
Apple no permite el fingerprinting ni siquiera cuando el usuario acepta el rastreo, y los reguladores europeos consideran que el rastreo por IP es un acceso al dispositivo. Aquí tienes lo que sigue midiendo instalaciones con pruebas en iPhone y Android, y un plan de medición que nunca tiene que adivinar.
Cómo descifrar el Meta Install Referrer en Android
Lee y descifra la campaña, el conjunto de anuncios y el anuncio de Facebook e Instagram detrás de cada instalación en Android.
Deferred deep linking sin SDK: cómo funciona
Puedes llevar el contexto de un enlace a través de una instalación sin incrustar un SDK de atribución. Esto es lo que sobrevive a la frontera de la tienda en Android e iOS, lo que se rompe y el coste en privacidad de cada alternativa.
¿Buscas otra cosa? Explora todos los temas en el blog.
Deja que el enlace lleve el referrer
Los enlaces de Appy mandan los Android a Google Play con el referrer ya puesto, y los iPhone a la App Store. Plan gratis, sin tarjeta.