Deferred deep linking op Android

Vertalingen worden gemaakt met AI. Als sommige vertalingen incorrect zijn, laat het ons weten op hello@onelink.to

Als iemand op je Onelink tikt en je app installeert vanuit Google Play, maakt de Google Play Install Referrer API de link waarop diegene tikte, met extra's zoals ?campaign=3for2, tot 90 dagen na de installatie beschikbaar voor je app. Deferred deep linking (Android) is inbegrepen vanaf het Team plan.

Vereist wijzigingen in je app

  1. Stap 1

    Schakel het in

    Vink in de Onelink-editor, onder “Other settings”, Enable Android deferred deep linking (Play install referrer) aan en sla op. Binnen 5 minuten ontvangt je app na een installatie een referrer zoals deze:
    onelink_url=https%3A%2F%2Fonelink.to%2Fautumn%3Fcampaign%3D3for2
    onelink_url is de link waarop de bezoeker tikte, met zijn extra's. Zet extra's achter ?: alles na # blijft in de browser van de bezoeker en bereikt Onelink.to nooit. Heeft de Google Play-link of de aangetikte link al een referrer, dan bereikt in plaats daarvan die ongewijzigd je app.
    Onelink.to houdt de referrer binnen 512 tekens, URL-gecodeerd, de limiet die Google documenteert. Zou de aangetikte link met zijn extra's hem langer maken, dan vallen de extra's uit onelink_url weg.
  2. Stap 2

    Voeg de library toe

    Voeg de Play Install Referrer Library toe aan de build.gradle.kts van de app-module:
    implementation("com.android.installreferrer:installreferrer:2.2")
  3. Stap 3

    Lees de referrer bij de eerste start

    Google Play bewaart de referrer 90 dagen na de installatie. Roep dit aan vanuit je launch-activity. Het leest de referrer één keer en geeft de aangetikte link door:
    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. Stap 4

    Gebruik de link

    Lees uit de link wat je app nodig heeft: een extra zoals campaign=3for2 om een aanbieding toe te passen, of het pad om een scherm te openen. Opent je app al links op je eigen domein, geef de link dan daaraan door — zie Links openen in je app (deep linking). Iedereen kan extra's aan een link toevoegen, dus controleer ze voordat je erop handelt, zoals bij elke link van buiten de app.
  5. Stap 5

    Test met een echte installatie

    Google Play zet de referrer alleen als de installatie volgt op een tik op je Onelink, en installaties via interne en gesloten testtracks kunnen zonder binnenkomen. Zodra de versie die de referrer leest live staat in Google Play, verwijder je de app van een telefoon, tik je op die telefoon op je Onelink, installeer je en open je de app.

Functies in deze handleiding