---
title: "Testare l’install referrer di Google Play | Appy"
description: "Come testare l’install referrer di Google Play su un telefono vero: test interno, URL di Play codificato, lettura in Kotlin al primo avvio e risultati vuoti."
source: "https://appy.to/it/blog/test-google-play-install-referrer"
---

[← Torna al blog](https://appy.to/it/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](https://appy.to/it/account/register)

Riassumi con[ChatGPT](https://chatgpt.com/?q=Riassumi%20questa%20pagina%20ed%20elenca%20i%20punti%20chiave%3A%20https%3A%2F%2Fappy.to%2Fit%2Fblog%2Ftest-google-play-install-referrer) [Claude](https://claude.ai/new?q=Riassumi%20questa%20pagina%20ed%20elenca%20i%20punti%20chiave%3A%20https%3A%2F%2Fappy.to%2Fit%2Fblog%2Ftest-google-play-install-referrer) [Perplexity](https://www.perplexity.ai/search?q=Riassumi%20questa%20pagina%20ed%20elenca%20i%20punti%20chiave%3A%20https%3A%2F%2Fappy.to%2Fit%2Fblog%2Ftest-google-play-install-referrer)

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

Cosa vedi

Causa probabile

Cosa fare

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

-   [Generatore di link di campagna per App Store e Google PlayAggiunge i token di campagna ai link App Store e un referrer codificato ai link Google Play.](https://appy.to/it/tools/app-store-campaign-link)
-   [Cos’è l’install referrer?La definizione breve, e cosa può dirti e cosa no.](https://appy.to/it/glossary/install-referrer)
-   [Parametri UTM per campagne di appCome gli UTM superano lo store su Android, e perché su iPhone no.](https://appy.to/it/blog/utm-parameters-for-app-campaigns)
-   [SDK Android di AppyLegge il referrer al primo avvio e attribuisce l’installazione al link.](https://appy.to/docs/sdk/android)

## Fonti, consultate il 13 novembre 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)

## 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](https://appy.to/it/blog/measure-app-installs-without-fingerprinting)

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](https://appy.to/it/blog/meta-install-referrer-decryption)

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](https://appy.to/it/blog/deferred-deep-linking-without-sdk)

Cerchi altro? Sfoglia tutti gli argomenti su [il blog](https://appy.to/it/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.

[Crea un link gratis](https://appy.to/it/account/register)
