Universal Links Safari açıyor mu? Tekrarlanabilir bir akışla düzeltin
Universal link veya app link tıklamaları uygulama yerine tarayıcı açıyorsa sorun genellikle yapılandırma sapması, yönlendirme zinciri veya uygulama kimlik uyuşmazlığıdır. Bu rehber, her kampanya öncesi uygulanabilir net bir kontrol listesi sunar.
Bu rehberde
Neden olur?
Bir universal link yalnızca üç katman birlikte doğruysa uygulamayı açar: alan adı doğrulaması, uygulama kimliği ve çalışma anı yönlendirme davranışı. Çoğu hata rastgele değil, yeniden üretilebilir bir sorundur.
En yaygın yanılgı, tarayıcı fallback görülünce uygulamanın bozuk olduğunu düşünmektir. Çoğu durumda uygulama sağlamdır; sorun alan adı ayarında, CDN/proxy davranışında veya redirect zincirindedir.
10 dakikada hızlı teşhis
- Önce alan adınızı Universal Link Validator ile tarayın ve tüm hataları kaydedin.
- iOS ve Android association dosyalarını sadece iç ağda değil, herkese açık ağdan da kontrol edin.
- Well-known yollarının redirect, auth veya bot koruması ile engellenmediğini doğrulayın.
- Uygulama kimliklerini mağazadaki gerçek production build ile eşleştirin.
- Instagram/TikTok in-app browser, mobil Safari/Chrome ve masaüstü fallback senaryolarında ayrı test yapın.
En yaygın nedenler ve çözümler
| Neden | Belirti | Çözüm |
|---|---|---|
| Association dosyası eksik veya erişilemiyor | Platformdaki tüm linkler tarayıcı açıyor | `/.well-known/apple-app-site-association` ve `/.well-known/assetlinks.json` yollarının redirect olmadan 200 döndüğünü doğrulayın. |
| Yanlış content-type veya CDN davranışı | Dosya var ama doğrulama sessizce başarısız | JSON içeriğini HTTPS üzerinden doğru header ile sunun; header/body değiştiren ara katmanları kaldırın. |
| Uygulama kimlikleri release sürümüyle uyuşmuyor | Staging çalışıyor, production çalışmıyor | iOS Team ID + bundle ID ve Android package + sertifika fingerprint değerlerini yeniden eşleyin. |
| Hedefe gitmeden önce redirect zinciri var | Bazı kampanyalar çalışıyor, bazıları tarayıcı açıyor | Gereksiz 301/302 adımlarını kaldırın ve final HTTPS hedefe doğrudan gidin. |
| In-app browser davranışı placement bazında farklı | Bio link çalışıyor ama reklam tıklaması çalışmıyor (veya tersi) | Kanal ve placement bazında test edin, ardından deterministik fallback kuralları uygulayın. |
Referans dosya formatları
apple-app-site-association (iOS)
{
"applinks": {
"apps": [],
"details": [
{
"appID": "TEAMID.com.example.app",
"paths": ["/promo/*", "/product/*"]
}
]
}
}assetlinks.json (Android)
[
{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": ["AA:BB:CC:..."]
}
}
]Yayın öncesi QA kontrol listesi
- AASA ve assetlinks doğrulaması kritik hatasız geçiyor.
- En az bir gerçek iOS ve bir gerçek Android cihazda uygulama açılışı doğrulanıyor.
- Uygulama kurulu olmayan kullanıcılar için fallback hedefi doğru.
- UTM ve kampanya parametreleri zincir boyunca korunuyor.
- Analytics tarafında app open, store redirect ve web fallback ayrı ölçülüyor.
Önerilen araç destekli akış
1. Doğrula
Universal Link Validator ile alan adı kontrollerini çalıştırın.
2. Düzelt
Header, kimlik, redirect ve fallback sorunlarını öncelik sırasıyla kapatın.
3. Yeniden test et
Gerçek cihazlar ve gerçek kanal senaryoları ile yeniden test edin.
Sorun aktif kampanya sırasında ortaya çıktıysa önce fallback davranışını güvenceye alın. Dönüşümü koruyun, deep link düzeltmelerini paralelde tamamlayın.
Sık sorulan sorular
Neden bazı kullanıcıda çalışıyor, bazılarında çalışmıyor?
Genelde app sürümü, OS sürümü veya in-app browser bağlamı farkı nedeniyle. Platform, sürüm ve placement bazında doğrulayın.
Redirect zinciri universal link davranışını bozar mı?
Evet. Ek redirect adımları doğrulamayı veya çalışma anı davranışını bozabilir.
Sadece simülatörde test etmek yeterli mi?
Hayır. Nihai doğrulama gerçek iOS/Android cihazlarda ve gerçek in-app browser bağlamında yapılmalıdır.
Diğer yazılar
iOS ve Android için kapsamlı Universal Links rehberi
Universal links, deep links ve app links için kurulum, doğrulama, sorun giderme ve en iyi uygulamaları kapsayan eksiksiz rehber.
Deep Linking ve Universal Links: kapsamlı karşılaştırma
Deep links ile universal links arasındaki farkları, hangi durumda hangisinin daha doğru olduğunu ve güvenilir yönlendirme akışlarını öğrenin.
App Store ve Google Play için QR kod: iki mağaza için tek tarama
iPhone kullanıcılarını App Store’a, Android kullanıcılarını Google Play’e yönlendiren; web fallback ve analitik içeren tek bir QR kod oluşturun.
Başka konular için Appy blogunda gezin.
Her kampanya öncesi doğrulayın
Alan adınızı doğrulayıcıdan geçirin, sorunları öncelik sırasıyla kapatın ve kampanyaları güvenle yayınlayın.