Appy
← Torna al blog
Guida

Come testare l’install referrer di Google Play su un dispositivo reale

Una build installata da Android Studio non ha mai un install referrer, quindi la maggior parte dei test legge un valore vuoto e si ferma lì. Come ottenerne uno vero: un URL di Play codificato, un canale di test interno, un’installazione da zero e una lettura in Kotlin al primo avvio, più cosa significa ogni risultato vuoto o strano.

Appy•13 novembre 2026•7 min di lettura

Link che portano da soli un referrer a Google Play

  • Un solo link per Google Play, App Store e il tuo sito
  • Campagna e nome del link conservati fino all’installazione
  • Piano gratuito, senza carta di credito
Crea il mio link gratis

Risposta breve

Come si testa l’install referrer di Google Play su un dispositivo reale?

Pubblica la build su un canale di test interno, disinstalla l’app da un telefono di prova, apri su quel telefono un URL di Play con un referrer codificato, installa dalla pagina di Play e leggi il valore con la Play Install Referrer Library al primo avvio. Una build installata da Android Studio o con adb non porta mai un referrer di campagna.

Punti chiave

  • Il referrer è fissato al momento dell’installazione e conservato per 90 giorni; per rifare il test, disinstalla e reinstalla dall’URL di Play.
  • Codifica il valore così = e & restano dentro il parametro referrer, e non superare i 512 caratteri.
  • utm_source=google-play&utm_medium=organic significa che l’installazione non è passata dal tuo link.

La risposta breve

Google Play passa un referrer solo per le installazioni che arrivano dall’app Play Store. Una build di debug installata da Android Studio o con adb non ha dietro nessuna installazione da Play, quindi non c’è nulla di legato a una campagna da leggere.

Per testarlo davvero, pubblica una build su un canale di test interno, disinstalla l’app da un telefono di prova, apri su quel telefono un URL di Play con un referrer codificato, installa dalla pagina di Play che si apre e leggi il valore al primo avvio. Una volta configurato il canale, il giro completo richiede una decina di minuti.

L’URL di Play con cui fai il test

Un normale link allo store con un parametro in più.

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

    Pagina dello store

    L’indirizzo standard di un’app su Google Play.

  2. ?id=com.example.myshop

    Package

    Il tuo application ID, esattamente come in Play Console.

  3. &referrer=

    Parametro referrer

    Tutto quello che segue viene passato alla tua app dopo l’installazione.

  4. utm_source%3Dqa_test%26utm_campaign%3Dreferrer_check

    Valore codificato

    utm_source=qa_test&utm_campaign=referrer_check, codificato come URL così i suoi = e & restano dentro il referrer. Google chiede al massimo 512 caratteri.

Usa un valore che riconosci nei log. Se arriva intatto, funzionano sia la codifica sia la consegna.

Il test dall’inizio alla fine

01

Aggiungi la libreria e la lettura

Aggiungi com.android.installreferrer:installreferrer:2.2 e chiama la lettura al primo avvio, come nel codice qui sotto. Scrivi il valore nel log così lo vedi con logcat.

02

Pubblica sul test interno

Carica la build sul canale di test interno in Play Console e aggiungi il tuo account Google tra i tester. I test interni accettano fino a 100 tester e le nuove build arrivano in pochi minuti; la primissima pubblicazione può richiedere qualche ora.

03

Iscriviti al test dal telefono

Apri il link di adesione dalla scheda Tester con lo stesso account Google collegato all’app Play Store sul telefono di prova.

04

Disinstalla l’app

Il referrer è fissato al momento dell’installazione e non cambia finché l’app non viene reinstallata. Togli ogni copia precedente, compresa quella messa lì da Android Studio.

05

Apri l’URL di Play sul telefono

Toccalo in Chrome, in una chat o da un QR code, così si apre l’app Play Store su quel telefono. Installare da play.google.com in un browser desktop è un percorso diverso; prova quello che fanno i tuoi utenti.

06

Installa e apri l’app

Installa dalla pagina di Play che si è aperta, poi avvia l’app una volta. Tieni d’occhio adb logcat per il referrer e i due timestamp.

07

Confronta con quello che hai inviato

Dovresti vedere utm_source=qa_test&utm_campaign=referrer_check, un orario del clic e un orario di inizio installazione. Per rifare il test, disinstalla e riparti dall’URL di Play.

Leggilo al primo avvio

Kotlin, basato sull’esempio di Google. Legge il referrer una volta, lo scrive nel log e chiude la connessione.

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 conserva il referrer per 90 giorni e chiede alle app di chiamare l’API una volta sola, al primo avvio dopo l’installazione.

Guarda il risultato

Terminale

adb logcat -s InstallReferrer
Lancialo con il telefono di prova collegato via USB, prima di aprire l’app.

Risultati vuoti o strani, e cosa significano

Nessuna campagna dopo un’installazione da Android Studio
Causa probabile: L’app non è stata installata da Google Play
Cosa fare: Installa da un canale di test passando dall’URL di Play
utm_source=google-play&utm_medium=organic
Causa probabile: L’installazione non è passata dal tuo link; è il valore tipico delle installazioni organiche
Cosa fare: Disinstalla e riparti dall’URL di Play sul telefono
Un vecchio valore di un test precedente
Causa probabile: L’app non è stata reinstallata, quindi vale ancora il primo referrer
Cosa fare: Disinstalla e installa di nuovo dal nuovo URL
Arriva solo utm_source, il resto manca
Causa probabile: Il referrer non era codificato, quindi & lo ha troncato
Cosa fare: Codifica il valore: = diventa %3D, & diventa %26
SERVICE_UNAVAILABLE o FEATURE_NOT_SUPPORTED
Causa probabile: L’app Play Store si sta aggiornando, manca o è troppo vecchia
Cosa fare: Aggiorna il Play Store e riprova al prossimo avvio
Niente su un telefono Huawei senza Google Play
Causa probabile: Niente Play Store, quindi niente referrer di Play
Cosa fare: AppGallery ha un suo referrer per le installazioni dal suo store
Il valore organico è quello annunciato da Google nel 2016 e che la maggior parte degli SDK riporta ancora; consideralo “nessuna campagna”, non un errore.

Dove entra in gioco Appy

I link Appy aggiungono da soli un referrer a Google Play, con il nome del link, quindi un test è solo un tocco sul tuo link. Con Enterprise l’SDK di Appy legge il referrer al primo avvio e attribuisce l’installazione a quel link come installazione verificata. Per URL di campagna occasionali senza Appy, il generatore di link di campagna App Store codifica il referrer al posto tuo.

Strumenti e guide

Fonti, consultate il 13 novembre 2026

Domande frequenti

Si può testare l’install referrer senza pubblicare l’app?

Non con un referrer vero. Google Play ne passa uno solo per le installazioni che arrivano dal Play Store, quindi la build deve stare su un canale. Il test interno è il più rapido: fino a 100 tester, e le nuove build sono disponibili in pochi minuti.

Perché l’install referrer è vuoto?

Quasi sempre l’app è stata installata da Android Studio o con adb, oppure era già installata quando hai aperto l’URL di Play. Disinstallala, apri l’URL di Play sul telefono e installa dalla pagina di Play.

Per quanto tempo è disponibile l’install referrer?

Google lo conserva per 90 giorni, e non cambia se l’app non viene reinstallata. Leggilo una volta, al primo avvio, e salva quello che ti serve.

Il valore del referrer va codificato come URL?

Sì. Codifica tutto il valore così i suoi = e & restano dentro il parametro referrer. Le indicazioni di Google lo limitano anche a 512 caratteri.

Il vecchio broadcast INSTALL_REFERRER serve ancora per i test?

No. Usa la Play Install Referrer Library, che legge il valore dall’app Play Store. I test basati sull’invio del vecchio broadcast con adb non riflettono quello che succede in un’installazione vera.

Continua a esplorare

Guida
Oct 21, 2026
8 min di lettura

Come misurare le installazioni di un’app senza fingerprinting

Apple non consente il fingerprinting nemmeno quando l’utente accetta il tracciamento, e le autorità europee per la protezione dei dati trattano il tracciamento basato sull’IP come un accesso al dispositivo. Ecco i metodi che misurano ancora le installazioni con una prova, su iPhone e su Android, e un piano che non tira mai a indovinare.

attribution
fingerprinting
privacy
install attribution
Leggi l’articolo
Guida
Oct 15, 2026
4 min di lettura

Come decifrare il Meta Install Referrer su Android

Campagna, gruppo di inserzioni e inserzione dietro ogni installazione da Facebook e Instagram, visualizzazioni comprese.

meta install referrer
facebook ads
instagram ads
android
Leggi l’articolo
Guida
Aug 14, 2026
11 min di lettura

Deferred deep linking senza SDK: come funziona

Puoi portare il contesto di un link oltre l’installazione senza incorporare un SDK di attribution. Ecco cosa sopravvive davvero al confine dello store su Android e iOS, cosa si rompe e quanto costa in privacy ogni scorciatoia.

deferred deep linking
install referrer
ios
android
Leggi l’articolo

Cerchi altro? Sfoglia tutti gli argomenti su il blog.

Lascia che sia il link a portare il referrer

I link Appy mandano i telefoni Android su Google Play con un referrer già attaccato, e gli iPhone sull’App Store. Piano gratuito, senza carta di credito.