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
- 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%3D3for2onelink_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, ekleronelink_urliçinden çıkarılır. - Adım 2
Kütüphaneyi ekleyin
Play Install Referrer Library'yi uygulama modülününbuild.gradle.ktsdosyasına ekleyin:implementation("com.android.installreferrer:installreferrer:2.2") - 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() {} }) } - Adım 4
Linke göre işlem yapın
Uygulamanızın linkten ihtiyaç duyduğunu okuyun: bir teklifi uygulamak içincampaign=3for2gibi 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. - 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.