Shopify, Webflow, Wix ve Squarespace’te Universal Links: AASA Dosyasını Hangisinde Barındırabilirsiniz?
Uygulama linkleriniz uygulama yerine web sitesini açıyorsa, iOS ve Android çoğu zaman alan adınızdaki iki küçük dosyayı bulamamıştır. Ekim 2026 itibarıyla hangi site oluşturucunun neyi barındırmanıza izin verdiği, sizinki izin vermiyorsa alt alan adı çözümü ve hiç dosya gerektirmeyen bir link.
Site oluşturucunuza dokunmadan uygulamanızı bir linkle açın
- Free dahil her planda mağaza yönlendirmesi
- Pro’da uygulamayı açan deep linkler
- Web sitenize yüklenecek hiçbir şey yok
Link neden web sitenizi açıyor
Universal Link, iOS’un Safari yerine uygulamanıza teslim ettiği sıradan bir https linkidir. Android’deki karşılığının adı App Link. İki telefon da bir yourbrand.com linkini uygulamanızda açmadan önce yourbrand.com’dan uygulamanızı tanımlayan bir dosya indirir. Okunabilir bir dosya yoksa uygulama da açılmaz; link web sitesini açar.
Site oluşturucularda eksik olan genellikle bu dosyadır. Uygulama tarafını geliştiriciniz halletti. Web sitesi tarafındaysa sabit bir adreste bir dosya gerekiyor ve oraya ne koyabileceğinize site oluşturucu karar veriyor.
İki telefonun da kontrol ettiği adres
iOS bu URL’yi uygulamanızın listelediği her alan adında kontrol eder. Android ise aynı klasördeki assetlinks.json dosyasına bakar.
https://yourbrand.com/.well-known/apple-app-site-association
https://
HTTPS, yönlendirme yok
Geçerli bir sertifika ve doğrudan bir yanıt; 301 ya da 302 yok.
yourbrand.com
Birebir aynı host
Her alt alan adı kendi dosyasını sunar. www.yourbrand.com ayrı bir host’tur.
/.well-known/
Sabit bir klasör
Yol değiştirilemez. Site oluşturucular arasındaki fark, bu klasöre dosya koyup koyamamanızda.
apple-app-site-association
Uzantı yok
İçerik JSON, ama adında .json yok. Android’in dosyası assetlinks.json.
Hangi site oluşturucu neyi barındırmanıza izin veriyor
Her site oluşturucunun kendi yardım sayfalarından ve geliştirici dokümanlarından, 23 Ekim 2026.
Her site oluşturucuda durum
Webflow. 16 Aralık 2024’ten beri Webflow her türlü well-known dosyasını sunabiliyor. Assets panelinde well-known adlı bir klasör oluşturun, dosyaları yükleyin ve siteyi yayımlayın. Yüklenen dosyaların .json, .txt ya da .md ile bitmesi gerekiyor; bu yüzden iOS dosyasının adını apple-app-site-association.noext.txt koyun, Webflow uzantıyı kendisi kaldırır. assetlinks.json olduğu gibi yüklenir. Yeni dosyalar için Premium Site planı (ya da eski Business Site planı) gerekiyor ve bu dosyalar webflow.io staging alan adlarında çalışmıyor.
Framer. Site Settings’te Hosting, ardından Files bölümünü açın. Her dosyayı /.well-known yoluyla ekleyin ve yayımlayın. Framer iki dosyayı da adıyla anıyor ve uzantısız dosyaları kabul ediyor. Özellik Pro ve Enterprise planlarında var. Framer uzantısız bir dosyanın hangi içerik türüyle sunulduğunu belirtmiyor; yayımladıktan sonra kontrol edin.
Shopify. Shopify iki dosyadan herhangi birini yüklemenin bir yolunu belgelemiyor. Uygulamanız kaydedildikten sonra ikisini de özel alan adınızda kendisi oluşturuyor; *.myshopify.com’da ise hiçbir zaman. Kayıt iki yoldan yapılabiliyor: bir özel uygulamanın Storefront API ayarlarından ya da kapsamını Shopify Destek’in açması gereken MobilePlatformApplication API’siyle. iOS dosyası /* ile bitiyor; yani /admin ve iki ödeme callback adresi dışında her mağaza URL’si uygulamayı açıyor. Mayıs 2026’da bir geliştirici yollar üzerinde kontrol istedi; 14 Ekim’de Shopify’ın paylaşabileceği bir gelişme yoktu.
Wix. Wix, /.well-known/ altında dosya sunmanın bir yolunu belgelemiyor (Ekim 2026’da kontrol edildi). Yardım merkezinde, hâlâ oy toplayan bir özellik isteğinde, bir alan adının köküne doğrulama dosyası eklemenin şu an mümkün olmadığı yazıyor.
Squarespace. Onda da belgelenmiş bir yol yok. Dosyalarla ilgili yardım sayfası, dosya URL’lerini CDN’in atadığını ve değiştirilemediğini söylüyor. Forumunda önerilen geçici çözüm, 301 yönlendirmesi yapan bir URL mapping kuralı; Apple da Google da bunu reddediyor.
Alt alan adı çözümü
Site oluşturucunuz izin vermiyorsa ya da Shopify’ın her URL’yi uygulamaya gönderen dosyası size fazla geliyorsa web sitenizi olduğu yerde bırakın. links.yourbrand.com gibi bir alt alan adını Netlify, Vercel, Cloudflare Pages ya da Firebase Hosting gibi statik bir barındırma servisine bağlayın; dördünde de yanıt başlıklarını yol bazında ayarlayabiliyorsunuz. Apple’ın TN3155 notu da bununla bağlantılı bir durum için zaten ayrı bir alt alan adı öneriyor: tarayıcıda bir yourbrand.com sayfasından diğerine giden link uygulamayı açmaz, farklı bir alt alan adına giden link ise açar.
İki şey değişiyor. Paylaştığınız linklerin alt alan adına gitmesi gerekiyor; yourbrand.com sayfalarına giden linkler yine web sitesini açar. Uygulamanın da güncellenmesi gerekiyor: Associated Domains’e applinks:links.yourbrand.com, Android’de de bu host için autoVerify içeren bir intent filter eklenmeli. Alt alan adındaki diğer tüm yollara da bir hedef verin, örneğin web sitenize bir yönlendirme; böylece uygulaması olmayanlar 404 sayfasına düşmez.
Üç dosya
Kendi ID’lerinizi ve parmak izinizi yazın. AASA ve assetlinks.json oluşturucusu bunları sizin için doldurur.
.well-known/apple-app-site-association
{
"applinks": {
"details": [
{
"appIDs": ["ABCDE12345.com.yourbrand.app"],
"components": [
{ "/": "/*", "comment": "Every link on this subdomain opens the app" }
]
}
]
}
}.well-known/assetlinks.json
[{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.yourbrand.app",
"sha256_cert_fingerprints": ["14:6D:E9:83:...:3F:CF:44:E5"]
}
}]_headers (Netlify)
/.well-known/apple-app-site-association
Content-Type: application/json
/.well-known/assetlinks.json
Content-Type: application/jsonlinks.yourbrand.com nasıl ayarlanır
Örnek olarak Netlify’ı kullanıyoruz. Diğer servislerde de adımlar aynı, yalnızca kayıt değerleri farklı.
- 01
Klasörü yayına alın
Alan adı
links.yourbrand.com
İki dosyayı içeren .well-known klasörü ve _headers dosyası. Ardından Netlify’da links.yourbrand.com’u siteye ekleyin.
- 02
Tek bir CNAME kaydı ekleyin
- Tür
- CNAME
- Ad
- links
- Değer
- your-site.netlify.app
DNS’iniz nerede yönetiliyorsa orada; bu, site oluşturucunuzun alan adı ayarları da olabilir. Web sitesinin kayıtları yerinde kalır. Kaydın yayılması bir gün sürebilir.
- 03
Önce HTTPS, sonra kontrol
- DNS bekleniyor
- Sertifika oluşturuldu
- İki dosya da açılıyor
https://links.yourbrand.com/.well-known/assetlinks.json
Netlify alt alan adı için bir Let’s Encrypt sertifikası oluşturur ve yeniler. Ardından alt alan adını doğrulayıcıdan geçirin.
Ya da dosyayla hiç uğraşmayın
Uygulamanıza giden tek yol Universal Link değil. Pro planındaki ($9.99/ay) bir Appy linki, mağaza adreslerinizin yanında uygulamanızın URL şemasıyla çalışan deep linkini de taşır; örneğin yourapp://product/42. Safari’de ve Chrome’da önce uygulamayı, sonra mağazayı dener. Instagram’ınki gibi uygulama içi tarayıcılarda “Uygulamayı aç” düğmesi, bir mağaza düğmesi ve Safari’yi ya da Chrome’u açma adımlarını içeren bir sayfa gösterir. Bilgisayarlar web sitenize gider. Sitenize hiçbir şey eklemeniz gerekmez.
Ama bu, kendi alan adınızda bir Universal Link değil. Link appy.to’da çalışır ve yourbrand.com/product/42 yine web sitesini açar. Apple şemalar yerine Universal Links’i kuvvetle öneriyor; nedenlerinden biri, başka bir uygulamanın sizin şemanızı kaydetmesinin önünde hiçbir engel olmaması. Business’ta go.yourbrand.com gibi özel bir alan adı linklerinizi taşır ama yalnızca yönlendirme yapar; Appy üzerinden kendi alan adınızda Universal Links ve App Links ise Enterprise’da. Yukarıdaki alt alan adıyla bir Pro linki deep link olarak https://links.yourbrand.com/product/42 adresini kullanabilir; uygulaması olmayan telefonlar da yine mağazaya ulaşır.
Linki paylaşmadan önce kontrol edin
İki dosyayı da oluşturun
/tools/aasa-assetlinks-generator adresindeki oluşturucu, Team ID, bundle ID, paket adı ve parmak izinizden ikisini de hazırlar.
Alan adını doğrulayın
/tools/universal-link-validator adresindeki doğrulayıcı, AASA dosyasını sunucunuzdan ve Apple’ın CDN’indeki kopyadan çeker; assetlinks.json’da da paket adınızı ve parmak izinizi arar.
Apple’ın CDN’ine zaman tanıyın
iPhone’lar dosyayı Apple’ın CDN’inden okur; CDN de dosyayı 24 saat içinde çeker. Telefonlar yaklaşık haftada bir kontrol eder; uygulamayı yeniden yüklerseniz telefon yeni bir kopya indirir.
Gerçek bir linke dokunun
Linki Notlar’a yapıştırın ya da Mesajlar’dan kendinize gönderin, sonra uygulamanın yüklü olduğu bir telefonda üzerine dokunun. Android’de paket adınızla çalıştırdığınız adb shell pm get-app-links komutu host’u verified olarak listelemeli.
Sıradaki okumalar
- Kapsamlı Universal Links rehberiUygulama tarafı: entitlement’lar, intent filter’lar ve yollar.
- Universal Links Safari’yi mi açıyor?Dosya yerindeyken en sık görülen nedenler.
- Android App Links doğrulanmıyoradb ile beş dakikada teşhis.
- Özel alan adlarıBusiness’ta kendi link alan adınız, Enterprise’da uygulama linkleri.
Site oluşturucularda Universal Links: sorular
apple-app-site-association dosyasını Shopify’a yükleyebilir miyim?
Dosya olarak hayır. Uygulamanız kaydedildikten sonra Shopify bu dosyayı özel alan adınızda kendisi oluşturur ve her mağaza URL’sini uygulamaya gönderir. myshopify.com’da çalışmaz.
Webflow’a .well-known dosyası nasıl eklenir?
Assets panelinde well-known adlı bir klasör oluşturun, dosyayı yükleyin ve yayımlayın. Uzantısız sunulması için iOS dosyasının adını apple-app-site-association.noext.txt koyun. Yeni dosyalar için Premium Site planı ya da üstü gerekir.
Wix ve Squarespace Universal Links’i destekliyor mu?
İkisi de /.well-known/ altında dosya sunmanın bir yolunu belgelemiyor (Ekim 2026’da kontrol edildi). Dosyaları statik bir barındırma servisindeki bir alt alan adında barındırın ya da uygulamayı URL şemasıyla açan bir link kullanın.
/.well-known/ başka yerdeki bir dosyaya yönlendirilebilir mi?
Hayır. Apple dosyanın yönlendirme olmadan sunulmasını şart koşuyor; Android’in dosyası da 301 ya da 302 olmadan açılmalı.
Universal Links web sitesi olmadan çalışır mı?
Ana web sitenize değil, dosyayı sunan bir alan adına ihtiyaç duyarlar; bu yüzden statik bir barındırma servisindeki bir alt alan adı yeterli. Akıllı bir link üzerinden çalışan şema tabanlı bir deep link uygulamayı hiç dosya olmadan açar, ama bu bir Universal Link değildir.
Dosyayı düzelttim. Link neden hâlâ web sitesini açıyor?
iPhone’lar dosyayı Apple’ın CDN’inden okur; CDN dosyayı 24 saat içinde çeker, yüklü uygulamalar da yaklaşık haftada bir kontrol eder. Yeni dosyayı test etmek için uygulamayı yeniden yükleyin.
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.
Alan adınızı bir dakikada kontrol edin
Web sitenizi ya da alt alan adınızı ücretsiz doğrulayıcıdan geçirin: sunucunuzdaki AASA dosyası, Apple’ın CDN’indeki kopya ve assetlinks.json tek kontrolde. Site oluşturucunuz dosyaları barındıramıyorsa bir Appy deep linki uygulamayı onlar olmadan açar.