Quand quelqu’un touche votre Onelink et installe votre application depuis Google Play, la Google Play Install Referrer API met le lien touché, avec ses informations supplémentaires comme
?campaign=3for2, à la disposition de votre application pendant 90 jours après l’installation. Le Deferred deep linking (Android) est inclus à partir du plan Team.Nécessite des modifications de votre application
- Étape 1
L’activer
Dans l’éditeur Onelink, sous « Other settings », cochez Enable Android deferred deep linking (Play install referrer) et enregistrez. Dans les 5 minutes, votre application reçoit après une installation un référent comme celui-ci :onelink_url=https%3A%2F%2Fonelink.to%2Fautumn%3Fcampaign%3D3for2onelink_urlest le lien touché par le visiteur, avec ses informations supplémentaires. Placez les informations supplémentaires après?: tout ce qui suit#reste dans le navigateur du visiteur et n’atteint jamais Onelink.to. Si le lien Google Play ou le lien touché porte déjà un référent, c’est celui-là qui parvient tel quel à votre application.Onelink.to limite le référent à 512 caractères, encodé en URL, la limite documentée par Google. Si le lien touché, avec ses informations supplémentaires, le rendait plus long, ces informations sont retirées deonelink_url. - Étape 2
Ajouter la bibliothèque
Ajoutez la Play Install Referrer Library aubuild.gradle.ktsdu module de l’application :implementation("com.android.installreferrer:installreferrer:2.2") - Étape 3
Lire le référent au premier lancement
Google Play conserve le référent pendant 90 jours après l’installation. Appelez cette fonction depuis votre activité de lancement. Elle lit le référent une seule fois et transmet le lien touché :fun readInstallReferrer(context: Context, open: (Uri) -> Unit) { 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) { if (responseCode == InstallReferrerClient.InstallReferrerResponse.OK) { val referrer = client.installReferrer.installReferrer prefs.edit().putBoolean("read", true).apply() Uri.Builder().encodedQuery(referrer).build() .getQueryParameter("onelink_url") ?.let { open(Uri.parse(it)) } } client.endConnection() } override fun onInstallReferrerServiceDisconnected() {} }) } - Étape 4
Agir sur le lien
Lisez dans le lien ce dont votre application a besoin : une information supplémentaire commecampaign=3for2pour appliquer une offre, ou le chemin pour ouvrir un écran. Si votre application ouvre déjà les liens de votre propre domaine, transmettez-y le lien — voir Ouvrir les liens dans votre application (deep linking). N’importe qui peut ajouter des informations supplémentaires à un lien : vérifiez-les donc avant d’agir, comme pour tout lien venant de l’extérieur de l’application. - Étape 5
Tester avec une vraie installation
Google Play ne définit le référent que lorsque l’installation suit un appui sur votre Onelink, et les installations depuis un canal de test interne ou fermé peuvent arriver sans lui. Une fois la version qui lit le référent publiée sur Google Play, supprimez l’application d’un téléphone, touchez votre Onelink sur ce téléphone, installez l’application et ouvrez-la.