Comment tester l’install referrer Google Play sur un vrai appareil
Un build lancé depuis Android Studio n’a jamais d’install referrer, alors la plupart des tests lisent une valeur vide et s’arrêtent là. Comment en obtenir un vrai : une URL Play encodée, un canal de test interne, une installation propre et une lecture en Kotlin au premier lancement, plus ce que signifie chaque résultat vide ou étrange.
Des liens qui transmettent eux-mêmes un referrer à Google Play
- Un seul lien pour Google Play, l’App Store et votre site
- Campagne et nom du lien conservés jusqu’à l’installation
- Offre gratuite, sans carte bancaire
Réponse courte
Comment tester l’install referrer Google Play sur un vrai appareil ?
Publiez le build sur un canal de test interne, désinstallez l’app du téléphone de test, ouvrez sur ce téléphone une URL Play avec un referrer encodé en URL, installez depuis la page Play et lisez la valeur avec la Play Install Referrer Library au premier lancement. Un build installé depuis Android Studio ou avec adb ne porte jamais de referrer de campagne.
À retenir
- Le referrer est fixé pour une installation et conservé 90 jours ; pour refaire le test, désinstallez puis réinstallez depuis l’URL Play.
- Encodez la valeur pour que = et & restent dans le paramètre referrer, et limitez-la à 512 caractères.
- utm_source=google-play&utm_medium=organic signifie que l’installation n’est pas passée par votre lien.
La réponse courte
Google Play ne transmet un referrer que pour les installations qui passent par l’app Play Store. Un build de debug installé depuis Android Studio ou avec adb n’a aucune installation Play derrière lui : il n’y a donc aucune donnée de campagne à lire.
Pour un vrai test, publiez un build sur un canal de test interne, désinstallez l’app du téléphone de test, ouvrez sur ce téléphone une URL Play avec un referrer encodé, installez depuis la page Play qui s’affiche et lisez la valeur au premier lancement. Une fois le canal en place, la boucle complète prend une dizaine de minutes.
L’URL Play pour tester
Un lien de store classique avec un paramètre en plus.
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
Page du store
L’adresse Google Play standard d’une app.
?id=com.example.myshop
Package
Votre application ID, exactement comme dans la Play Console.
&referrer=
Paramètre referrer
Tout ce qui suit est transmis à votre app après l’installation.
utm_source%3Dqa_test%26utm_campaign%3Dreferrer_check
Valeur encodée
utm_source=qa_test&utm_campaign=referrer_check, encodée en URL pour que ses = et & restent dans le referrer. Google demande 512 caractères au maximum.
Le test de bout en bout
Ajoutez la bibliothèque et la lecture
Ajoutez com.android.installreferrer:installreferrer:2.2 et appelez la lecture au premier lancement, comme dans le code ci-dessous. Loguez la valeur pour la voir dans logcat.
Publiez en test interne
Importez le build sur le canal de test interne dans la Play Console et ajoutez votre compte Google comme testeur. Un test interne accepte jusqu’à 100 testeurs, et les nouveaux builds leur parviennent en quelques minutes ; la toute première publication peut prendre quelques heures.
Rejoignez le test sur le téléphone
Ouvrez le lien d’inscription de l’onglet Testeurs avec le compte Google connecté à l’app Play Store du téléphone de test.
Désinstallez l’app
Le referrer est fixé pour une installation et ne change pas tant que l’app n’est pas réinstallée. Supprimez toute copie précédente, y compris celle installée par Android Studio.
Ouvrez l’URL Play sur le téléphone
Touchez-la dans Chrome, dans une messagerie ou depuis un QR code, pour qu’elle ouvre l’app Play Store sur ce téléphone. Installer depuis play.google.com dans un navigateur d’ordinateur suit un autre chemin ; testez celui que prennent vos utilisateurs.
Installez et ouvrez l’app
Installez depuis la page Play qui s’est ouverte, puis lancez l’app une fois. Surveillez adb logcat pour voir le referrer et les deux horodatages.
Comparez avec ce que vous avez envoyé
Vous devez voir utm_source=qa_test&utm_campaign=referrer_check, une heure de clic et une heure de début d’installation. Pour recommencer, désinstallez et repartez de l’URL Play.
Le lire au premier lancement
En Kotlin, d’après l’exemple de Google. Le code lit le referrer une fois, le logue et ferme la connexion.
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() {}
})
}Suivre le résultat
Terminal
adb logcat -s InstallReferrerRésultats vides ou étranges : ce qu’ils signifient
Ce que fait Appy
Les liens Appy ajoutent d’eux-mêmes un referrer vers Google Play, avec le nom du lien : un test se résume donc à toucher votre propre lien. Avec l’offre Enterprise, le SDK Appy lit le referrer au premier lancement et attribue l’installation à ce lien comme installation vérifiée. Pour des URL de campagne ponctuelles sans Appy, le générateur de liens de campagne App Store encode le referrer pour vous.
Outils et guides
- Générateur de liens de campagne App Store et Google PlayAjoute des jetons de campagne aux liens App Store et un referrer encodé aux liens Google Play.
- Qu’est-ce que l’install referrer ?La définition courte, et ce qu’il peut ou ne peut pas vous dire.
- Paramètres UTM pour campagnes d’appsComment les UTM passent le store sur Android, et pourquoi ils ne le passent pas sur iPhone.
- SDK Android d’AppyLit le referrer au premier lancement et attribue l’installation au lien.
Sources, consultées le 13 novembre 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
Questions fréquentes
Peut-on tester l’install referrer sans publier l’app ?
Pas avec un vrai referrer. Google Play n’en transmet un que pour les installations qui viennent du Play Store, le build doit donc être sur un canal. Le canal de test interne est le plus rapide : jusqu’à 100 testeurs, et les nouveaux builds sont disponibles en quelques minutes.
Pourquoi mon install referrer est vide ?
Le plus souvent, l’app a été installée depuis Android Studio ou avec adb, ou elle était déjà installée quand vous avez ouvert l’URL Play. Désinstallez-la, ouvrez l’URL Play sur le téléphone et installez depuis la page Play.
Combien de temps l’install referrer reste-t-il disponible ?
Google le conserve pendant 90 jours, et il ne change pas tant que l’app n’est pas réinstallée. Lisez-le une fois, au premier lancement, et enregistrez ce dont vous avez besoin.
Faut-il encoder la valeur du referrer en URL ?
Oui. Encodez toute la valeur pour que ses = et & restent dans le paramètre referrer. Les consignes de Google la limitent aussi à 512 caractères.
L’ancien broadcast INSTALL_REFERRER permet-il encore de tester ?
Non. Utilisez la Play Install Referrer Library, qui lit la valeur depuis l’app Play Store. Les tests qui envoient l’ancien broadcast avec adb ne reflètent pas ce qui se passe lors d’une vraie installation.
Continuer à explorer
Comment mesurer les installations d’app sans fingerprinting
Apple n’autorise pas le fingerprinting, même quand l’utilisateur accepte le suivi, et les régulateurs européens considèrent le suivi par adresse IP comme un accès à l’appareil. Voici ce qui mesure encore les installations avec preuve sur iPhone et Android, et un plan de mesure qui n’a jamais besoin de deviner.
Déchiffrer le Meta Install Referrer sur Android
Facebook et Instagram indiquent à votre app la campagne, l’ensemble de publicités et la publicité derrière chaque installation, affichages compris, avec des données chiffrées par votre propre clé.
Deferred deep linking sans SDK : comment ça marche
On peut transporter le contexte d’un lien à travers une installation sans embarquer de SDK d’attribution. Voici ce qui survit réellement à la frontière du store sur Android et iOS, ce qui casse, et le coût de chaque contournement en matière de vie privée.
Vous cherchez autre chose ? Parcourez tous les sujets sur le blog.
Laissez le lien transmettre le referrer
Les liens Appy envoient les téléphones Android vers Google Play avec un referrer déjà attaché, et les iPhone vers l’App Store. Offre gratuite, sans carte bancaire.