Appy
← Volver al blog
Guía

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.

Appy•13 de noviembre de 2026•7 min de lectura

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
Crear mi enlace gratis

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

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

    Página de la tienda

    La dirección estándar de Google Play para una app.

  2. ?id=com.example.myshop

    Package

    Tu application ID, exactamente como aparece en Play Console.

  3. &referrer=

    Parámetro referrer

    Todo lo que va detrás se le entrega a tu app después de la instalación.

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

Usa un valor que vayas a reconocer en los logs. Si llega entero, la codificación y la entrega funcionan.

Pruébalo de principio a fin

01

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.

02

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.

03

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

04

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.

05

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.

06

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.

07

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() {}
    })
}
Google guarda el referrer durante 90 días y pide a las apps que llamen a la API una sola vez, en el primer arranque después de la instalación.

Mira el resultado

Terminal

adb logcat -s InstallReferrer
Ejecútalo con el teléfono de prueba conectado por USB antes de abrir la app.

Resultados vacíos o raros, y qué significan

Ninguna campaña después de instalar desde Android Studio
Causa probable: La app no se instaló desde Google Play
Qué hacer: Instala desde un canal de pruebas a través de la URL de Play
utm_source=google-play&utm_medium=organic
Causa probable: La instalación no vino de tu enlace; es el valor habitual de las instalaciones orgánicas
Qué hacer: Desinstala y empieza desde la URL de Play en el teléfono
Un valor viejo de una prueba anterior
Causa probable: La app no se reinstaló, así que sigue valiendo el primer referrer
Qué hacer: Desinstala e instala de nuevo desde la URL nueva
Solo llega utm_source, falta el resto
Causa probable: El referrer no iba codificado, así que el & lo cortó
Qué hacer: Codifica el valor: = pasa a %3D y & pasa a %26
SERVICE_UNAVAILABLE o FEATURE_NOT_SUPPORTED
Causa probable: La app de Play Store se está actualizando, no está o es demasiado antigua
Qué hacer: Actualiza Play Store y vuelve a intentarlo en el siguiente arranque
Nada en un teléfono Huawei sin Google Play
Causa probable: Sin Play Store no hay referrer de Play
Qué hacer: AppGallery tiene su propio referrer para las instalaciones desde su tienda
El valor orgánico es el que Google anunció en 2016 y el que siguen dando la mayoría de los SDK; tómalo como «sin campaña», no como un error.

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

Fuentes, consultadas el 13 de noviembre de 2026

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

Guía
Oct 21, 2026
8 min de lectura

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.

attribution
fingerprinting
privacy
install attribution
Leer artículo
Guía
Oct 15, 2026
4 min de lectura

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.

meta install referrer
facebook ads
instagram ads
android
Leer artículo
Guía
Aug 14, 2026
11 min de lectura

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.

deferred deep linking
install referrer
ios
android
Leer artículo

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