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

Мы запустили 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 (Котлин)

    buildShortDynamicLink (Java)

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

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

    getDynamicLink(getIntent()) (Java)

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

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

    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 и других подобных поставщиков на рынке. (Обратите внимание, что эти поставщики не были проверены Google, но предоставляют аналогичную Firebase Dynamic Links функциональность).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вы можете использовать API аналитики динамических ссылок Firebase для получения данных статистики ссылок для каждой из ваших динамических ссылок Firebase. Этот API аналитики ограничен ~5 QPS. Для примера того, как работать в пределах этого лимита запросов при использовании 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 ниже v20.0.0 или версиями BoM ниже 26.0.0?

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

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

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

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

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

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

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