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

Поддержка отложенных deeplinks

Отложенный deeplink используется для передачи параметров в приложение при первом запуске. Эти параметры могут быть использованы для действий внутри приложения (переход на определенный экран, показ определенного контента и т. д.) в зависимости от источника, который привел пользователя.

В отличие от обычного deeplink, отложенный deeplink срабатывает только при первом запуске приложения.

Примечание. Отложенные deeplinks поддерживаются только на устройствах с системой Android.

Принцип работы отложенных deeplinks

Общая схема работы отложенных deeplinks выглядит следующим образом:

  • Пользователь нажимает на трекинговую ссылку, которая содержит параметры отложенного deeplink.
  • Tracking URL направляет пользователя в магазин приложений для установки.
  • Пользователь скачивает приложение.
  • После первого запуска приложения параметры отложенного deeplink будут отправлены в приложение. Для получения параметров необходимо выполнить запрос.

Описание возможных ошибок

Интерфейс DeferredDeeplinkParametersListener содержит перечисление ошибок, которые могут возникнуть при запросе параметров отложенного deeplink методом onParametersLoaded(Map<String, String> parameters):

NOT_A_FIRST_LAUNCH

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

Первый запуск приложения — это сессия работы процесса (среды исполнения, виртуальной машины), в течение которой пользователь впервые запрашивает параметры. Если deeplink присутствует на момент запроса, то синхронно в том же потоке выполнится вызов слушателя. При следующем запуске процесса библиотека уже не увидит отложенного deeplink и будет возвращена ошибка NOT_A_FIRST_LAUNCH.

PARSE_ERROR

Отложенный deeplink не содержит валидных параметров.

Ошибка PARSE_ERROR будет возвращена, если не будет выполнено одно из следующих условий:

  • INSTALL_REFERRER должен содержать параметр appmetrica_deep_link.
  • Значение параметра appmetrica_deep_link должно содержать валидный URI.
  • В deeplink URI должен быть как минимум один query-параметр.

Пример валидного deeplink: sampleapp://samplepath?sampleparam1=samplevalue1.

Внимание! Максимальное количество символов, которое можно передать в параметрах отложенного deeplink — 7475.