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
- 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%3D3for2onelink_urlist 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 inonelink_url. - Schritt 2
Die Bibliothek hinzufügen
Fügen Sie die Play Install Referrer Library derbuild.gradle.ktsdes App-Moduls hinzu:implementation("com.android.installreferrer:installreferrer:2.2") - 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() {} }) } - Schritt 4
Auf den Link reagieren
Lesen Sie aus dem Link, was Ihre App braucht: einen Zusatz wiecampaign=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. - 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.