Często zadawane pytania dotyczące wycofania linków dynamicznych

Ponad 7 lat temu wprowadziliśmy linki dynamiczne Firebase, aby zwiększyć możliwości adresów URL — na przykład dynamicznie zmieniając miejsce docelowe łącza na podstawie warunków działania.

Z biegiem lat ekosystemy internetowe i mobilne ewoluowały dzięki technologiom, takim jak linki aplikacji , aplikacje błyskawiczne w Google Play , linki uniwersalne i klipy aplikacji , dzięki czemu podróż użytkowników między aplikacjami i internetem stała się dla nich bardziej płynna i przewidywalna. Wierzymy, że Ty i Twoi użytkownicy odniesiecie większe korzyści z bezpośredniego przyjęcia tych technologii i dalszego rozwijania ekosystemu. Jednak wraz z tymi nowymi zmianami oryginalne natywne interfejsy API, na których zbudowano Firebase Dynamic Links, również ewoluowały i stwarzały nowe wyzwania.

Na przykład zmiany w ekosystemie wpłynęły na naszą zdolność do zapewnienia spójnego i stabilnego działania jednej z podstawowych funkcji Firebase Dynamic Links – zapewniając użytkownikom aplikacji płynne przejście do niej po instalacji, niezależnie od platformy.

Zamiast nadal wspierać rozwiązania, które nie są idealne, zdecydowaliśmy się wycofać łącza dynamiczne Firebase i ponownie skoncentrować nasze zasoby na rozwiązywaniu innych problemów programistów.

Rozumiemy, że ta zmiana będzie wymagała czasu na ocenę i przyjęcie alternatywnych rozwiązań lub dostawców platform na rynku.

W miarę ewolucji i zmian ekosystemu stale rozwijamy Firebase, aby sprostać Twoim potrzebom. Będziemy nadal udostępniać nowe funkcje i aktualizacje produktów Firebase i dołożymy wszelkich starań, aby pomóc Ci osiągnąć sukces w procesie tworzenia aplikacji.

Co muszę wiedzieć?

25 sierpnia 2025 r. Linki dynamiczne Firebase zostaną wyłączone. Wszystkie linki obsługiwane przez Firebase Dynamic Links (zarówno hostowane w domenach niestandardowych, jak i subdomenach page.link) przestaną działać i nie będzie już można tworzyć nowych linków.

Aby pomóc Ci w podjęciu decyzji o migracji z Firebase Dynamic Links, będziemy w dalszym ciągu aktualizować ten dokument z często zadawanymi pytaniami, dodając dodatkowe informacje do rozważenia, a także udostępniając przewodniki dotyczące migracji dla różnych scenariuszy migracji, które mogą pasować do sposobu, w jaki obecnie korzystasz z Firebase Dynamic Links.

Będziemy także nadal aktualizować ten przewodnik, dodając więcej często zadawanych pytań, w miarę jak wycofywanie będzie się zbliżać do daty ostatecznej, czyli 25 sierpnia 2025 r., a także wykryjemy wszelkie dodatkowe problemy, pomagając Ci w wysiłkach związanych z migracją.

Zapoznaj się z poniższymi często zadawanymi pytaniami, aby uzyskać odpowiedzi na niektóre z najważniejszych pytań.

Aby rozpocząć migrację, zapoznaj się z często zadawanymi pytaniami „Jak przeprowadzić migrację z usługi” poniżej.

25 sierpnia 2025 r. Linki dynamiczne Firebase zostaną wyłączone. Wszystkie linki obsługiwane przez Firebase Dynamic Links (zarówno te hostowane w domenach niestandardowych, jak i w subdomenach page.link) przestaną działać.

Ile czasu będę musiał przeprowadzić na migrację?

Na dokończenie migracji masz czas do 25 sierpnia 2025 roku.

Tak, Twoje nowe i istniejące linki będą nadal działać do czasu wyłączenia usługi Linki dynamiczne 25 sierpnia 2025 r.

Po wyłączeniu Linków dynamicznych Firebase możesz się spodziewać, że:

  • Wszystkie kliknięte łącza zwrócą użytkownikom końcowym odpowiedź o stanie HTTP 404.
  • Wszystkie żądania HTTP do:

    • https://firebasedynamiclinks.googleapis.com/v1/shortLinks (interfejs API krótkich linków)
    • https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (interfejs API statystyk linków)

    zwróci odpowiedź stanu HTTP 400/403.

  • Następujące zachowanie w zależności od wersji platformy SDK i wywołania API wykonanego w Twojej aplikacji:

    iOS

    Przypadek użycia Wywołanie API Kod statusu Zachowanie Czy Twoja aplikacja ulegnie awarii?
    Utwórz krótki link

    skrócić (szybko)

    skrócićUrl (Swift)

    skrócićWithCompletion (cel-C)

    400 Wyświetlany jest błąd z przyczyną niepowodzenia NIE*
    Pierwsza otwarta atrybucja

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

    400 Nie są emitowane żadne błędy, ale obiekt FDL jest odsyłany z pustymi danymi NIE*
    Otwórz ponownie atrybucję

    uchwytUniversalLink (Swift)

    handleUniversalLink (Objective-C)

    400 Wyświetlany jest błąd z przyczyną niepowodzenia NIE*

    Android

    Przypadek użycia Wywołanie API Kod statusu Zachowanie Czy Twoja aplikacja ulegnie awarii?
    Utwórz krótki link

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

    400 Wyświetlany jest błąd z przyczyną niepowodzenia NIE*
    Pierwsza otwarta atrybucja

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

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

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    400 Zadanie zwraca odpowiedź o powodzeniu, ale dane FDL będą puste NIE*
    Przyjąć zaproszenie Moduł AppInvite w Usługach Google Play wywoływany podczas obsługi przekierowania intencji (z *.page.link lub domeny niestandardowej) 400 Wyświetla pokrętło po wywołaniu Usług Google Play i znika po zwróceniu odpowiedzi 400 NIE*

Jak przeprowadzić migrację z usługi?

Odkryliśmy, że różni programiści mają różne potrzeby, jeśli chodzi o korzystanie z łączy dynamicznych Firebase.

W zależności od Twoich własnych przypadków użycia i oceny wykorzystania Linków dynamicznych Firebase prawdopodobnie jeden z poniższych scenariuszy będzie odpowiadał Twoim potrzebom.

W tym scenariuszu zalecamy skorzystanie z usług innych dostawców/dostawców usług głębokiego linkowania, takich jak Correct, AppsFlyer, Bitly, Branch, Kochava i innych podobnych dostawców na rynku. (Uwaga: ci dostawcy nie zostali sprawdzeni przez Google, ale zapewniają podobną funkcjonalność do Firebase Dynamic Links).

Możesz także wyeksportować metadane precyzyjnych linków , co może ułatwić migrację linków do dowolnego wybranego dostawcy.

Aby pomóc w znalezieniu dostawcy pasującego do funkcji Firebase Dynamic Links, zapoznaj się z poniższą listą funkcji.

Funkcje łączy dynamicznych Firebase:

  • Kieruje użytkowników do odpowiedniego sklepu dla ich urządzenia za pomocą jednego kliknięcia (i w razie potrzeby wraca do strony internetowej)
  • Zapewnia użytkownikom kontynuację podróży po pobraniu i zainstalowaniu aplikacji, wyświetla odroczony głęboki link
  • Zapewnia użytkownikom kontekstowe wrażenia dzięki treściom z głębokimi linkami w Twojej aplikacji (jeśli jest już zainstalowana)
  • Dostarcza dane analityczne związane ze zdarzeniami kliknięcia linku dynamicznego
  • Zapewnia możliwość tworzenia adresów URL z krótkimi linkami
  • Zapewnia możliwość dodawania metadanych do łączy w celu udostępniania w mediach społecznościowych

A co jeśli zależy mi tylko na głębokim linkowaniu do mojej aplikacji już po jej zainstalowaniu?

W tym scenariuszu zalecamy korzystanie z łączy aplikacji i łączy uniwersalnych , które są obsługiwanymi przez platformę sposobami udostępniania użytkownikom funkcji głębokich linków przez programistów.

Więcej informacji na temat migracji do funkcji App Links i Universal Links znajdziesz w tym przewodniku .

W tym przewodniku opisano również, jak opcjonalnie używać Firebase Hosting do hostowania niezbędnych plików weryfikacji linków do domen i zasobów w domenie, której planujesz używać dla nowych linków (np. plik aktywówlinks.json dla łączy aplikacji, plik skojarzeń Apple-app-site dla Linki uniwersalne).

W tym scenariuszu może nie być konieczne podejmowanie żadnych działań w aplikacji, aby poradzić sobie ze zbliżającym się zachodem słońca, jednak zalecamy:

  • Przeglądanie istniejących linków dynamicznych Firebase zgodnie z przewodnikiem dotyczącym eksportowania metadanych linków, aby mieć pewność, że przestanie udostępniać linki nie będzie miało to wpływu na użytkowników i aplikację.

  • Usuwanie prefiksów URL linków dynamicznych Firebase w konsoli Firebase . Uwaga: domeny z prefiksami adresów URL zostaną automatycznie usunięte po 25 sierpnia 2025 r.

  • Usuwanie pakietu SDK Firebase Dynamic Links z aplikacji.

Jeśli widzisz scenariusz migracji, który nie uwzględnia Twoich potrzeb, skontaktuj się z nami i daj nam znać

Interfejsy API Firebase Dynamic Links dla krótkich linków i Analytics pozostaną dostępne do daty ostatecznej, czyli 25 sierpnia 2025 r.

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

Instrukcje dotyczące eksportowania metadanych linków znajdują się w przewodniku dotyczącym eksportowania metadanych linków.

Możesz skorzystać z przewodnika eksportu , aby pobrać metadane Linków dynamicznych Firebase, które obejmują sam link.

Możesz użyć interfejsu API Firebase Dynamic Links Analytics, aby pobrać dane statystyczne dotyczące linków dla każdego z Twoich łączy dynamicznych Firebase. Ten interfejs API Analytics jest ograniczony do ~5 QPS. Przykład działania w ramach tego limitu żądań podczas korzystania z interfejsu API można znaleźć w tym przykładzie Cloud Task .

Możesz także skorzystać z Google Analytics i wyeksportować swoje dane w celu uzyskania podzbioru danych analizy linków, w tym zdarzeń aktualizacji aplikacji, które są unikalne dla Google Analytics.

Jeśli potrzebujesz większej liczby żądań pomocy przy migracji, skontaktuj się z nami z pomocą techniczną Firebase .

Metadane Twojej domeny i linku zostaną oznaczone do usunięcia 25 sierpnia 2025 r. i usunięte zgodnie z naszą polityką przechowywania danych .

Tak, uwierzytelnianie łącza e-mail za pomocą uwierzytelniania Firebase będzie nadal działać.

Uwierzytelnianie Firebase wykorzystuje obecnie Linki dynamiczne Firebase do dostosowywania łączy uwierzytelniających, ale udostępnimy aktualizację, aby zapewnić dalsze działanie tej funkcji po wyłączeniu usługi Linki dynamiczne Firebase.

Należy pamiętać, że ta kontynuacja funkcjonalności różni się od korzystania z łączy dynamicznych Firebase w głównych przypadkach użycia, takich jak routing w sklepach i sieci, odroczone i regularne głębokie linki, które zostaną wycofane zgodnie z udostępnionym powyżej harmonogramem migracji.

Zapoznaj się z często zadawanymi pytaniami „Jak przeprowadzić migrację z usługi” , w których szczegółowo opisano różne scenariusze migracji i przedstawiono przewodniki po migracji dotyczące różnych dostępnych alternatyw.