Документация
Интеграция SDK

Поддержка Universal Links

Система iOS требует защищенного соединения между приложением и связанными с ним доменами. Чтобы установить такое соединение, AppMetrica помещает файл apple-app-site-association на свой домен. Файл содержит Bundle ID и App Prefix приложения.

Настройка Universal Link

Чтобы активировать Universal Links для вашего приложения, в веб-интерфейсе AppMetrica выполните следующие действия:

  1. Перейдите в раздел Приложения.
  2. Выбрав приложение, перейдите в раздел Настройки.
  3. Откройте вкладку Основное и введите Bundle ID и App Prefix приложения в соответствующие поля.

    Как получить Bundle ID
    Значение Bundle ID можно найти в консоли разработчика Apple, в разделе Organization ProfileAccount Summary, а также в Xcode, в разделе TargetGeneral.
    Как получить App Prefix

    Значение App Prefix можно найти в консоли разработчика Apple. В большинстве случаев App Prefix совпадает с Team ID. Этот идентификатор доступен также в консоли разработчика Apple (в разделе Member Center нажмите на свое имя в правом верхнем углу окна и выберите View AccountDeveloper Account Summary).

  4. Установите переключатель Использовать Universal Link в положение Вкл. и нажмите Сохранить настройки. После этого в поле Universal Link появится ссылка вида applinks:<app_id>.redirect.appmetrica.yandex.com, где <app_id> — идентификатор вашего приложения в AppMetrica (ID приложения).

Подготовка приложения

Если ваше приложение уже зарегистрировано в Центре Разработчиков Apple, в консоли разработчика необходимо включить Associated Domains для идентификатора приложения:

  1. Перейдите в раздел IdentifiersApp IDs.
  2. Выбрав приложение, включите опцию Associated Domains для столбцов Development и Distribution.
  3. Сгенерируйте файлы инициализации для приложения, загрузите и установите их.

Настройка приложения

В интерфейсе Xcode выполните следующие действия:

  1. Выберите target приложения.
  2. В разделе Capabilities включите опцию Associated Domains.
  3. В поле Domains введите Universal Link, сгенерированный AppMetrica.

Варианты использования Universal Links

AppMetrica предоставляет несколько вариантов использования Universal Links.

Использование трекинг-ссылки стандартного формата с подключенным deeplink

При переходе по трекинг-ссылке происходит перенаправление на сервис редиректов AppMetrica, независимо от того, установлено ли приложение на устройстве. Сервис редиректов перенаправляет пользователя на Universal Link.

В зависимости от обстоятельств происходит следующее:

  • запуск приложения, если оно установлено;
  • переход на страницу приложения в App Store, если оно не установлено.
Достоинства
  • Полнота информации. Вы всегда сможете отследить переход по трекинг-ссылке.
  • Простота. Вам не придется менять трекинг-ссылки, ранее размещенные на рекламных площадках.
Недостатки
Приложение открывается по трекинг-ссылке только из браузера. При этом некоторые браузеры не поддерживают работу с редиректом на Universal Link. Если ссылка открыта не из браузера, пользователь будет перенаправлен в App Store, даже если приложение установлено.

Подробнее о настройке трекинг-ссылки см. в разделе Параметры tracking URL.

Использование прямой Universal Link

Прямая Universal Link имеет следующий формат:

https://<application_id>.redirect.appmetrica.yandex.com/?appmetrica_tracking_id=<tracking_id>

В зависимости от обстоятельств, при переходе по такой ссылке происходит следующее:

  • запуск приложения, если оно установлено;
  • переход на страницу приложения в App Store, если оно не установлено.
Достоинства
Максимальный охват источников, в которых можно размещать Universal Link. Прямые ссылки работают не только из браузеров, но и при рекламе в мобильных приложениях (app-to-app рекламе).
Недостатки
Статистика может быть не полной: если приложение установлено, то прямая ссылка откроет его без перехода на сервис редиректов. Такой переход по ссылке не будет зафиксирован в AppMetrica. Поскольку это не влияет на статистику по новым пользователям, потеря данных невелика. Если приложение не установлено, AppMetrica зафиксирует переход в App Store по прямой Universal Link.

Тестирование

Теперь ваше приложение полностью настроено, и вы можете использовать Universal Links. Пока для приложения включены Universal Links, при обращении к домену вида applinks:<app_id>.redirect.appmetrica.yandex.com, будет совершен переход напрямую в приложение.

Примечание. Проверить работу Universal Link можно только на реальном устройстве. В случае изменения Associated Domain, убедитесь в том, что приложение было переустановлено.

Если вместо приложения открывается Safari, переустановите приложение. Если проблема не устранена, добавьте еще одну строку Associated Domains в Xcode (таким образом он поменяется) и переустановите приложение.

Убедитесь, что ваша ссылка имеет тот же домен, что и в приложении.