Deep linking
assetlinks.json dosyası nedir?
Kısaca
assetlinks.json, Android’in alan adınızla uygulamanız arasındaki bağı doğrulamak için okuduğu Digital Asset Links dosyasıdır. https://alanadiniz.com/.well-known/assetlinks.json adresinde yayınlanır; uygulamanın paket adını ve imza sertifikasının SHA-256 parmak izlerini içerir. Dosya yoksa ya da bilgiler tutmuyorsa Android App Links doğrulanmaz ve linkler uygulama yerine tarayıcıda açılır.
Dosyanın içinde ne var
Her kayıt üç bilgi taşır. relation alanı delegate_permission/common.handle_all_urls değerini alır; bu, alan adındaki linkleri uygulamanın açabileceği anlamına gelir. package_name, uygulamanın Google Play’deki paket adıdır. sha256_cert_fingerprints ise uygulamayı imzalayan sertifikaların parmak izleridir. Listeye birden fazla parmak izi yazılabilir; örneğin test ve yayın sürümleri farklı anahtarlarla imzalanıyorsa ikisi de eklenir.
Yayınlama kuralları ve sık hatalar
Dosya HTTPS üzerinden, yönlendirme olmadan ve JSON içerik türüyle (application/json) sunulmalıdır. http’den https’e ya da www’siz adresten www’li adrese yapılan bir yönlendirme bile doğrulamayı bozar.
En sık eksik olan, Play App Signing anahtarının parmak izidir: Google Play uygulamayı kendi tuttuğu anahtarla imzalar ve dosyada yalnızca sizin anahtarınız varsa doğrulama geçmez. Appy’nin ücretsiz Universal Link Doğrulayıcı’sı dosyanızı kontrol edip neyin eksik olduğunu söyler.
https://example.com/.well-known/assetlinks.jsonİlgili terimler
- Android App Links
Android App Links, Android 6.0 ve sonrasında alan adınıza ait https linklerinin doğrudan uygulamanızı açmasını sağlayan doğrulanmış linklerdir. Android, alan adının gerçekten size ait olduğunu assetlinks.json dosyasından kontrol eder; doğrulama geçerse bu linkleri otomatik olarak uygulamanıza yönlendirir. Google’ın Türkçe belgelerinde “Android Uygulama Bağlantıları” adıyla geçer.
- apple-app-site-association (AASA)
apple-app-site-association (kısaca AASA), Universal Links için alan adınızda yayınladığınız JSON dosyasıdır. https://alanadiniz.com/.well-known/apple-app-site-association adresinde durur ve hangi uygulamanın (Team ID ile bundle ID) hangi yolları açacağını listeler. iPhone, bir linkin uygulamada mı Safari’de mi açılacağına bu dosyaya bakarak karar verir; dosya yoksa ya da hatalıysa link web sitesini açar.
Her telefonu doğru yere gönderen bir link oluşturun
Tek link, tek QR kod: iPhone App Store’a, Android telefon kendi mağazasına, bilgisayar web sitenize gider. Ücretsiz planda 4 link ve QR kod var, reklam yok.