Поддержка отложенных 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

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

Написать в службу поддержки