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

Мы запустили Firebase Dynamic Links более 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 Dynamic Links (как размещенные на пользовательских доменах, так и на поддоменах page.link), перестанут работать, и вы больше не сможете создавать новые ссылки.

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

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

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

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

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

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

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

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

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

После прекращения поддержки 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.

  • Вышеуказанные ответы об ошибках начнут постепенно поступать с 25 августа 2025 года, пока в конечном итоге не достигнут 100% уровня ответов об ошибках после истечения срока действия.

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

    iOS

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

    укоротить (Swift)

    shortenUrl (Swift)

    shortenWithCompletion (Objective-C)

    403 Возникает ошибка с указанием причины сбоя. Нет*
    Первая открытая атрибуция

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

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

    handleUniversalLink (Swift)

    handleUniversalLink (Objective-C)

    400 Возникает ошибка с указанием причины сбоя. Нет*

    Андроид

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

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

    403 Возникает ошибка с указанием причины сбоя. Нет*
    Первая открытая атрибуция

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

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

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

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

Как мне мигрировать из сервиса?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ознакомьтесь с полным списком действий , на которые повлияет это изменение.

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

Инструкции по выполнению миграции вы можете найти в руководствах, ссылки на которые приведены ниже:

Ознакомьтесь с полным списком действий , на которые это влияет.

Как это влияет на реализации потока OAuth с версиями Firebase Authentication Android SDK ниже 20.0.0 или версиями BoM ниже 26.0.0?

Вам потребуется обновить Firebase Authentication Android SDK до последней версии (не ниже v20.0.0), чтобы продолжить использовать реализацию потока OAuth в ваших приложениях Android.

Влияют ли эти изменения на действия по электронной почте для аутентификации Firebase в веб-приложениях?

Нет. Устаревание Firebase Dynamic Link влияет только на обработку входящих URL-адресов на мобильных устройствах.

Как это влияет на реализации, использующие библиотеки Firebase JS SDK для аутентификации поставщиков OAuth в приложении Cordova?

Firebase JS SDK использует Firebase Dynamic Links для реализации потоков аутентификации OAuth в приложениях Cordova. Вам потребуется изменить реализацию потока, вручную выполнив поток OAuth и передав полученные учётные данные OAuth в Firebase для завершения процесса аутентификации.

Более подробную информацию см. в путеводителе по Кордове .

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