Универсальные ссылки
Универсальные ссылки позволяют открывать ссылки, которые отправляются в Email-рассылках через Mindbox, непосредственно в мобильном приложении без перенаправления на сайт. Данная инструкция описывает необходимые действия для работы универсальных ссылок
Для корректной работы универсальных ссылок и сбора статистики по кликам
- у всех ваших пользователей должно быть установлено приложение с SDK mindbox
- на каждом домене и поддомене вашего сайта установлен JS трекер и файл ассоциации iOS/Android
- в приложении настроена поддержка универсальных ссылок
Добавление и инициализация SDK
Если у вас уже есть интеграция с SDK, эти пункты выполнять не нужно
Для iOS
- Настройка точек интеграции
- Добавление SDK мобильных приложений в приложение
- Инициализация SDK мобильных приложений
Для React Native, Expo и Flutter
Для Android и Huawei
- Настройка точек интеграции
- Добавление SDK мобильных приложений в приложение
- Инициализация SDK мобильных приложений
Настройка JS трекера
Для корректного отслеживания кликов необходимо добавить JS трекер на каждом домене и поддомене, ссылки на которые будут обрабатываться, как универсальные
Настройка поддержки универсальных ссылок
iOS
1. Поддержка связанных доменов
Создайте связь между приложением и веб-сайтом и укажите URL-адреса, которые обрабатывает ваше приложение, как описано в инструкции Apple - Поддержка связанных доменов
Обратите внимание, что каждый домен и поддомен, используемый для универсальных ссылок, должен иметь файл Apple App Site Association (AASA) в подкаталоге .well-known. Файл должен быть доступен через HTTPS без каких-либо перенаправлений — по адресу https://<domain>/.well-known/apple-app-site-association.
2. Поддержка универсальных ссылок в приложении
Передайте переход по универсальной ссылке в Mindbox. Тогда визит уйдет с источником link и адресом ссылки, а не как обычный запуск приложения (direct). Шаги одинаковые для нативных приложений, React Native и Flutter: вызовы добавляют в нативный iOS-код приложения. В Expo код не нужен — подробнее в разделе Flutter, React Native, Expo.
Куда iOS передает переход, зависит от жизненного цикла приложения:
- Приложение со сценами: в
Info.plistестьUIApplicationSceneManifest. Так создаются новые проекты в Xcode с интерфейсом Storyboard, Flutter 3.41 и новее, React Native 0.88 и новее. Переход приходит вSceneDelegate: при холодном старте — вscene(_:willConnectTo:options:), в запущенное приложение — вscene(_:continue:). Это основной вариант. - Приложение без сцен: переход приходит в
AppDelegate, в методapplication(_:continue:restorationHandler:). С iOS 26 Apple отмечает его как устаревший. Когда приложение перейдет на сцены, перенесите вызов Mindbox вSceneDelegate.
Подробнее о жизненном цикле — в документации Apple: Поддержка универсальных ссылок в вашем приложении. Инициализация SDK, push-уведомления, APNs-токен и фоновые задачи остаются в AppDelegate в обоих случаях.
Code
Flutter, React Native, Expo
- Flutter. Шаблон Flutter уже создает
SceneDelegate— наследникаFlutterSceneDelegate. Добавьте в него оба метода сoverrideи вызовомsuper, иначе плагины Flutter не получат события сцены. В приложении без сценMindboxFlutterAppDelegateпередает переходы сам. - React Native. В шаблоне React Native 0.88 и новее
SceneDelegateуже передает ссылки вRCTLinkingManager. Добавьте вызовы Mindbox рядом и не удаляйтеRCTLinkingManager: без него JavaScript-код не получит ссылку. - Expo, iOS. Код не нужен: плагин
mindbox-expo-pluginверсии 1.0.6 и выше (выйдет в IV квартале 2026 года) сам передает переходы в Mindbox, в том числе в приложениях со сценами. Связанные домены укажите вapp.json, в параметреios.associatedDomains.
MindboxSceneDelegate во Flutter и React Native не подходит: их SceneDelegate наследует другой класс.
Android и Huawei
1. Добавить intent-filter
В манифест добавить intent-filter, содержащий атрибут autoVerify="true". Пример фильтра:
Code
Если в приложении каждый экран - отдельная активити - то можно для каждой указать свой intent-filter. Тогда определенная ссылка будет открывать определенную активити.
2. Указать связь между сайтом и intent-filter
На сайт необходимо положить файл https://domain.name/.well-known/assetlinks.json. Пример файла:
Code
Настройка на проекте Mindbox
Указать домен и поддомены, на которых расположены универсальные ссылки:
