Мы запустили Firebase Dynamic Links более семи лет назад, чтобы расширить возможности URL, например динамически менять целевую страницу ссылки в зависимости от условий выполнения.
За последние годы экосистемы сайтов и мобильных приложений пополнились такими технологиями, как ссылки на приложения, Google Play Instant, универсальные ссылки и блиц-приложения. Благодаря им путь пользователя между приложениями и сайтами стал более удобным и предсказуемым. Мы считаем, что вы и ваши пользователи получите больше преимуществ, если будете напрямую внедрять эти технологии и продолжать развивать экосистему. Однако вместе с этими изменениями развивались и оригинальные нативные 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 г.) и выявления дополнительных проблем в процессе перехода.
Ниже приведены ответы на часто задаваемые вопросы.
Чтобы начать перенос, ознакомьтесь с разделом часто задаваемых вопросов Как перейти на другой сервис ниже.
Когда Firebase Dynamic Links перестанет работать?
25 августа 2025 г. поддержка Firebase Dynamic Links будет прекращена. Все ссылки, обслуживаемые Firebase Dynamic Links (как размещенные в собственных доменах, так и в субдоменах page.link), перестанут работать.
Сколько времени у меня будет на переход?
Переход нужно завершить до 25 августа 2025 года.
Будут ли работать новые и существующие ссылки?
Да, новые и существующие ссылки будут работать до 25 августа 2025 года, когда сервис Dynamic Links будет отключен.
Можно ли сохранить или перенести автоматически созданные домены .page.link, которые используются для ссылок?
Нет, после прекращения работы Firebase Dynamic Links все домены .page.link станут недоступны. Рекомендуем ознакомиться с этим списком вопросов, чтобы понять, как лучше всего перейти на другой сервис. Если вам нужен полный набор функций, следуйте этим инструкциям по экспорту метаданных и переходу на другой сервис ссылок на контент с использованием нового домена.
Что произойдет с моими ссылками и приложениями, когда поддержка Firebase Dynamic Links будет прекращена (25 августа 2025 г.)?
После прекращения поддержки Firebase Dynamic Links:
- При нажатии на любую ссылку конечные пользователи будут получать ответ со статусом HTTP 404.
Все HTTP-запросы к:
- https://firebasedynamiclinks.googleapis.com/v1/shortLinks (Short Links API)
- https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (Link Stats API)
будет возвращен ответ с кодом статуса HTTP 400/403.
Ошибки, описанные выше, начнут постепенно появляться с 25 августа 2025 года. После прекращения поддержки API версии 4 они будут возникать в 100 % случаев.
Поведение зависит от того, какая версия SDK и какой вызов API используются в приложении:
iOS
Вариант вызов API; Код статуса Поведение Будет ли приложение работать со сбоями? Создать короткую ссылку shorten (Swift)
shortenUrl (Swift)
shortenWithCompletion (Objective-C)
403 Ошибка с указанием причины сбоя. Нет* Атрибуция первого запуска Вызывается автоматически в FirebaseApp.configure (Swift)/FIRApp.configure (Objective-C).
400 Ошибки не возникают, но возвращается объект FDL с пустыми данными. Нет* Как снова открыть атрибуцию handleUniversalLink (Swift)
handleUniversalLink (Objective-C)
400 Ошибка с указанием причины сбоя. Нет* Android
Вариант вызов 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, который вызывается при обработке перенаправления intent (с *.page.link или собственного домена) 400 Показывает спиннер при вызове сервисов Google Play и исчезает при возврате ответа 400. Нет*
Как перейти на другой сервис?
Мы выяснили, что у разных разработчиков разные потребности в отношении Firebase Dynamic Links.
В зависимости от ваших сценариев использования и оценки Firebase Dynamic Links, вам может подойти один из вариантов ниже.
Что делать, если мне нужны все функции Firebase Dynamic Links?
В этом случае мы рекомендуем использовать других поставщиков ссылок на контент, например Adjust, Airbridge, AppsFlyer, Bitly, Branch, Kochava, Singular и т. д. Обратите внимание, что эти поставщики не были проверены Google, но предоставляют функции, аналогичные Firebase Dynamic Links.
Вы также можете экспортировать метаданные ссылок на контент, чтобы упростить перенос ссылок к выбранному поставщику.
Чтобы найти поставщика с функциями, аналогичными Firebase Dynamic Links, ознакомьтесь со списком ниже.
Функции Firebase Dynamic Links:
- Перенаправляет пользователей в нужный магазин приложений в зависимости от устройства (или на веб-страницу, если это необходимо).
- Позволяет пользователям продолжить работу после скачивания и установки приложения по отложенной ссылке на контент.
- Пользователи получают доступ к контенту в контексте благодаря ссылкам на контент в вашем приложении (если оно уже установлено).
- Предоставляет аналитические данные, связанные с событиями кликов по динамическим ссылкам.
- Позволяет создавать короткие URL.
- Позволяет добавлять метаданные в ссылки для публикации в социальных сетях.
Что, если мне нужны ссылки на контент в приложении только после того, как оно уже установлено?
В этом случае мы рекомендуем использовать ссылки на приложения и универсальные ссылки, которые поддерживаются платформами и позволяют разработчикам предоставлять пользователям ссылки на контент.
Подробную информацию о том, как перейти на ссылки на приложение и универсальные ссылки, вы найдете в этом руководстве.
В этом руководстве также описывается, как при необходимости использовать Firebase Hosting для размещения необходимых файлов подтверждения домена и связи объектов в домене, который вы планируете использовать для новых ссылок (например, файл assetlinks.json для ссылок на приложение, файл apple-app-site-association для универсальных ссылок).
Что делать, если моему приложению больше не нужны функции Firebase Dynamic Links и замена для них не требуется?
В этом случае вам, возможно, не потребуется ничего делать в приложении, чтобы подготовиться к прекращению поддержки. Однако мы рекомендуем:
Проверьте существующие Firebase Dynamic Links, следуя руководству по экспорту метаданных ссылок. Это позволит убедиться, что пользователи и приложение не пострадают, когда ссылки перестанут работать.
Удалите префиксы URL Firebase Dynamic Links в консоли Firebase. Примечание. Домены с префиксом в URL будут автоматически удалены после 25 августа 2025 г.
Удалите Firebase Dynamic Links SDK из своих приложений.
Если вы не нашли сценарий переноса, который подходит для вашей ситуации, сообщите нам об этом.
Что делать после переноса?
После того как вы завершите переход с Firebase Dynamic Links, удалите все префиксы доменов URL (домены FDL), связанные с Firebase Dynamic Links в вашем проекте.
Вот несколько приемов:
- Переход в раздел Firebase Dynamic Links в консоли Firebase
Выберите префикс URL, который нужно удалить, в меню слева.
Нажмите на значок меню в виде трех точек рядом с кнопкой "Новая динамическая ссылка".
Выбор варианта "Удалить префикс URL"
Введите префикс URL, чтобы подтвердить, что вы хотите его удалить, и нажмите "Удалить префикс URL".
После удаления всех префиксов доменов URL ваш проект Firebase будет помечен как перенесенный из Firebase Dynamic Links. После этого всплывающее напоминание в консоли Firebase для вашего проекта больше не будет показываться.
Обратите внимание, что после этого все ваши динамические ссылки Firebase будут удалены, поэтому перед удалением префиксов доменов URL убедитесь, что вы полностью перенесли данные из сервиса.
Смогу ли я по-прежнему использовать Firebase Dynamic Links API?
API Firebase Dynamic Links для коротких ссылок и Аналитики будут доступны до 25 августа 2025 года.
После этой даты API станут недоступны, а сервис будет закрыт.
Как экспортировать метаданные ссылок?
Инструкции по экспорту метаданных ссылок можно найти в руководстве по экспорту метаданных ссылок.
Как получить данные аналитики по ссылкам Firebase Dynamic Links?
Чтобы получить метаданные Firebase Dynamic Links, в том числе саму ссылку, воспользуйтесь руководством по экспорту.
Вы можете использовать Firebase Dynamic Links Analytics API, чтобы получать статистику по каждой динамической ссылке Firebase. Для этого API Аналитики установлено ограничение примерно в 5 запросов в секунду. Пример того, как работать в рамках этого ограничения при использовании API, можно найти в образце задачи Cloud.
Вы также можете использовать Google Аналитику и экспортировать подмножество данных аналитики ссылок, включая события обновления приложения, которые доступны только в Google Аналитике.
Если для переноса вам требуется более высокая частота запросов, обратитесь в службу поддержки Firebase.
Что произойдет с метаданными существующих ссылок после даты прекращения поддержки (25 августа 2025 г.)?
Метаданные вашего домена и ссылок будут помечены на удаление 25 августа 2025 г. и удалены в соответствии с нашими правилами хранения данных.
Как Firebase Dynamic Links влияет на процессы Firebase Authentication
Я хочу включить аутентификацию по ссылке в электронном письме в Firebase Authentication для своего проекта. Нужно ли мне настраивать Firebase Dynamic Links?
Нет, вам не нужно интегрировать Firebase Dynamic Links, так как интеграция больше невозможна. Вместо этого вы можете следовать обновленным руководствам по началу работы с аутентификацией по ссылке в электронном письме, чтобы включить и реализовать ее для своего проекта:
Ознакомьтесь с полным списком действий, которых коснутся эти изменения.
Как это повлияет на следующие функции аутентификации: аутентификацию по ссылке в электронном письме, сброс пароля и подтверждение адреса электронной почты?
Аутентификация по ссылке в электронном письме и действия с письмами вне диапазона в Firebase продолжат работать, но вам нужно будет перейти на последние версии Firebase Authentication SDK и новое решение, чтобы продолжить использовать эти действия после отключения сервиса Firebase Dynamic Links 25 августа 2025 года.
Чтобы выполнить перенос, следуйте инструкциям в руководствах по ссылкам ниже.
Ознакомьтесь с полным списком действий, на которые это влияет.
Как это повлияет на реализации OAuth с Firebase Authentication Android SDK версии ниже 20.0.0 или BoM версии ниже 26.0.0?
Чтобы продолжить использовать OAuth в приложениях для Android, обновите Firebase Authentication Android SDK до последней версии (не ниже 20.0.0).
Повлияет ли это на действия с электронной почтой в Firebase Authentication в веб-приложениях?
Нет. Прекращение поддержки Firebase Dynamic Links влияет только на обработку входящих URL на мобильных устройствах.
Как это изменение повлияет на реализации, в которых для аутентификации поставщиков OAuth в приложении Cordova используются библиотеки Firebase JS SDK?
Firebase JS SDK использует Firebase Dynamic Links для реализации потоков аутентификации OAuth в приложениях Cordova. Вам нужно будет изменить реализацию процесса, выполнив процесс OAuth вручную и передав полученные учетные данные OAuth в Firebase для завершения процесса аутентификации.
Подробную информацию вы найдете в руководстве по Cordova.
Какие есть альтернативы Firebase Dynamic Links?
Ознакомьтесь с разделом часто задаваемых вопросов Как перенести данные из сервиса?, в котором подробно описаны различные сценарии переноса и приведены руководства по переносу для различных доступных альтернатив.