Appy
← Bloga dön
Rehber

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.

23 Ekim 2026•7 dk okuma

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
Ücretsiz linkinizi oluşturun

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

  1. https://

    HTTPS, yönlendirme yok

    Geçerli bir sertifika ve doğrudan bir yanıt; 301 ya da 302 yok.

  2. yourbrand.com

    Birebir aynı host

    Her alt alan adı kendi dosyasını sunar. www.yourbrand.com ayrı bir host’tur.

  3. /.well-known/

    Sabit bir klasör

    Yol değiştirilemez. Site oluşturucular arasındaki fark, bu klasöre dosya koyup koyamamanızda.

  4. apple-app-site-association

    Uzantı yok

    İçerik JSON, ama adında .json yok. Android’in dosyası assetlinks.json.

Apple’ın “Supporting associated domains” ve Android’in “Configure website associations” (16 Ekim 2026’da güncellendi) dokümanları; 23 Ekim 2026’da kontrol edildi. Android application/json istiyor; Apple bir içerik türü belirtmiyor, bu yüzden iki dosyayı da JSON olarak sunun.

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.

Webflow
iOS dosyası (AASA)well-known adlı bir Assets klasörüne yüklenir; Premium Site planı ve üstü
Android dosyası (assetlinks.json)Aynı klasör, aynı plan
Framer
iOS dosyası (AASA)/.well-known altında statik dosya; Pro ya da Enterprise
Android dosyası (assetlinks.json)Aynı özellik, dosya adıyla anılıyor
Shopify
iOS dosyası (AASA)Sizin yerinize oluşturuluyor; yalnızca özel alan adında, her mağaza URL’si uygulamayı açıyor
Android dosyası (assetlinks.json)Aynı şekilde, tüm URL’ler için oluşturuluyor
Wix
iOS dosyası (AASA)Belgelenmiş bir yolu yok
Android dosyası (assetlinks.json)Belgelenmiş bir yolu yok
Squarespace
iOS dosyası (AASA)Belgelenmiş bir yolu yok; dosya URL’leri sabit
Android dosyası (assetlinks.json)Belgelenmiş bir yolu yok
Kaynaklar: Webflow, Wix ve Squarespace yardım merkezleri, Framer Help (15 Eylül 2026’da güncellendi) ve shopify.dev; 23 Ekim 2026’da kontrol edildi.

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/json
Biçimler Apple’ın ve Android’in dokümanlarından. Netlify’ın _headers dosyası yanıt başlıklarının çoğunu ayarlayabiliyor ve Content-Type istisnalar arasında değil (doküman 1 Aralık 2025’te güncellendi). Vercel’de kural vercel.json’a yazılır. Uygulamanızı Google Play imzalıyorsa parmak izini Play Console’da Release › Setup › App signing altından kopyalayın.

links.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ı.

  1. 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.

  2. 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.

  3. 03

    Önce HTTPS, sonra kontrol

    1. DNS bekleniyor
    2. Sertifika oluşturuldu
    3. İ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.

Netlify’ın DNS ve HTTPS dokümanlarından (Ekim 2025 ve Ekim 2026’da güncellendi). Vercel’de /.well-known ne yönlendirilebiliyor ne de yeniden yazılabiliyor; bu yüzden her şeyi yakalayan bir kural dosyaları yutmaz.

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

01

İ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.

02

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.

03

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.

04

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

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

Sorun Giderme
Oct 9, 2026
9 dk okuma

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.

universal links
app links
apple-app-site-association
assetlinks.json
Yazıyı oku
Rehber
Oct 9, 2026
12 dk okuma

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.

in-app browser
universal links
app links
instagram
Yazıyı oku
Rehber
Oct 1, 2026
6 dk okuma

Ö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ğı.

custom domain
branded short links
url shortener
qr codes
Yazıyı oku

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.