Mindbox
Мобильные приложения

Универсальные ссылки

Универсальные ссылки позволяют открывать ссылки, которые отправляются в Email-рассылках через Mindbox, непосредственно в мобильном приложении без перенаправления на сайт. Данная инструкция описывает необходимые действия для работы универсальных ссылок

Для корректной работы универсальных ссылок и сбора статистики по кликам

  • у всех ваших пользователей должно быть установлено приложение с SDK mindbox
  • на каждом домене и поддомене вашего сайта установлен JS трекер и файл ассоциации iOS/Android
  • в приложении настроена поддержка универсальных ссылок

Добавление и инициализация SDK

Если у вас уже есть интеграция с SDK, эти пункты выполнять не нужно

Для iOS

  1. Настройка точек интеграции
  2. Добавление SDK мобильных приложений в приложение
  3. Инициализация SDK мобильных приложений

Для React Native, Expo и Flutter

Для Android и Huawei

  1. Настройка точек интеграции
  2. Добавление SDK мобильных приложений в приложение
  3. Инициализация 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 в обоих случаях.

SwiftCode
import UIKit import Mindbox final class SceneDelegate: UIResponder, UIWindowSceneDelegate { var window: UIWindow? func scene( _ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions ) { // Set up `windowScene` and `window` here. Mindbox.shared.track(.launchScene(connectionOptions)) // Handle Universal Link on a cold start: // The app was launched from a URL (not already running). // Read the link from `connectionOptions.userActivities` and route to the right screen. } func scene(_ scene: UIScene, continue userActivity: NSUserActivity) { Mindbox.shared.track(.universalLink(userActivity)) // Handle Universal Link on a warm start: // The app is already running (foreground or background) and receives a new URL. // Use `scene(_:continue:)` to parse and route the link. } }

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
<activity … > … <intent-filter android:autoVerify="true"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="https" android:host="domain1.com" android:pathPrefix="/foo"/> </intent-filter> … </activity>

Если в приложении каждый экран - отдельная активити - то можно для каждой указать свой intent-filter. Тогда определенная ссылка будет открывать определенную активити.

2. Указать связь между сайтом и intent-filter

Документация

На сайт необходимо положить файл https://domain.name/.well-known/assetlinks.json. Пример файла:

JSONCode
[{ "relation": ["delegate_permission/common.handle_all_urls"], "target": { "namespace": "android_app", "package_name": "com.example", "sha256_cert_fingerprints": ["<ключ сертификата>"] } }]

Настройка на проекте Mindbox

Указать домен и поддомены, на которых расположены универсальные ссылки:

Инструкция на help.mindbox.ru
Last modified on