Deferred Deep Linking unter Android

Übersetzungen werden mit KI erstellt. Falls einige Übersetzungen fehlerhaft sind, teilen Sie es uns bitte unter hello@onelink.to mit

Wenn jemand auf Ihren Onelink tippt und Ihre App aus Google Play installiert, stellt die Google Play Install Referrer API Ihrer App den getippten Link mit Zusätzen wie ?campaign=3for2 für 90 Tage nach der Installation bereit. Deferred Deep Linking (Android) ist ab dem Team-Plan enthalten.

Erfordert Änderungen an Ihrer App

  1. Schritt 1

    Die Funktion aktivieren

    Setzen Sie im Onelink-Editor unter „Other settings“ das Häkchen bei Enable Android deferred deep linking (Play install referrer) und speichern Sie. Innerhalb von 5 Minuten erhält Ihre App nach einer Installation einen Referrer wie diesen:
    onelink_url=https%3A%2F%2Fonelink.to%2Fautumn%3Fcampaign%3D3for2
    onelink_url ist der Link, auf den der Besucher getippt hat, mit seinen Zusätzen. Setzen Sie Zusätze hinter ?: Alles nach # bleibt im Browser des Besuchers und erreicht Onelink.to nie. Trägt der Google-Play-Link oder der getippte Link bereits einen Referrer, erreicht stattdessen dieser unverändert Ihre App.
    Onelink.to hält den Referrer bei höchstens 512 Zeichen, URL-kodiert, der von Google dokumentierten Grenze. Würde der getippte Link mit seinen Zusätzen ihn länger machen, entfallen die Zusätze in onelink_url.
  2. Schritt 2

    Die Bibliothek hinzufügen

    Fügen Sie die Play Install Referrer Library der build.gradle.kts des App-Moduls hinzu:
    implementation("com.android.installreferrer:installreferrer:2.2")
  3. Schritt 3

    Den Referrer beim ersten Start lesen

    Google Play hält den Referrer 90 Tage nach der Installation bereit. Rufen Sie dies aus Ihrer Start-Activity auf. Es liest den Referrer einmal und übergibt den getippten Link:
    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. Schritt 4

    Auf den Link reagieren

    Lesen Sie aus dem Link, was Ihre App braucht: einen Zusatz wie campaign=3for2, um ein Angebot anzuwenden, oder den Pfad, um einen Bildschirm zu öffnen. Wenn Ihre App bereits Links auf Ihrer eigenen Domain öffnet, übergeben Sie den Link dorthin – siehe Links in Ihrer App öffnen (Deep Linking). Jeder kann einem Link Zusätze anhängen. Prüfen Sie diese also, bevor Sie darauf reagieren, wie bei jedem Link, der von außerhalb der App kommt.
  5. Schritt 5

    Mit einer echten Installation testen

    Google Play setzt den Referrer nur, wenn die Installation auf ein Tippen auf Ihren Onelink folgt, und Installationen aus internen und geschlossenen Test-Tracks können ohne ihn ankommen. Sobald die Version, die den Referrer liest, in Google Play veröffentlicht ist, entfernen Sie die App von einem Gerät, tippen Sie auf diesem Gerät auf Ihren Onelink, installieren Sie die App und öffnen Sie sie.

Funktionen in dieser Anleitung