Dynamic Links 淘汰常見問題

我們在 7 年多前推出 Firebase Dynamic Links,讓網址功能更強大,例如根據執行階段條件動態變更連結的目的地。

多年來,網路和行動生態系統隨著 App Links、Google Play 免安裝、通用連結 和 App Clips 等技術而演進,讓應用程式使用者在應用程式和網路之間的使用者歷程更加流暢且可預測。我們相信,直接採用這些技術並持續推動生態系統發展,對您和使用者都更有益。不過,除了這些新異動外,Firebase Dynamic Links 採用的原始原生 API 也經過演進,並帶來新的挑戰。

舉例來說,生態系統異動影響了我們為 Firebase Dynamic Links 核心功能之一提供穩定體驗的能力,也就是讓應用程式使用者在安裝後,無論使用何種平台,都能順暢轉換至應用程式。

我們決定停用 Firebase Dynamic Links,不再繼續支援不理想的體驗,並將資源重新投入解決其他開發人員痛點。

我們瞭解您需要時間評估這項異動,並採用市面上的替代解決方案或平台供應商。

隨著生態系統不斷演變和變化,我們也會持續改良 Firebase,滿足您的需求。我們將持續推出 Firebase 產品的新功能和更新,並致力協助您在應用程式開發過程中取得卓越成果。

我需要知道哪些資訊?

Firebase Dynamic Links 將於 2025 年 8 月 25 日終止服務。所有由 Firebase Dynamic Links 提供的連結 (包括託管於自訂網域和 page.link 子網域的連結) 都將停止運作,您也無法再建立新連結。

為協助您決定如何從 Firebase Dynamic Links 遷移,我們會持續更新這份常見問題文件,提供更多資訊供您參考,並針對不同的遷移情境提供遷移指南,協助您找出符合目前 Firebase Dynamic Links 使用方式的方案。

隨著淘汰作業持續進行,直到 2025 年 8 月 25 日停用日期為止,我們也會持續更新本指南,加入更多常見問題,並在協助您遷移時,找出任何其他問題。

請參閱下方的常見問題,瞭解一些重要問題的解答。

如要開始遷移,請參閱下方的「如何從服務遷移」常見問題。

Firebase Dynamic Links 將於 2025 年 8 月 25 日終止服務。所有由 Firebase Dynamic Links 提供的連結 (包括託管於自訂網域和 page.link 子網域的連結) 都將停止運作。

我有多少時間可以遷移?

請在 2025 年 8 月 25 日前完成遷移。

可以,在 Dynamic Links 服務於 2025 年 8 月 25 日終止前,新舊連結都能繼續運作。

不行,Firebase Dynamic Links 服務終止後,所有 .page.link 網域都將無法使用。建議您參閱這份問題清單,評估如何以最佳方式從服務遷移。如需完整功能,請按照這份指南匯出中繼資料,並使用新網域遷移至其他深層連結服務供應商。

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)

    會傳回 400/403 HTTP 狀態回應。

  • 上述錯誤回應將於 2025 年 8 月 25 日起逐步出現,並在停用日期過後達到 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 資料會是空白 否*
    接受邀請 處理意圖重新導向 (來自 *.page.link 或自訂網域) 時,叫用 Google Play 服務中的 AppInvite 模組 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 Dynamic Links 功能:

  • 使用者只要按一下,就能前往適合其裝置的商店 (如有需要,可改為前往網頁)
  • 使用者下載並安裝應用程式後,可透過延遲深層連結繼續操作
  • 透過應用程式中的深層連結內容 (如果已安裝),為使用者提供符合情境的體驗
  • 提供與動態連結點擊事件相關的數據分析資料
  • 可建立短網址
  • 可為連結新增中繼資料,以便在社群媒體上分享

如果我只希望在應用程式安裝後,才透過深層連結將使用者帶往應用程式,該怎麼做?

在這種情況下,建議使用應用程式連結和通用連結,這是平台支援的方式,可讓開發人員為使用者提供深層連結體驗。

如要進一步瞭解如何改用應用程式連結和通用連結,請參閱這份指南。

本指南也說明如何視需要使用 Firebase 託管,在您打算用於新連結的網域上,託管必要的網域和素材資源連結驗證檔案 (例如應用程式連結的 assetlinks.json 檔案、通用連結的 apple-app-site-association 檔案)。

在這種情況下,您可能不需要在應用程式中採取任何行動,即可因應即將到來的停用作業,但建議您:

  • 請按照匯出連結中繼資料指南,檢查現有的 Firebase Dynamic Links,確保連結停止服務後,使用者和應用程式不會受到影響。

  • 在 Firebase 控制台中刪除 Firebase Dynamic Links 網址前置字串。注意:網址前置字元網域將於 2025 年 8 月 25 日後自動刪除。

  • 從應用程式中移除 Firebase Dynamic Links SDK。

如果遷移情境不符合您的需求,請與我們聯絡

完成遷移後該怎麼做?

完成 Firebase Dynamic Links 遷移作業後,請務必刪除專案中與先前 Firebase Dynamic Links 相關聯的所有網址網域前置字串 (FDL 網域)。

方法如下:

  1. 前往 Firebase 控制台的「Firebase Dynamic Links」部分
  2. 從左側選取器選取要刪除的網址前置字元 FDL 控制台螢幕截圖:網址路徑前置字串選取器

  3. 按一下「新增動態連結」按鈕旁的三點圖示選單 FDL 控制台螢幕截圖:網址路徑前置字串選項

  4. 選取「刪除網址前置字串」

  5. 輸入網址前置字串,確認要刪除,然後按一下「刪除網址前置字串」

刪除所有網址網域前置字串後,Firebase 專案就會標示為已完成從 Firebase Dynamic Links 遷移的程序。這也會移除您在專案的 Firebase 控制台中可能看到的彈出式提醒。

請注意,這項操作完成後,所有 Firebase Dynamic Links 都會刪除,因此請務必先完成遷移,再刪除網址網域前置字串。

短連結和數據分析的 Firebase Dynamic Links API 將持續提供服務,直到 2025 年 8 月 25 日停用為止。

該日期過後,這些 API 將無法再使用,服務也會關閉。

如需匯出連結中繼資料的操作說明,請參閱匯出連結中繼資料指南。

您可以參閱匯出指南,瞭解如何擷取 Firebase Dynamic Links 連結中繼資料 (包括連結本身)。

您可以使用 Firebase Dynamic Links Analytics API,擷取每個 Firebase Dynamic Links 的連結統計資料。這項 Analytics API 的 QPS 上限約為 5。如需範例,瞭解如何在使用 API 時遵守這項要求限制,請參閱這個 Cloud Task 範例。

您也可以使用 Google Analytics,並匯出部分連結數據分析資料,包括 Google Analytics 專屬的應用程式更新事件。

如需提高要求比率來協助遷移,請透過 Firebase 支援與我們聯絡。

您的網域和連結中繼資料將於 2025 年 8 月 25 日標示為刪除,並根據資料保留政策清除。

不需要,因為 Firebase Dynamic Links 已無法加入。請改為按照更新後的指南,開始使用電子郵件連結驗證功能,為專案啟用及實作這項功能:

查看受這項異動影響的動作完整清單。

Firebase 的電子郵件連結驗證和頻外電子郵件動作仍可正常運作,但您必須升級至最新版 Firebase Authentication SDK 並改用新解決方案,才能在 Firebase Dynamic Links 服務於 2025 年 8 月 25 日終止後,繼續使用這些動作。

請按照下方連結的指南,完成遷移作業:

查看受此影響的動作完整清單。

如果 OAuth 流程導入作業使用 Firebase 驗證 Android SDK 20.0.0 以下版本,或 BoM 26.0.0 以下版本,會受到什麼影響?

您必須更新至最新版 Firebase 驗證 Android SDK (至少 20.0.0 版),才能繼續在 Android 應用程式中使用 OAuth 流程。

網頁應用程式上的 Firebase 驗證電子郵件動作是否會受到影響?

不會。Firebase Dynamic Links 淘汰只會影響行動裝置處理傳入網址的方式。

如果導入作業使用 Firebase JS SDK 程式庫,在 Cordova 應用程式中驗證 OAuth 供應商,會受到什麼影響?

Firebase JS SDK 會使用 Firebase Dynamic Links,在 Cordova 應用程式中實作 OAuth 驗證流程。您必須手動執行 OAuth 流程,並將產生的 OAuth 憑證傳遞至 Firebase,才能完成驗證流程。

詳情請參閱 Cordova 指南。

請參閱「如何從服務遷移」常見問題,其中詳細說明不同的遷移情境,並提供各種替代方案的遷移指南。