---
title: "Tester l’install referrer Google Play | Appy"
description: "Testez l’install referrer Google Play sur un vrai téléphone: canal de test interne, URL Play encodée, lecture en Kotlin, et ce que signifie un referrer vide."
source: "https://appy.to/fr/blog/test-google-play-install-referrer"
---

[← Retour au blog](https://appy.to/fr/blog)

Guide

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

Appy•13 novembre 2026•7 min de lecture

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

[Créer mon lien gratuit](https://appy.to/fr/account/register)

Résumer avec[ChatGPT](https://chatgpt.com/?q=R%C3%A9sume%20cette%20page%20et%20liste%20ses%20points%20cl%C3%A9s%20%3A%20https%3A%2F%2Fappy.to%2Ffr%2Fblog%2Ftest-google-play-install-referrer) [Claude](https://claude.ai/new?q=R%C3%A9sume%20cette%20page%20et%20liste%20ses%20points%20cl%C3%A9s%20%3A%20https%3A%2F%2Fappy.to%2Ffr%2Fblog%2Ftest-google-play-install-referrer) [Perplexity](https://www.perplexity.ai/search?q=R%C3%A9sume%20cette%20page%20et%20liste%20ses%20points%20cl%C3%A9s%20%3A%20https%3A%2F%2Fappy.to%2Ffr%2Fblog%2Ftest-google-play-install-referrer)

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

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

Page du store

L’adresse Google Play standard d’une app.

2.  ?id=com.example.myshop

Package

Votre application ID, exactement comme dans la Play Console.

3.  &referrer=

Paramètre referrer

Tout ce qui suit est transmis à votre app après l’installation.

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


Choisissez une valeur facile à repérer dans les logs. Si elle arrive intacte, l’encodage et la transmission fonctionnent tous les deux.

## Le test de bout en bout

01

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

02

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

03

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

04

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

05

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

06

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

07

### 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() {}
})
}
```

Google conserve le referrer pendant 90 jours et demande aux apps de n’appeler l’API qu’une fois, au premier lancement après l’installation.

## Suivre le résultat

Terminal

```
adb logcat -s InstallReferrer
```

Lancez la commande avec le téléphone de test branché en USB, avant d’ouvrir l’app.

## Résultats vides ou étranges : ce qu’ils signifient

Ce que vous voyez

Cause probable

Que faire

Aucune campagne après une installation depuis Android Studio

Cause probable: L’app n’a pas été installée depuis Google Play

Que faire: Installez depuis un canal de test via l’URL Play

utm\_source=google-play&utm\_medium=organic

Cause probable: L’installation n’est pas passée par votre lien ; c’est la valeur habituelle des installations organiques

Que faire: Désinstallez, puis repartez de l’URL Play sur le téléphone

Une ancienne valeur d’un test précédent

Cause probable: L’app n’a pas été réinstallée, le premier referrer est donc toujours là

Que faire: Désinstallez et réinstallez depuis la nouvelle URL

Seul utm\_source arrive, le reste manque

Cause probable: Le referrer n’était pas encodé, et le & l’a coupé trop tôt

Que faire: Encodez la valeur : = devient %3D, & devient %26

SERVICE\_UNAVAILABLE ou FEATURE\_NOT\_SUPPORTED

Cause probable: L’app Play Store est en cours de mise à jour, absente ou trop ancienne

Que faire: Mettez à jour le Play Store et réessayez au lancement suivant

Rien sur un téléphone Huawei sans Google Play

Cause probable: Pas de Play Store, donc pas de referrer Play

Que faire: AppGallery a son propre referrer pour les installations depuis son store

La valeur organique est celle que Google a annoncée en 2016 et que la plupart des SDK renvoient encore ; lisez-la comme « pas de campagne », pas comme une erreur.

## 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.](https://appy.to/fr/tools/app-store-campaign-link)
-   [Qu’est-ce que l’install referrer?La définition courte, et ce qu’il peut ou ne peut pas vous dire.](https://appy.to/fr/glossary/install-referrer)
-   [Paramètres UTM pour campagnes d’appsComment les UTM passent le store sur Android, et pourquoi ils ne le passent pas sur iPhone.](https://appy.to/fr/blog/utm-parameters-for-app-campaigns)
-   [SDK Android d’AppyLit le referrer au premier lancement et attribue l’installation au lien.](https://appy.to/docs/sdk/android)

## Sources, consultées le 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)

## 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

Guide

Oct 21, 2026

8 min de lecture

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

attribution

fingerprinting

privacy

install attribution

[Lire l’article](https://appy.to/fr/blog/measure-app-installs-without-fingerprinting)

Guide

Oct 15, 2026

4 min de lecture

### 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é.

meta install referrer

facebook ads

instagram ads

android

[Lire l’article](https://appy.to/fr/blog/meta-install-referrer-decryption)

Guide

Aug 14, 2026

11 min de lecture

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

deferred deep linking

install referrer

ios

android

[Lire l’article](https://appy.to/fr/blog/deferred-deep-linking-without-sdk)

Vous cherchez autre chose ? Parcourez tous les sujets sur [le blog](https://appy.to/fr/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.

[Créer un lien gratuit](https://appy.to/fr/account/register)
