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
Deep Linking vs Universal Links: Complete Comparison
Understand the key differences between deep links and universal links, when to use each, and how to implement them effectively.
Complete Guide to Universal Links for iOS and Android
Everything you need to know about universal links, deep links, and app links. Learn how to implement them and boost your mobile marketing.
Instagram & TikTok Deep Links for App Installs: Route to App, Store, or Web
Learn how to route Instagram Stories, profile links, and paid ads plus TikTok bio and ad traffic to deeplinks, app stores, or web fallbacks with one smart link.
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.