Полное руководство по Universal Links

Что такое Universal Links?

Universal links — это URL, которые бесшовно работают между вебом и мобильными приложениями. Когда пользователь нажимает universal link на iOS-устройстве, система проверяет, установлено ли приложение, которое умеет обрабатывать такую ссылку. Если приложение установлено, открывается нужный контент в приложении. Если нет — ссылка открывается в Safari.

На Android аналогичная технология называется App Links. Концепция та же: один URL умно направляет пользователя либо в приложение, либо на сайт.

Как работают Universal Links

Процесс включает три ключевых компонента:

Реализация Universal Links на iOS

Шаг 1: Создайте AASA-файл

Создайте файл с именем apple-app-site-association (без расширения) со следующей структурой: apple-app-site-association

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "TEAMID.com.yourcompany.yourapp",
        "paths": [
          "/products/*",
          "/articles/*",
          "/user/*"
        ]
      }
    ]
  }
}

Шаг 2: Настройте iOS-приложение

В Xcode добавьте capability Associated Domains с вашим доменом:

applinks:yourdomain.com
applinks:www.yourdomain.com

Шаг 3: Обработайте URL в приложении

// AppDelegate.swift
func application(_ application: UIApplication,
                 continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    
    guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
          let url = userActivity.webpageURL else {
        return false
    }
    
    // Handle the URL and navigate to appropriate screen
    handleUniversalLink(url)
    return true
}

Реализация App Links на Android

Шаг 1: Создайте assetlinks.json

Разместите этот файл по адресу https://yourdomain.com/.well-known/assetlinks.json:

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.yourcompany.yourapp",
    "sha256_cert_fingerprints": [
      "XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX"
    ]
  }
}]

Шаг 2: Обновите AndroidManifest.xml

<activity android:name=".MainActivity">
    <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" />
        <data android:host="yourdomain.com" />
        <data android:pathPrefix="/products" />
    </intent-filter>
</activity>

Шаг 3: Обработайте Intent

// MainActivity.kt
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    
    val action = intent.action
    val data = intent.data
    
    if (Intent.ACTION_VIEW == action && data != null) {
        // Handle the deep link
        handleDeepLink(data)
    }
}

Лучшие практики и частые ошибки

Тестирование и отладка

Аналитика и атрибуция

Правильная аналитика критична для понимания эффективности universal links. Отслеживайте эти ключевые метрики:

• CTR из разных каналов
• Доля открытий приложения vs web fallback
• Стоимость привлечения по каналам
• Конверсия deep-linked контента
• Время до первого действия после deep link
• Производительность по платформам (iOS vs Android)

Вывод

Universal links — важная часть современных мобильных приложений. Они дают бесшовный UX, улучшают атрибуцию и надежно работают на разных платформах. Хотя внедрение требует внимания к деталям, преимущества в UX и аналитике стоят усилий.

Начните с базовой реализации, тщательно протестируйте и улучшайте решение по данным реальной эксплуатации. А если хотите избежать сложности — используйте Appy, который берет это на себя автоматически.