Deferred deep linking sur Android

Les traductions sont réalisées avec l'IA. Si certaines traductions sont incorrectes, veuillez nous le faire savoir sur hello@onelink.to

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

  1. É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%3D3for2
    onelink_url est 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 de onelink_url.
  2. Étape 2

    Ajouter la bibliothèque

    Ajoutez la Play Install Referrer Library au build.gradle.kts du module de l’application :
    implementation("com.android.installreferrer:installreferrer:2.2")
  3. É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() {}
        })
    }
  4. Étape 4

    Agir sur le lien

    Lisez dans le lien ce dont votre application a besoin : une information supplémentaire comme campaign=3for2 pour 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.
  5. É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.

Fonctionnalités de ce guide