Appy

Deep linking

Android App Links nedir?

Kısaca

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.

Nasıl kurulur

Uygulamanın manifest dosyasında, alan adınızı tanımlayan intent filter’a android:autoVerify="true" eklenir. Sitenizde de /.well-known/assetlinks.json adresinde bir dosya yayınlanır. Bu dosya uygulamanın paket adını ve imza sertifikasının SHA-256 parmak izlerini listeler.

Android, uygulama yüklendiğinde bu dosyayı ister ve içindeki parmak izini yüklü uygulamanın imzasıyla karşılaştırır. Eşleşme varsa alan adı uygulamanıza bağlanır.

En sık görülen hata

Uygulamanız Google Play’de Play App Signing ile dağıtılıyorsa, kullanıcıların telefonundaki kopyayı Google’ın sakladığı anahtar imzalar. assetlinks.json’da yalnızca sizin upload key’inizin parmak izi varsa doğrulama başarısız olur. Play App Signing anahtarının parmak izini de dosyaya eklemeniz gerekir.

Durumu görmek için geliştiriciniz telefon bilgisayara bağlıyken adb shell pm get-app-links komutunu paket adıyla çalıştırabilir. Çıktı, her alan adının doğrulanıp doğrulanmadığını gösterir.

ÖrnekDoğrulama durumunu görme
adb shell pm get-app-links com.example.app
Devamını okuyunAndroid App Links Doğrulanmıyor: adb ile Beş Dakikalık TeşhisDoğrulamanın neden başarısız olduğunu adb çıktısından okuyun ve düzeltin.
  • assetlinks.json

    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.

  • Universal Links

    Universal Links, Apple’ın iOS 9’dan beri sunduğu ve sıradan bir https adresinin iPhone’da doğrudan uygulamayı açmasını sağlayan sistemdir. Uygulama yüklüyse link uygulamayı ilgili ekranda açar; yüklü değilse aynı adres Safari’de web sitenizi gösterir. Çalışması için uygulamada Associated Domains ayarı, alan adında da apple-app-site-association dosyası gerekir.

  • Intent URL

    Intent URL, Android’de Chrome’un anladığı ve intent:// ile başlayan bir link biçimidir. İçinde uygulamanın şeması, paket adı ve isteğe bağlı bir web adresi bulunur. Uygulama yüklüyse Chrome onu açar; değilse belirttiğiniz web sayfasına ya da uygulamanın Google Play sayfasına gider. Çıplak şema linkinin “dokundum, hiçbir şey olmadı” sorununu böyle çözer.

Tüm terimler

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.