Поддержка Universal Links

Для версий iOS выше 12.3.1 диплинки в трекинг-ссылках не работают. Если вы попытаетесь использовать такую ссылку, система не сможет перенаправить вас в уже установленное приложение. Чтобы перенаправить пользователя в iOS приложение, настройте переход в него по технологии Universal Link.

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

Настройка Universal LinkНастройка 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

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

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

Ссылка такого формата будет автоматически генерироваться в настройках трекера после выполнения этой инструкции в поле App-to-app трекинг-ссылка.

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

• запуск приложения, если оно установлено;
• переход на страницу приложения в App Store, если оно не установлено.

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

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

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

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

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