Universal Links ve App Links doğrulayıcı

apple-app-site-association veya assetlinks.json dosyanızı yapıştırın; neyin yanlış olduğunu Apple ya da Google’dan önce görün.

Yayından önce

Dosyayı bağlantıların kullandığı her alan adında /.well-known/ altında HTTPS ile, yönlendirme olmadan sunun.
application/json olarak gönderin (apple-app-site-association için .json uzantısı olmadan).
İnsanların yüklediği derlemenin imza sertifikasını kullanın: Google Play App Signing’in kendi sertifikası vardır.
Dosyayı değiştirdikten sonra uygulamayı yeniden yükleyin — cihazlar dosyayı önbelleğe alır.

Henüz dosyanız yok mu? Bir tane oluşturun →

Nasıl çalışır

Dosya tarayıcınızda kontrol edilir: yapı, uygulama kimlikleri, yollar ve sertifika parmak izleri.
Tarayıcılar başka sitelerin dosyalarını indiremez; bu yüzden URL yerine içeriği yapıştırın.
Geçerli bir dosya işin yarısıdır — aşağıdaki kontrol listesi diğer yarısını kapsar.

Universal Links neden uygulama yerine Safari’yi açar

iOS, apple-app-site-association dosyasını bir bağlantıya dokunulduğunda değil, uygulama yüklendiğinde Apple’ın CDN’i üzerinden indirir. Dosya o anda eksik, yönlendirilmiş veya hatalıysa, uygulama yeniden yüklenene ya da önbellek yenilenene kadar bağlantılar Safari’de açılır.

Olağan nedenler: appIDs kaydı, başında 10 karakterlik Team ID olmadan bundle ID kullanıyor; paths veya components bağlantıyla eşleşmiyor; dosya bir yönlendirmeyle ya da yanlış host’tan (www ile çıplak alan adı) sunuluyor; ya da uygulamanın Associated Domains yetkisinde “applinks:” ve tam host eksik.

Bir tane daha: bulunduğunuz sayfayla aynı alan adındaki bir bağlantıya dokunulduğunda, tasarım gereği Safari’de kalınır. Notlar’dan, Mesajlar’dan veya başka bir siteden test edin.

Android App Links neden tarayıcıyı açar

Android, android:autoVerify="true" içeren bir intent filter’daki her host için assetlinks.json dosyasını doğrular. Bunlardan herhangi biri için doğrulama başarısız olursa, bağlantıların hiçbiri uygulamayı otomatik olarak açmaz.

Hataların çoğu parmak izlerinden kaynaklanır: dosya debug veya yükleme anahtarını listeler, oysa insanlar Google Play App Signing ile imzalanmış derlemeyi yükler. SHA-256 değerini Play Console’da Uygulama bütünlüğü altından kopyalayın ve insanların yüklediği bir derlemeyi imzalayan her anahtarı listeleyin.

Android 12 ve sonrasında durumu adb shell pm get-app-links ve ardından paket adınızla kontrol edebilir, dosyayı düzelttikten sonra doğrulamayı yeniden çalıştırabilirsiniz.

Sık sorulan sorular

apple-app-site-association nerede barındırılmalı?

https://your-domain/.well-known/apple-app-site-association adresinde, HTTPS üzerinden, yönlendirme olmadan, application/json olarak ve .json uzantısı olmadan sunulmalıdır.

assetlinks.json nerede barındırılmalı?

https://your-domain/.well-known/assetlinks.json adresinde, HTTPS üzerinden, yönlendirme olmadan ve application/json olarak sunulmalıdır.

Neden URL ile doğrulayamıyorum?

Tarayıcılar, o site izin vermedikçe bir sayfanın başka bir sitedeki dosyaları okumasına izin vermez ve bu dosyalar genellikle izin vermez. URL’yi açın, içeriği kopyalayın ve buraya yapıştırın.

Hangi SHA-256 parmak izine ihtiyacım var?

İnsanların yüklediği derlemeyi imzalayan sertifikanın parmak izine. Google Play App Signing ile bu, yükleme anahtarınız değil, Play Console’da gösterilen uygulama imzalama anahtarıdır. Kendi anahtarınızla imzalanmış derlemeler de dağıtıyorsanız ikisini de ekleyin.

Dosyayı düzelttim ama bağlantılar hâlâ tarayıcıyı açıyor. Neden?

Cihazlar sonucu önbelleğe alır. iOS’ta uygulamayı yeniden yükleyin; Android’de doğrulamayı yeniden çalıştırın veya uygulamayı yeniden yükleyin. Ayrıca uygulamanın Associated Domains veya intent filter ayarlarında tam host’un yazılı olduğunu kontrol edin.

Diğer ücretsiz araçlar

Tüm mağazalar için tek bağlantı ve QR kod

SetLinks her ziyaretçiyi kendi mağazasına gönderir ve her tıklamayı sayar. Ücretsiz başlayın.

Akıllı bağlantı oluştur