Поддержка отложенных deeplinks
Это архивная версия документации. Актуальная документация по всем платформам находится здесь.
Отложенный deeplink используется для передачи параметров в приложение при первом запуске. Эти параметры могут быть использованы для действий внутри приложения (переход на определенный экран, показ определенного контента и т. д.) в зависимости от источника, который привел пользователя.
В отличие от обычного deeplink, отложенный deeplink срабатывает только при первом запуске приложения.
Принцип работы отложенных deeplinks
Общая схема работы отложенных deeplinks выглядит следующим образом:
- Пользователь нажимает на трекинговую ссылку, которая содержит параметры отложенного deeplink.
- Tracking URL направляет пользователя в магазин приложений для установки.
- Пользователь скачивает приложение.
- После первого запуска приложения параметры отложенного deeplink будут отправлены в приложение. Для получения параметров необходимо выполнить запрос.
Описание возможных ошибок
Интерфейсы DeferredDeeplinkListener и DeferredDeeplinkParametersListener содержат перечисления ошибок, которые могут возникнуть при запросе:
NOT_A_FIRST_LAUNCH
-
Параметры или отложенный deeplink не могут быть получены, так как метод запроса параметров был вызван не при первом запуске приложения.
Первый запуск приложения — это сессия работы процесса (среды исполнения, виртуальной машины), в течение которой пользователь впервые запрашивает параметры. Если deeplink присутствует на момент запроса, то синхронно в том же потоке выполнится вызов слушателя. При следующем запуске процесса библиотека уже не увидит отложенного deeplink и будет возвращена ошибка
NOT_A_FIRST_LAUNCH
. PARSE_ERROR
- В зависимости от интерфейса, ошибка означает следующее:
- если используется интерфейс DeferredDeeplinkListener — не удалось найти отложенный deeplink. Такое возможно в случае, если реферрер не содержал параметра
appmetrica_deep_link
; - если используется интерфейс DeferredDeeplinkParametersListener — отложенный deeplink не содержит валидных параметров.
Ошибка
PARSE_ERROR
будет возвращена, если не будет выполнено одно из следующих условий:INSTALL_REFERRER
должен содержать параметрappmetrica_deep_link
.- Значение параметра
appmetrica_deep_link
должно содержать валидный URI. - В deeplink URI должен быть как минимум один query-параметр.
Пример валидного deeplink:
sampleapp://samplepath?sampleparam1=samplevalue1
.Внимание. Максимальное количество символов, которое можно передать в параметрах отложенного deeplink — 7475.