Uygulama içindeki doğru ekrana kullanıcıyı taşıyamadığında, en iyi kampanya bile dönüşüm kaybeder. Android deep link kurulumu tam bu noktada kritik rol oynar; çünkü reklam, e-posta, QR kod ya da web sayfasından gelen kişiyi doğrudan ilgili içerikle buluşturur. Eğer bağlantı yanlış yapılandırılırsa kullanıcı ana sayfaya düşer, uygulama açılmaz ya da güvenlik doğrulaması yüzünden bağlantı boşa çıkar. Bu yazıda, Android deep link kurulumunu teknik temeliyle ele alacağım; ayrıca sahada sık gördüğüm hataları ve bunları nasıl önlediğini net biçimde göstereceğim.

Android deep link mantığını doğru kurmak neden fark yaratır

Android tarafında deep link, bir URL ya da URI üzerinden uygulama içinde belirli bir ekrana geçiş sağlar. Temelde üç yaklaşım öne çıkar: klasik deep link, web bağlantısını uygulamayla doğrulayan Android App Links ve ertelenmiş deep link senaryoları. Buradaki ayrım sadece teknik değil, aynı zamanda kullanıcı deneyimi ve ölçümleme açısından da belirleyicidir.

Klasik deep link çoğu zaman özel bir şema ile çalışır. Örnek olarak myapp://urun/123 yapısını düşünebilirsin. Bu yöntem hızlıdır; ancak güvenlik ve sahiplik doğrulaması sunmaz. Başka bir uygulama aynı şemayı talep ederse çakışma yaşanabilir.

Android App Links ise https tabanlı URL kullanır ve alan adının gerçekten sana ait olduğunu assetlinks.json dosyasıyla doğrular. Google’ın Android geliştirici dokümantasyonu bu modeli özellikle önerir; çünkü kullanıcıya bağlantı seçici ekranını daha az gösterir ve güven ilişkisini güçlendirir. Arama, reklam ve e-posta akışlarında bu fark doğrudan tıklama sonrası deneyime yansır.

Ertelenmiş deep link başka bir sorunu çözer. Kullanıcı uygulama yüklü değilse önce mağazaya gider, yükleme tamamlandıktan sonra hedeflenen içeriğe ulaşır. Bu model özellikle kullanıcı kazanımı kampanyalarında ciddi etki yaratır. AppsFlyer ve Adjust gibi mobil ölçümleme sağlayıcılarının yıllık raporlarında, doğru yönlendirilmiş onboarding akışlarının kurulum sonrası ilk oturum tamamlama oranlarını anlamlı biçimde artırdığı sıkça vurgulanır. Rakamlar sektöre göre değişse de ortak bulgu nettir: ilk açılışta bağlamı koruyan uygulamalar daha yüksek aktivasyon görür.

Burada bir teknik gerçeği atlamamak gerekir: Android 12 ve sonrası sürümlerde web bağlantısı doğrulaması daha görünür hale geldi. Yani sadece intent-filter eklemek artık tek başına yeterli değil. Alan adı doğrulaması, manifest ayarı ve uygulama içi yönlendirme kodu birlikte çalışmalı.

Kendi tecrübemle söyleyebilirim ki ekipler en çok “link çalışıyor” sanıp test sürecini erken bitiriyor. Oysa deep link’in gerçekten doğru çalışması için en az üç koşulu aynı anda sağlaman gerekir: doğru hedef ekran, doğru parametre taşıma ve doğru fallback davranışı.

Kurulum akışı: Manifest, doğrulama ve yönlendirme zinciri

Android deep link kurulumunu sağlam yapmak için sadece tek dosyaya odaklanma. Başarılı bir yapı dört katmandan oluşur: URL tasarımı, AndroidManifest.xml ayarı, alan adı doğrulaması ve uygulama içi route yönetimi.

1. URL yapısını baştan standardize et

Önce hangi sayfaların deep link alacağını belirle. Ürün detayı, kampanya sayfası, profil, sepet veya belirli bir içerik ekranı gibi hedefler için tutarlı bir URL mimarisi kur.

1. https://alanadiniz.com/urun/123
2. https://alanadiniz.com/kampanya/yaz-indirimi
3. https://alanadiniz.com/profil/ayarlar

Burada amaç sadece erişim değil, ölçümleme ve bakım kolaylığıdır. Tutarsız URL yapısı analitik raporlarını bozar ve yönlendirme kodunu kırılgan hale getirir.

2. AndroidManifest.xml içinde intent-filter tanımla

Deep link’i karşılayacak activity için intent-filter eklersin. Android App Links için scheme, host ve path tanımları açık olmalı. autoVerify niteliği de alan adı doğrulama sürecini tetikler.

Örnek mantık şu şekilde ilerler:
– action olarak android.intent.action.VIEW kullan
– category içinde DEFAULT ve BROWSABLE ekle
– data alanında https şeması, alan adı ve gerekiyorsa pathPrefix tanımla
– android:autoVerify değerini true yap

Bu aşamada yapılan küçük bir host hatası bile tüm akışı bozar. Özellikle www ve non-www farkı, alt alan adı kullanımı ve pathPrefix uyuşmazlığı çok sık sorun çıkarır.

3. assetlinks.json dosyasını doğru konuma yerleştir

Android App Links doğrulaması için alan adının kökünde şu yolu kullanırsın:
– https://alanadiniz.com/.well-known/assetlinks.json

Bu dosyada paket adı ve uygulamanın SHA-256 sertifika parmak izi yer alır. Google’ın resmi Android geliştirici belgeleri, doğrulamanın bu dosya üzerinden yapıldığını açık biçimde belirtir. Eğer debug ve release sertifikalarını karıştırırsan doğrulama başarısız olur.

Dosyada şu mantık bulunur:
– relation alanı
– target namespace değeri androidapp
– packagename
– sha256certfingerprints

Yıllar süren mobil yönlendirme takibim gösteriyor ki üretim ortamında yaşanan deep link sorunlarının büyük kısmı koddan değil, bu dosyadaki sertifika uyuşmazlığından kaynaklanır.

4. Uygulama içi route çözümlemesini eksiksiz yap

Bağlantı uygulamayı açtıktan sonra iş bitmez. URL içindeki parametreyi doğru parse etmen gerekir. Örnek olarak ürün kimliği, kampanya kodu, içerik slug yapısı ya da yönlendirme kaynağı uygulama içinde karşılanmalı.

Burada şu kontrolleri kur:
– Hedef içerik yoksa kullanıcıyı anlamlı bir fallback ekrana taşı
– Oturum gerekiyorsa önce login akışına al, sonra hedefe geri döndür
– Parametre bozuksa sessizce ana sayfaya atmak yerine ölçümleme eventi yaz
– UTM veya campaign parametrelerini analitik sistemine işle

Firebase dokümantasyonu ve modern attribution araçları, ilk oturum bağlamının korunmasının kampanya analizi için kritik olduğunu sıkça vurgular. Bu veri olmadan hangi kanalın gerçekten kaliteli kullanıcı getirdiğini anlayamazsın.

5. ADB ile manuel test yap

Kurulum tamamlandıktan sonra ADB komutlarıyla test et. Bu adım seni varsayımlardan kurtarır. Tarayıcı tıklaması dışında doğrudan intent testi yapmak, sorunun URL’de mi, manifestte mi, route katmanında mı olduğunu hızla gösterir.

Testte şu senaryoları ayrı ayrı dene:
– Uygulama yüklü ve açık değil
– Uygulama yüklü ve arka planda
– Uygulama yüklü değil
– Kullanıcı oturum açmış
– Kullanıcı oturum açmamış
– Geçerli parametre
– Eksik ya da bozuk parametre

Bu test yaklaşımı sana zaman kazandırır. Çünkü deep link sorunları çoğu zaman “herkeste olmuyor” diye geçiştirilir; oysa cihaz durumu ve oturum bilgisi sonucu doğrudan etkiler.

Hangi deep link türünü ne zaman seçmelisin

Her proje için tek doğru model yok. Uygulamanın ölçeği, trafik kaynakları ve güvenlik ihtiyacı seçimi belirler.

Klasik deep link şu durumda iş görür:
– Kapalı ekosistem içi yönlendirme yapıyorsan
– Hızlı prototip çıkarıyorsan
– Kısa ömürlü test akışı kuruyorsan

Android App Links şu durumda daha güçlüdür:
– Web ve uygulama arasında sık trafik taşıyorsan
– SEO, e-posta ve reklam trafiğini uygulamaya indirmek istiyorsan
– Bağlantı sahipliğini doğrulamak istiyorsan
– Kullanıcıya seçim ekranı yerine daha net açılış deneyimi sunmak istiyorsan

Ertelenmiş deep link şu durumda öne çıkar:
– Performans pazarlaması yürütüyorsan
– Uygulama kurulumundan sonra kişiyi doğrudan kampanya içeriğine taşımak istiyorsan
– İlk oturumdaki sürtünmeyi azaltmayı hedefliyorsan

Bilim Türk üzerinde mobil büyüme ve uygulama deneyimi odaklı içerikleri incelerken de benzer bir çizgi görürsün: iyi çalışan yönlendirme sistemi, yalnızca teknik bir kurgu değil; aynı zamanda gelir ve elde tutma stratejisidir.

Sahada en çok karşıma çıkan kırılma noktaları

Deep link kurulumu teoride basit görünür; fakat üretim ortamında sorunlar çoğu zaman kenar senaryolarda patlar. İşte en kritik kırılma noktaları:

İlk kırılma noktası alan adı doğrulamasıdır. Özellikle CDN, yönlendirme zinciri veya güvenlik katmanı kullanan sitelerde .well-known klasörü yanlış servis edilir. assetlinks.json dosyası 200 dönse bile içerik tipi, yönlendirme ya da önbellek yüzünden doğrulama aksayabilir.

İkinci kırılma noktası route çakışmasıdır. Aynı activity çok fazla path karşılıyorsa uygulama içinde yanlış ekran açılabilir. Özellikle kampanya ve ürün linklerinin tek parser içinde gelişigüzel çözülmesi hata üretir.

Üçüncü kırılma noktası login duvarıdır. Kullanıcı korumalı bir ekrana gitmek ister, uygulama onu giriş ekranına atar; fakat girişten sonra hedefe geri dönemez. Bu, dönüşüm kaybının klasik nedenlerinden biridir.

Dördüncü kırılma noktası ölçümleme eksikliğidir. Link açıldı mı, uygulama açıldı mı, doğru ekran görüntülendi mi, kullanıcı hedef aksiyonu tamamladı mı? Eğer bu zincirin her halkasını event bazında izlemiyorsan sadece tahmin yürütürsün.

Branch ve AppsFlyer gibi sağlayıcıların paylaştığı sektör verileri, mobil onboarding akışında sürtünme arttıkça kullanıcı kaybının ilk oturumda keskin biçimde yükseldiğini gösterir. Kesin oran kampanyaya göre değişir; fakat eğilim değişmez: yanlış yönlendirme, pahalı kullanıcı edinimini boşa harcar.

Kurulumu güçlendiren pratik kararlar

Ben sahada deep link tasarlarken önce teknik doğruluğu değil, iş hedefini netleştiririm. Çünkü aynı bağlantı yapısı, e-ticarette sepete dönüşümü etkilerken içerik uygulamasında okunma süresini etkiler. Bu yüzden şu kararlar fark yaratır:

– URL yapısında insan tarafından okunabilir segmentler kullan. Hem hata ayıklama kolaylaşır hem pazarlama ekibi link mantığını daha rahat kavrar.
– Her link için fallback ekranını önceden tanımla. Hedef içerik silinmişse kullanıcıyı boş ekrana bırakma.
– UTM ve kampanya parametrelerini uygulama tarafında normalize et. Farklı ekiplerin farklı isimlendirme yapması raporları bozar.
– Login sonrası geri dönüş senaryosunu ayrı test et. Bu adım genelde atlanır.
– Uygulama güncelleme geçişlerinde route uyumluluğunu koru. Eski kampanya linkleri yeni sürümde de anlamlı davranmalı.
– Pazarlama ekibine test edilebilir örnek link havuzu ver. Böylece üretime çıkmadan önce herkes aynı senaryoları görür.

Kendi tecrübemle söyleyebilirim ki en iyi deep link mimarisi, geliştirici dışında pazarlama ve ürün ekibinin de anlayabildiği mimaridir. Anlaşılmayan kurgu uzun ömürlü olmaz.

Bilim Türk okurlarının da sık yaptığı bir hata var: sadece teknik kurulum tamamlanınca işin bittiğini düşünmek. Oysa asıl kalite, kampanya linki canlıya çıktıktan sonra ölçüm verisiyle kendini gösterir.

Sıkça Sorulan Sorular

Android deep link ile Android App Links arasındaki fark nedir?

Deep link genel kavramdır. Android App Links ise https tabanlı, alan adı doğrulaması yapan daha güvenli alt modeldir.

assetlinks.json dosyası nereye konur?

Alan adının kökünde yer alan .well-known klasörüne koyarsın. Erişim yolu doğrudan tarayıcıdan açılmalı.

Deep link neden uygulama yerine tarayıcıda açılır?

Manifest tanımı eksik olabilir, alan adı doğrulaması başarısız olabilir ya da cihaz bağlantıyı varsayılan olarak tarayıcıya yönlendiriyor olabilir.

Tek activity ile tüm deep linkleri yönetmek doğru mu?

Küçük projede iş görür; ancak büyüyen uygulamada route karmaşası yaratır. Daha net ayrım yapan bir yönlendirme katmanı daha güvenlidir.

Uygulama yüklü değilse deep link ne yapar?

Klasik deep link çoğu zaman başarısız olur. Ertelenmiş deep link çözümü kullanırsan kullanıcıyı mağazaya yönlendirip kurulum sonrası hedef içeriğe taşıyabilirsin.

Deep link kurulumunu nasıl test etmeliyim?

ADB komutları, gerçek cihaz testleri, yüklü-yüklü değil senaryoları ve oturum açık-kapalı akışlarıyla test etmelisin.

SEO açısından deep link kurulumu neden değerli?

Web içeriğinden uygulamaya daha tutarlı geçiş sağlar. Bu da kullanıcı deneyimini iyileştirir ve kampanya trafiğinin daha verimli değerlendirilmesine yardım eder.

Eğer şu an kendi uygulamanda link tıklanınca kullanıcı yanlış ekrana düşüyorsa, önce bir test matrisi çıkar ve her URL için hedef ekranı tek tek doğrula. En çok zorlandığın senaryo ürün detayı, kampanya sayfası ya da login sonrası yönlendirme ise onu yorumlarda yaz; birlikte en doğru akışı netleştirelim.