Appy

Диплинки

Что такое Universal Links?

Коротко

Universal Links — обычные https-ссылки, которые на iPhone и iPad открывают установленное приложение вместо сайта. Apple ввела их в iOS 9. Нужны две части: entitlement Associated Domains в приложении (applinks:example.com) и файл apple-app-site-association на домене. Если приложения нет, по той же ссылке откроется сайт.

https://example.com/p/42iOSapple-app-site-associationЭкран товараПриложение установленоСайтПриложения нет
CDN Apple доставляет на iPhone файл apple-app-site-association. После этого нажатие открывает приложение, если оно установлено, и сайт, если нет.

Как это работает

При установке или обновлении приложения iOS читает домены из Associated Domains и получает файл apple-app-site-association — не напрямую с вашего сервера, а через CDN Apple. Затем система сверяет ID приложения и правила путей. Из-за кэша CDN правка файла доходит до устройств не сразу.

Сама ссылка при этом остаётся обычным https-адресом. Её можно ставить в письма, рекламу и QR-коды: у кого приложение есть, откроется нужный экран, у кого нет — та же страница на сайте.

Почему иногда открывается сайт

Если вставить адрес в строку Safari и перейти, откроется сайт. Если нажать на ссылку на тот же домен, на котором человек уже находится, — тоже сайт. Многие встроенные браузеры соцсетей вовсе не открывают приложение по Universal Links, и человек остаётся внутри приложения-хоста.

Проверить, что видит Apple, можно бесплатным валидатором Appy: он показывает и сам файл, и его копию в CDN Apple.

ПримерЗапись в Associated Domains
applinks:example.com
ПодробнееПолное руководство по Universal Links для iOS и AndroidНастройка Universal Links и App Links, файлы ассоциации и типичные ошибки.
  • Файл apple-app-site-association (AASA)

    apple-app-site-association (AASA) — JSON-файл по адресу https://<домен>/.well-known/apple-app-site-association, который подтверждает, что домен связан с вашим приложением. В нём перечислены ID приложений (Team ID и bundle ID) и пути, которые должны открываться в приложении. Без этого файла Universal Links не работают, и ссылки домена просто открывают сайт.

  • Android App Links

    Android App Links — https-ссылки, которые Android, начиная с версии 6.0, открывает сразу в приложении, без окна «Открыть с помощью». Для этого домен подтверждает связь с приложением: в манифесте стоит intent filter с android:autoVerify="true", а на сайте лежит assetlinks.json с именем пакета и SHA-256-отпечатками сертификата подписи.

  • Встроенный браузер (in-app browser)

    Встроенный браузер (in-app browser) — браузер внутри Instagram, TikTok, Facebook, LinkedIn и других приложений. Ссылка открывается прямо в нём, и человек остаётся в приложении-хосте. Из-за этого Universal Links и App Links часто не срабатывают: вместо вашего приложения открывается сайт, даже если приложение установлено.

Все термины глоссария

Одна ссылка на App Store, Google Play и сайт

На бесплатном тарифе Appy — 4 ссылки с QR-кодами. Каждый телефон попадает в свой магазин: App Store, Google Play, AppGallery, Galaxy Store или GetApps, а компьютер — на сайт. Без рекламы и без банковской карты.