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ı, link tarayıcıda açılınca 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.
Bir tıklama kaynağından dokunuş
Instagram ya da TikTok in-app browser’ı, mobil Safari ya da Chrome, masaüstü
- 01
Alan adı doğrulaması
/.well-known/apple-app-site-association · /.well-known/assetlinks.json
Sorun kaynağı: CDN, proxy ya da kampanya aracından gelen yönlendirme, kimlik doğrulama kapısı veya bot kontrolü
- 02
Uygulama kimliği
Team ID + bundle ID · paket adı + sertifika parmak izi
Sorun kaynağı: mağazadaki derlemeyle eşleşmeyen kimlikler
- 03
Çalışma anı yönlendirmesi
tıklama kaynağı → uygulama açma kararı
Sorun kaynağı: farklı davranan bir in-app browser ya da placement
Uygulama açılır
Üç katman da uyumlu
Onun yerine Safari ya da Chrome açılır
Çoğu zaman uygulama sağlamdır, sorun alan adı ayarındadır
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 web sitenizin açılması gereken masaüstü 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 uygulama açılmadığında kullanıcının nereye gideceğini net kurallara bağlayı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.
- Uygulaması kurulu olmayan kullanıcılar doğru mağaza sayfasına veya web sitesine gidiyor.
- UTM ve kampanya parametreleri zincir boyunca korunuyor.
- Analytics tarafında app open, store redirect ve web sitesi ziyaretleri 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 uygulama açılmadığında yapılan yönlendirme 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 her tıklamanın mağazaya veya web sitenize ulaştığından emin olun. 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
Universal Link ve App Link Hata Kodları: Ne Anlama Geliyorlar?
SWCERR00101, SWCERR00301, legacy_failure ve 1026 gibi Universal Link ve Android App Link hatalarının anlamı, nerede göründükleri ve uygulamanın yeniden açılmasını sağlayan çözümler.
Uygulama İçi Tarayıcılar Deep Linkleri Nasıl Ele Alıyor: Instagram, TikTok, Facebook, Gmail, Telegram ve Diğerleri
Linkiniz Safari’den uygulamayı açıp Instagram’da neden ölü kalıyor? Her uygulamanın kullandığı tarayıcı türü, iOS ve Android kuralları ve Instagram’dan Telegram’a uygulama uygulama belgelenmiş davranışlar.
Özel Alan Adıyla Kısa Linkler: Uygulamalar için Pratik Rehber
Kendi alan adınızdaki bir linkin neden işe yaradığı, alt alan adını nasıl seçeceğiniz, üç adımlık kurulum ve daha önce paylaştığınız linklerle QR kodlara ne olacağı.
Başka konular için blogda 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.