Часто задаваемые вопросы об устаревании динамических ссылок

Мы запустили динамические ссылки Firebase более 7 лет назад, чтобы сделать URL-адреса более мощными — например, динамически меняя место назначения ссылки в зависимости от условий времени выполнения.

За прошедшие годы веб- и мобильные экосистемы развивались благодаря таким технологиям, как App Links , Google Play Instant , Universal Links и App Clips , и сделали перемещение пользователей между приложениями и Интернетом более плавным и предсказуемым для пользователей ваших приложений. Мы считаем, что вы и ваши пользователи выиграете больше от непосредственного внедрения этих технологий и дальнейшего развития экосистемы. Однако наряду с этими новыми изменениями исходные собственные API, на которых были созданы Firebase Dynamic Links, также развивались и создавали новые проблемы.

Например, изменения в экосистеме повлияли на нашу способность обеспечивать стабильную работу одной из основных функций Firebase Dynamic Links — предоставления пользователям приложений плавного перехода к приложению после установки, независимо от платформы.

Вместо того, чтобы продолжать поддерживать далеко не идеальный опыт, мы решили прекратить использование Firebase Dynamic Links и переориентировать наши ресурсы на решение других проблем разработчиков.

Мы понимаем, что это изменение потребует вашего времени для оценки и принятия альтернативных решений или поставщиков платформ на рынке.

Мы продолжаем развивать Firebase, чтобы удовлетворить ваши потребности, поскольку экосистема продолжает развиваться и меняться. Мы продолжим внедрять новые функции и обновления для продуктов Firebase и стремимся помочь вам добиться успеха в разработке приложений.

Что мне нужно знать?

25 августа 2025 г. Firebase Dynamic Links прекратит работу. Все ссылки, обслуживаемые динамическими ссылками Firebase (как размещенные в пользовательских доменах, так и в поддоменах page.link), перестанут работать, и вы больше не сможете создавать новые ссылки.

Чтобы помочь вам решить, как перейти с Firebase Dynamic Links, мы продолжим обновлять этот документ часто задаваемых вопросов, добавляя дополнительную информацию, которую вы можете принять во внимание, а также предоставлять руководства по миграции для различных сценариев миграции, которые могут соответствовать тому, как вы используете Firebase Dynamic Links сегодня.

Мы также продолжим обновлять это руководство, добавляя больше часто задаваемых вопросов по мере того, как прекращение поддержки приближается к дате прекращения поддержки 25 августа 2025 года, и мы обнаруживаем любые дополнительные проблемы, помогая вам в ваших усилиях по миграции.

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

Чтобы начать миграцию, ознакомьтесь с часто задаваемыми вопросами «Как мне перейти с сервиса» ниже.

25 августа 2025 г. Firebase Dynamic Links прекратит работу. Все ссылки, обслуживаемые динамическими ссылками Firebase (как размещенные в личных доменах, так и в поддоменах page.link), перестанут работать.

Сколько времени мне понадобится на миграцию?

У вас есть время до 25 августа 2025 г., чтобы завершить миграцию.

Да, ваши новые и существующие ссылки будут работать до тех пор, пока служба динамических ссылок не будет отключена 25 августа 2025 г.

Когда Firebase Dynamic Links будет отключена, вы можете ожидать, что:

  • Все нажатые ссылки вернут конечным пользователям ответ о состоянии HTTP 404.
  • Все HTTP-запросы к:

    • https://firebasedynamiclinks.googleapis.com/v1/shortLinks (API коротких ссылок)
    • https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (API статистики ссылок)

    вернет ответ состояния HTTP 400/403.

  • Следующее поведение зависит от версии платформы SDK и вызова API, выполненного в вашем приложении:

    iOS

    Вариант использования вызов API Код состояния Поведение Ваше приложение выйдет из строя?
    Создать короткую ссылку

    сократить (быстро)

    сократить URL (Swift)

    ShortenWithCompletion (Objective-C)

    400 Выдается ошибка с причиной сбоя Нет*
    Первая открытая атрибуция

    Вызывается автоматически в FirebaseApp.configure (Swift) /FIRApp.configure (Objective-C).

    400 Ошибок не возникает, но объект FDL отправляется обратно с пустыми данными. Нет*
    Повторно открыть атрибуцию

    handleUniversalLink (Свифт)

    handleUniversalLink (Objective-C)

    400 Выдается ошибка с причиной сбоя Нет*

    Андроид

    Вариант использования вызов API Код состояния Поведение Ваше приложение выйдет из строя?
    Создать короткую ссылку

    buildShortDynamicLink (Котлин)

    buildShortDynamicLink (Java)

    400 Выдается ошибка с причиной сбоя Нет*
    Первая открытая атрибуция

    getDynamicLink(getIntent()) (Котлин)

    getDynamicLink(getIntent()) (Java)

    400 Задача возвращает ответ об успехе, но данные FDL будут пустыми. Нет*
    Повторно открыть атрибуцию

    getDynamicLink(getIntent()) (Котлин)

    getDynamicLink(getIntent()) (Java)

    400 Задача возвращает ответ об успехе, но данные FDL будут пустыми. Нет*
    Принять приглашение Модуль AppInvite в Сервисах Google Play, вызываемый при обработке перенаправления намерений (из *.page.link или пользовательского домена) 400 Показывает счетчик при вызове сервисов Google Play и исчезает, когда возвращается ответ 400. Нет*

Как мне перейти с сервиса?

Мы обнаружили, что у разных разработчиков разные потребности в использовании динамических ссылок Firebase.

В зависимости от ваших собственных вариантов использования и оценки использования Firebase Dynamic Links, скорее всего, один из приведенных ниже сценариев будет соответствовать вашим потребностям.

В этом сценарии мы рекомендуем вам использовать других поставщиков/поставщиков услуг глубоких ссылок, таких как Adjust, AppsFlyer, Bitly, Branch, Kochava и других подобных поставщиков на рынке. (Обратите внимание, что эти провайдеры не были проверены Google, но предоставляют аналогичные функции, что и Firebase Dynamic Links).

Вы также можете экспортировать метаданные внешних ссылок , что облегчит перенос ссылок на любого выбранного вами поставщика.

Чтобы найти поставщика с функциями, соответствующими Firebase Dynamic Links, обратитесь к следующему списку функций ниже.

Возможности динамических ссылок Firebase:

  • Направляет пользователей в магазин, соответствующий их устройству, одним щелчком мыши (и при необходимости возвращается на веб-страницу).
  • Предоставляет пользователям возможность продолжить путешествие после загрузки и установки вашего приложения. Просмотр отложенной глубокой ссылки.
  • Предоставляет пользователям контекстуальный опыт через контент с глубокими ссылками в вашем приложении (если оно уже установлено).
  • Предоставляет аналитические данные, связанные с событиями щелчков по динамическим ссылкам.
  • Предоставляет возможность создавать URL-адреса с короткими ссылками.
  • Предоставляет возможность добавлять метаданные к ссылкам для обмена в социальных сетях.

Что, если меня интересует глубокая ссылка на мое приложение только после того, как оно уже установлено?

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

Ознакомьтесь с этим руководством для получения более подробной информации о том, как перейти на использование App Links и Universal Links .

В этом руководстве также описывается, как дополнительно использовать хостинг Firebase для размещения необходимых файлов проверки домена и ссылок на ресурсы в домене, который вы планируете использовать для своих новых ссылок (например, файл assetslinks.json для ссылок на приложения, файл apple-app-site-association для универсальные ссылки).

В этом сценарии вам может не потребоваться предпринимать какие-либо действия в приложении для обработки предстоящего заката, однако мы рекомендуем:

  • Проверка существующих динамических ссылок Firebase в соответствии с руководством по экспорту метаданных ссылок , чтобы гарантировать, что ваши пользователи и приложение не пострадают, когда ссылки перестанут обслуживаться.

  • Удаление префиксов URL-адресов динамических ссылок Firebase в консоли Firebase . Примечание. Домены с префиксами URL-адресов будут автоматически удалены после 25 августа 2025 г.

  • Удаление Firebase Dynamic Links SDK из ваших приложений.

Если вы видите сценарий миграции, который не соответствует вашим потребностям, сообщите нам об этом.

API-интерфейсы Firebase Dynamic Links для коротких ссылок и аналитики будут доступны до истечения срока действия 25 августа 2025 года.

После этой даты эти API больше не будут доступны для использования, и служба будет закрыта .

Инструкции по экспорту метаданных ссылок см. в руководстве по экспорту метаданных ссылок.

Вы можете использовать руководство по экспорту , чтобы получить метаданные динамических ссылок Firebase, включая саму ссылку.

Вы можете использовать API Firebase Dynamic Links Analytics для получения данных статистики ссылок для каждой из ваших динамических ссылок Firebase. Этот API аналитики ограничен примерно 5 запросами в секунду. Пример того, как действовать в пределах этого лимита запросов при использовании API, см. в этом образце облачной задачи .

Вы также можете использовать Google Analytics и экспортировать свои данные для подмножества данных анализа ссылок, включая события обновления приложений, которые являются уникальными для Google Analytics.

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

Метаданные вашего домена и ссылок будут помечены для удаления 25 августа 2025 г. и удалены в соответствии с нашей политикой хранения данных .

Да, аутентификация по вашей ссылке электронной почты с использованием Firebase Authentication продолжит работать.

В настоящее время служба аутентификации Firebase использует динамические ссылки Firebase для настройки ссылок аутентификации, но мы предоставим обновление, чтобы эта функция продолжала работать после закрытия службы динамических ссылок Firebase.

Обратите внимание, что это продолжение функциональности отделено от использования динамических ссылок Firebase для основных случаев использования маршрутизации магазинов и веб-страниц, отложенных и обычных глубоких ссылок, которые будут устаревшими в соответствии с графиком миграции, указанным выше.

Ознакомьтесь с часто задаваемыми вопросами «Как мне выполнить миграцию из службы» , в которых подробно описаны различные сценарии миграции и представлены руководства по миграции для различных доступных альтернатив.