Android'de deferred deep linking

Çeviriler yapay zeka kullanılarak yapılmıştır. Bazı çeviriler yanlışsa, lütfen hello@onelink.to adresinden bize bildirin

Biri Onelink'inize dokunup uygulamanızı Google Play'den yüklediğinde, Google Play Install Referrer API, dokunduğu linki ?campaign=3for2 gibi ekleriyle birlikte kurulumdan sonra 90 gün boyunca uygulamanızın kullanımına sunar. Deferred deep linking (Android) Team planı ve üzerinde dahildir.

Uygulamanızda değişiklik gerektirir

  1. Adım 1

    Açın

    Onelink düzenleyicisinde, "Other settings" altında Enable Android deferred deep linking (Play install referrer) seçeneğini işaretleyin ve kaydedin. 5 dakika içinde uygulamanız, bir kurulumdan sonra şuna benzer bir referans alır:
    onelink_url=https%3A%2F%2Fonelink.to%2Fautumn%3Fcampaign%3D3for2
    onelink_url, ziyaretçinin dokunduğu linktir, ekleriyle birlikte. Ekleri ? işaretinden sonra koyun: # işaretinden sonrası ziyaretçinin tarayıcısında kalır ve Onelink.to'ya hiç ulaşmaz. Google Play linki veya dokunulan link zaten bir referans taşıyorsa, uygulamanıza bunun yerine o referans değiştirilmeden ulaşır.
    Onelink.to referansı, Google'ın belgelediği sınır olan URL kodlu 512 karakter içinde tutar. Dokunulan link ekleriyle birlikte bunu aşacaksa, ekler onelink_url içinden çıkarılır.
  2. Adım 2

    Kütüphaneyi ekleyin

    Play Install Referrer Library'yi uygulama modülünün build.gradle.kts dosyasına ekleyin:
    implementation("com.android.installreferrer:installreferrer:2.2")
  3. Adım 3

    Referansı ilk açılışta okuyun

    Google Play referansı kurulumdan sonra 90 gün boyunca saklar. Bunu başlangıç activity'nizden çağırın. Referansı bir kez okur ve dokunulan linki teslim eder:
    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. Adım 4

    Linke göre işlem yapın

    Uygulamanızın linkten ihtiyaç duyduğunu okuyun: bir teklifi uygulamak için campaign=3for2 gibi bir ek ya da bir ekranı açmak için yol (path). Uygulamanız kendi alan adınızdaki linkleri zaten açıyorsa linki oraya iletin — bkz. Linkleri uygulamanızda açın (deep linking). Herkes bir linke ek ekleyebilir; bu yüzden uygulamanın dışından gelen her linkte yaptığınız gibi, harekete geçmeden önce ekleri kontrol edin.
  5. Adım 5

    Gerçek bir kurulumla test edin

    Google Play referansı yalnızca kurulum Onelink'inize bir dokunuşun ardından geldiğinde ayarlar; dahili ve kapalı test kanallarından yapılan kurulumlar referans olmadan gelebilir. Referansı okuyan sürüm Google Play'de yayınlandıktan sonra uygulamayı bir telefondan kaldırın, o telefonda Onelink'inize dokunun, uygulamayı yükleyin ve açın.

Bu kılavuzdaki özellikler