Najczęstsze pytania dotyczące wycofania linków dynamicznych

Linki dynamiczne Firebase zostały wprowadzone ponad 7 lat temu, aby zwiększyć możliwości adresów URL, np. dynamicznie zmieniać miejsce docelowe linku na podstawie warunków w czasie wykonywania.

W ciągu ostatnich lat ekosystemy internetowe i mobilne ewoluowały wraz z rozwojem takich technologii jak App Links, Google Play Instant, Universal Links i App Clips, co zaowocowało płynniejszym i bardziej przewidywalnym przebiegiem ścieżek użytkowników w aplikacjach i w internecie. Wierzymy, że Ty i Twoi użytkownicy zyskacie więcej, jeśli wprowadzicie te technologie bezpośrednio i będziecie dalej rozwijać ten ekosystem. Jednak wraz z tymi nowymi zmianami ewoluowały też pierwotne natywne interfejsy API, na których oparte są Linki dynamiczne Firebase, co wiązało się z nowymi wyzwaniami.

Na przykład zmiany w ekosystemie wpłynęły na naszą zdolność do zapewnienia stabilnego działania jednej z podstawowych funkcji Dynamic Links Firebase, która umożliwia użytkownikom płynne przejście do aplikacji po jej zainstalowaniu niezależnie od platformy.

Zamiast kontynuować obsługę funkcji, która nie działała idealnie, zdecydowaliśmy się wycofać Linki dynamiczne Firebase i przekierować nasze zasoby na rozwiązanie innych problemów, z którymi borykają się deweloperzy.

Zdajemy sobie sprawę, że ta zmiana wymaga czasu na ocenę i wdrożenie alternatywnych rozwiązań lub platform dostępnych na rynku.

Wraz z rozwojem i zmianami w ekosystemie stale ulepszamy Firebase, aby spełniał Twoje potrzeby. Będziemy nadal wdrażać nowe funkcje i aktualizacje w usługach Firebase, aby pomagać Ci w doskonaleniu procesu tworzenia aplikacji.

Co muszę wiedzieć?

25 sierpnia 2025 r. usługa Linki dynamiczne Firebase zostanie zamknięta. Wszystkie linki udostępniane przez Linki dynamiczne Firebase (zarówno te hostowane na domenach niestandardowych, jak i na subdomenach page.link) przestaną działać, a Ty nie będziesz już mieć możliwości tworzenia nowych linków.

Aby pomóc Ci w podjęciu decyzji o sposobie migracji z Linków dynamicznych Firebase, będziemy nadal aktualizować ten dokument z najczęściej zadawanymi pytaniami, dodając do niego dodatkowe informacje, a także udostępniać przewodniki po różnych scenariuszach migracji, które mogą odpowiadać sposobowi, w jaki obecnie używasz Linków dynamicznych Firebase.

Będziemy też na bieżąco aktualizować ten przewodnik o kolejne odpowiedzi na najczęstsze pytania, gdy zbliżać się będzie termin wycofania usługi (25 sierpnia 2025 r.), oraz gdy będziemy odkrywać kolejne problemy, aby pomóc Ci w przeprowadzeniu migracji.

Poniżej znajdziesz odpowiedzi na niektóre z najważniejszych pytań.

Aby rozpocząć migrację, zapoznaj się z odpowiedziami na najczęstsze pytania dotyczące migracji z usługi.

25 sierpnia 2025 r. usługa Linki dynamiczne Firebase zostanie zamknięta. Wszystkie linki obsługiwane przez Linki dynamiczne Firebase (zarówno te hostowane w domenach niestandardowych, jak i w subdomenach page.link) przestaną działać.

Ile mam czasu na przeprowadzenie migracji?

Na przeprowadzenie migracji masz czas do 25 sierpnia 2025 r.

Tak. Nowe i dotychczasowe linki będą działać do czasu wyłączenia usługi Dynamic Links 25 sierpnia 2025 r.

Nie. Po wyłączeniu usługi Linki dynamiczne Firebase wszystkie domeny .page.link nie będą już dostępne. Zalecamy zapoznanie się z tą listą pytań, aby ocenić, jak najlepiej przenieść dane z usługi. Jeśli potrzebujesz pełnej funkcjonalności, postępuj zgodnie z tymi wskazówkami dotyczącymi eksportowania metadanych i przenoszenia do innego dostawcy usługi linków głębokich za pomocą nowej domeny.

Po wycofaniu Linków dynamicznych Firebase:

  • Wszystkie kliknięte linki zwrócą użytkownikom kod stanu HTTP 404.

  • Wszystkie żądania HTTP do:

    • https://firebasedynamiclinks.googleapis.com/v1/shortLinks (Short Links API)
    • https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (interfejs API Link Stats)

    zwróci kod stanu HTTP 400/403.

  • Powyżej wymienione odpowiedzi na błędy będą stopniowo wprowadzane od 25 sierpnia 2025 r., aż do osiągnięcia 100% odpowiedzi na błędy po upływie daty wycofania.

  • Zależy on to, z której wersji platformy pakietu SDK i z jakiego wywołania interfejsu API korzysta Twoja aplikacja:

    iOS

    Przypadek użycia Wywołanie interfejsu API Kod stanu Zachowanie Czy aplikacja ulegnie awarii?
    Tworzenie krótkiego linku

    shorten (Swift)

    shortenUrl (Swift)

    shortenWithCompletion (Objective-C)

    		 403 Wystąpił błąd z powodem Nie*
    Atrybucja pierwszego uruchomienia

    Jest wywoływany automatycznie w metodach FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C).

    		 400 Nie występują żadne błędy, ale zwracany jest obiekt FDL z pustymi danymi. Nie*
    Otwórz ponownie atrybucję

    handleUniversalLink (Swift)

    handleUniversalLink (Objective-C)

    		 400 Wystąpił błąd z powodem Nie*

    Android

    Przypadek użycia Wywołanie interfejsu API Kod stanu Zachowanie Czy aplikacja ulegnie awarii?
    Tworzenie krótkiego linku

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

    		 403 Wystąpił błąd z powodem Nie*
    Atrybucja pierwszego uruchomienia

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    		 400 Zadanie zwraca odpowiedź o sukcesie, ale dane FDL będą puste Nie*
    Otwórz ponownie atrybucję

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    		 400 Zadanie zwraca odpowiedź o sukcesie, ale dane FDL będą puste Nie*
    Zaakceptuj zaproszenie Moduł AppInvite w Usługach Google Play wywoływany podczas obsługi przekierowania intencji (z *.page.link lub domeny niestandardowej) 400 Po wywołaniu Usług Google Play wyświetla się wskaźnik postępu, który znika, gdy zwrócona zostanie odpowiedź 400. Nie*

Jak przeprowadzić migrację z usługi?

Zauważyliśmy, że deweloperzy mają różne potrzeby dotyczące korzystania z linków dynamicznych Firebase.

W zależności od Twoich przypadków użycia i oceny korzystania z linków dynamicznych Firebase możesz potrzebować jednego ze scenariuszy poniżej.

W tym przypadku zalecamy korzystanie z usług innych dostawców, np. Adjust, Airbridge, AppsFlyer, Bitly, Branch, Kochava, Singular i innych podobnych dostawców na rynku. (zauważ, że ci dostawcy nie zostali zweryfikowani przez Google, ale oferują funkcje podobne do linków dynamicznych Firebase).

Możesz też eksportować metadane linków głębokich, co ułatwi przenoszenie linków do wybranego dostawcy.

Aby ułatwić znalezienie dostawcy z funkcjami podobnymi do Linków dynamicznych Firebase, zapoznaj się z poniższą listą funkcji.

Funkcje Linków dynamicznych Firebase:

  • przekierowuje użytkowników do odpowiedniego sklepu dla ich urządzenia za pomocą jednego kliknięcia (a w razie potrzeby przekierowuje do strony internetowej);
  • umożliwiają kontynuowanie przez użytkowników ścieżki po pobraniu i zainstalowaniu aplikacji, gdy wyświetlą odroczony precyzyjny link;
  • Zapewnia użytkownikom wrażenia zależne od kontekstu dzięki precyzyjnym linkom do treści w aplikacji (jeśli jest ona już zainstalowana).
  • Udostępnia dane analityczne związane ze zdarzeniami kliknięcia dynamicznego linku.
  • Umożliwia tworzenie adresów URL krótkich linków.
  • Umożliwia dodawanie metadanych do linków do udostępniania w mediach społecznościowych

Co zrobić, jeśli zależy mi tylko na precyzyjnych linkach do aplikacji, która jest już zainstalowana?

W tym przypadku zalecamy korzystanie z linków do aplikacji i uniwersalnych linków, które są obsługiwane na platformach i umożliwiają deweloperom udostępnianie użytkownikom precyzyjnych linków.

Więcej informacji o przechodzeniu na korzystanie z Linków do aplikacji i Linków uniwersalnych znajdziesz w tym przewodniku.

W tym przewodniku znajdziesz też opis opcjonalnego korzystania z Hostingu Firebase do hostowania niezbędnych plików weryfikacji domeny i linków do zasobów w domenie, której planujesz używać do nowych linków (np. pliku assetlinks.json w przypadku linków do aplikacji lub pliku apple-app-site-association w przypadku uniwersalnych linków).

W tym przypadku nie musisz podejmować żadnych działań w aplikacji, aby obsłużyć nadchodzący zachód słońca. Zalecamy jednak:

  • Sprawdź i zaktualizuj istniejące Linki dynamiczne Firebase zgodnie z przewodnikiem po eksporcie metadanych linków, aby mieć pewność, że użytkownicy i aplikacja nie odczują negatywnych skutków, gdy linki przestaną być wyświetlane.

  • usunąć prefiksy adresów URL Linków dynamicznych Firebase w  konsoli Firebase. Uwaga: domeny z prefiksem URL zostaną automatycznie usunięte 25 sierpnia 2025 r.

  • usunięcie z aplikacji pakietu SDK Linków dynamicznych Firebase.

Jeśli widzisz scenariusz migracji, który nie odpowiada Twoim potrzebom, skontaktuj się z nami

Interfejsy API Linków dynamicznych Firebase do krótkich linków i Analytics będą dostępne do 25 sierpnia 2025 r., kiedy zostaną wycofane.

Po tej dacie interfejsy API nie będą już dostępne, a usługa zostanie wyłączona.

Instrukcje eksportowania metadanych linku znajdziesz w przewodniku.

Możesz użyć przewodnika po eksporcie, aby pobrać metadane Linków dynamicznych Firebase, które obejmują sam link.

Aby pobrać dane statystyczne dotyczące każdego z Twoich Linków dynamicznych Firebase, możesz użyć interfejsu Firebase Dynamic Links Analytics API. Ten interfejs API Analytics jest ograniczony do ok. 5 zapytań na sekundę. Przykład działania w ramach tego limitu żądań podczas korzystania z interfejsu API znajdziesz w tym przykładowym zadaniu Cloud Task.

Możesz też korzystać z Google Analytics i eksportować dane dotyczące podzbioru danych analitycznych dotyczących linków, w tym zdarzeń aktualizacji aplikacji, które są unikalne dla Google Analytics.

Jeśli potrzebujesz wyższej częstotliwości żądań, aby ułatwić migrację, skontaktuj się z zespołem pomocy Firebase.

Metadane Twojej domeny i linków zostaną oznaczone do usunięcia 25 sierpnia 2025 r. i usunięte zgodnie z naszymi zasadami przechowywania danych.

Nie, nie musisz konfigurować linków dynamicznych Firebase, ponieważ nie jest to już możliwe. Zamiast tego możesz skorzystać z aktualizowanych przewodników dotyczących konfigurowania uwierzytelniania za pomocą linku e-mail, aby włączyć i zastosować to rozwiązanie w swoim projekcie:

Zobacz pełną listę czynności, których dotyczy ta zmiana.

Połączenie uwierzytelniania za pomocą e-maila i działania e-mailowe poza Firebase będą nadal działać, ale aby nadal korzystać z tych działań po wyłączeniu usługi Firebase Dynamic Links 25 sierpnia 2025 r., musisz przejść na najnowsze pakiety SDK Firebase Authentication i przeprowadzić migrację do nowego rozwiązania.

Aby dowiedzieć się, jak przeprowadzić migrację, skorzystaj z instrukcji w poniższych przewodnikach:

Zobacz pełną listę czynności, na które ma wpływ ta zmiana.

Jakie są konsekwencje dla implementacji procesu OAuth w przypadku pakietu SDK uwierzytelniania Firebase na Androida w wersji niższej niż 20.0.0 lub pakietu SDK wersji BoM niższej niż 26.0.0?

Aby nadal korzystać z implementacji procesu OAuth w aplikacjach na Androida, musisz zaktualizować pakiet SDK uwierzytelniania Firebase na Androida do najnowszej wersji (co najmniej 20.0.0).

Czy działania związane z e-mailami w Uwierzytelnianiu Firebase w aplikacjach internetowych zostały zmienione?

Nie. Wycofanie obsługi linków dynamicznych Firebase ma wpływ tylko na obsługę przychodzących adresów URL na urządzeniach mobilnych.

Jakie są konsekwencje dla implementacji, które używają bibliotek pakietu Firebase JS SDK do uwierzytelniania dostawców OAuth w aplikacji Cordova?

Pakiet Firebase JS SDK używa Linków dynamicznych Firebase do implementowania przepływów uwierzytelniania OAuth w aplikacjach Cordova. Aby to zrobić, musisz zmodyfikować implementację procesu, wykonując go ręcznie i przekazując uzyskane dane logowania OAuth do Firebase.

Więcej informacji znajdziesz w przewodniku po Cordova.

Zapoznaj się z artykułem "Jak przejść na inną usługę?", w którym omówiono różne scenariusze migracji oraz przedstawiono przewodniki po różnych dostępnych opcjach.