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

Внимание.

Это архивная версия документации. Актуальная документация по всем платформам находится здесь.

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

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

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

Принцип работы отложенных 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.

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