Поддержка Universal Links

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

Примечание. Начиная с версии iOS 12.3.1 и выше, сервис редиректов не сможет отправить пользователя на deeplink. Для корректной работы deeplink используйте app‑to‑app трекинг-ссылку (см. Использование прямой Universal Link).
  1. Настройка Universal Link
  2. Подготовка приложения
  3. Настройка приложения
  4. Использование прямой Universal Link
  5. Тестирование

Настройка Universal Link

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

  1. Перейдите в раздел Приложения.
  2. Выбрав приложение, перейдите в раздел Настройки.

  3. Откройте вкладку Основное и введите Bundle ID и App Prefix приложения в соответствующие поля.

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

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

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

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

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

  1. Перейдите в раздел Identifiers → App IDs.
  2. Выбрав приложение, включите опцию Associated Domains для столбцов Development и Distribution.

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

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

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

Использование прямой 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 (таким образом он поменяется) и переустановите приложение.

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

Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.