Що ви налаштуєте
- Завантажте файли Apple App Site Association та Android Asset Links, щоб Elido автоматично обслуговував їх на вашому власному домені.
- Налаштуйте конфігурацію iOS та Android для кожного посилання — App ID, шлях у додатку та fallback URL — щоб кліки відкривали потрібний екран або перенаправляли до магазину.
- Вимірюйте частоту відкриттів додатка (app-open rate) по кожній платформі на вкладці Analytics → Deep linking посилання.
Глибокі посилання (deep links) відкривають нативні додатки безпосередньо з короткої URL-адреси. Якщо у відвідувача встановлено ваш додаток, посилання відкриває потрібний екран всередині додатка. Якщо ні — відбувається перехід до App Store (iOS) чи Play Store (Android) — або до будь-якої іншої налаштованої вами URL-адреси.
Що вам знадобиться#
Для використання глибоких посилань вам потрібно:
- Додаток для iOS із налаштованими Universal Links, АБО
- Додаток для Android із налаштованими App Links, АБО
- Власні URI-схеми (
myapp://), якщо у вас ще немає Universal Links чи App Links.
Для Universal Links та App Links вам також потрібно буде опублікувати файли асоціації (apple-app-site-association для iOS, assetlinks.json для Android) на вашому власному домені. Elido обслуговує їх автоматично, як тільки ви завантажите файл у Settings → Domains → Deep linking.
Налаштування глибоких посилань для посилання#
- Відкрийте сторінку деталей посилання → Targeting → Deep linking.
- Увімкніть перемикач deep linking.
- Додайте конфігурацію iOS:
- App ID — наприклад,
K72L8M4N9P.com.acme.myapp(Team ID + bundle identifier з вашого акаунта Apple Developer). - In-app path — куди додаток має спрямувати користувача. Шлях додається до хоста вашого Universal Link; SDK у додатку зчитує його з URL-адреси запуску.
- Fallback URL — куди відправляти відвідувачів, у яких не встановлено додаток. Зазвичай це сторінка вашого додатка в App Store.
- App ID — наприклад,
- Додайте конфігурацію Android:
- Package name — наприклад,
com.acme.myapp. - In-app path — та сама логіка, що й для iOS.
- Fallback URL — зазвичай URL-адреса в Play Store із назвою вашого пакета.
- Package name — наприклад,
- Save. Тепер посилання буде виконувати маршрутизацію на основі пристрою при кожному кліку.
Що відбувається в момент кліку#
Обробник перенаправлення повертає проміжну сторінку (HTML interstitial), яка виконує JavaScript протягом приблизно 50 мс. Ця сторінка:
- Визначає iOS, Android чи десктоп.
- На iOS: намагається відкрити через Universal Link. Якщо ОС відкриває додаток — готово.
- На Android: те саме з App Links.
- Якщо через 1,2 секунди додаток не відкрився, сторінка перенаправляє на fallback URL.
Відвідувачі з десктопів завжди потрапляють безпосередньо на fallback URL — там немає додатка для відкриття.
Якщо відвідувач використовує невідому платформу (web view у WeChat тощо), посилання перенаправляє на десктопний пункт призначення. Ви можете змінити це за допомогою правил смарт-посилань (smart-link rules).
Fallback через URI-схему#
Якщо у вас не налаштовані Universal Links / App Links, ви все одно можете використовувати власну URI-схему:
- iOS scheme:
myapp:// - Android scheme:
myapp://
Проміжна сторінка спробує відкрити схему та перенаправить до App Store / Play Store через 1,2 секунди. Недоліком є те, що ОС показує запит «Відкрити в My App?» при першому запуску, чого Universal Links дозволяють уникнути.
Аналітика#
Кожен клік реєструє, чи було відкрито додаток, чи використано fallback. Вкладка Analytics → Deep linking для посилання показує частоту відкриттів (open-rate) для кожної платформи — це корисно для оцінки того, наскільки добре працюють ваші файли асоціації.
Обмеження#
- Одна конфігурація iOS та одна конфігурація Android на одне посилання.
- Deep linking доступний на тарифах Pro та Business; безкоштовний план підтримує лише прямі перенаправлення.
Поширені проблеми#
Universal Links працюють на реальному пристрої, але не в симуляторі. Це очікувано — симулятор Apple не може отримати файл AASA. Тестуйте на реальному телефоні.
Fallback URL відкривається раніше, ніж додаток навіть намагається запуститися. Деякі браузери на Android (зокрема Samsung Internet) перехоплюють схему раніше, ніж її побачить ОС. Переконайтеся, що налаштування App Links завершено: домен підтверджено, назва пакета правильна, відбиток SHA-256 збігається.
iOS іноді показує банер замість відкриття додатка. Це «Open in Safari → Smart Banner» в iOS сприймає сторінку як звичайний сайт. Повторне завантаження файлу AASA з правильним App ID зазвичай вирішує проблему.
Посилання відкриває додаток, але потім відображається не той екран. Ваша внутрішня маршрутизація в додатку не відповідає шляху, який передає Elido. Логуйте URL запуску всередині вашого додатка, щоб підтвердити, що саме ви отримуєте, а потім оновіть конфігурацію шляху відповідним чином.