Dynamic Links 淘汰常見問題

我們在 7 年多前推出 Firebase Dynamic 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 停用後，您可能會遇到以下情況：

  • 按下所有的連結都會傳回 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 狀態回應

  • 根據在應用程式中發出的 SDK 平台版本和 API 呼叫，會做出下列行為：

    iOS

    用途 API 呼叫 狀態碼 行為 應用程式是否會當機？
    建立短連結

    shorten (Swift)

    shortenUrl (Swift)

    shortenWithComplete (Objective-C)

    		 400 發生錯誤，但失敗原因 否*
    初次開啟出處

    在 FirebaseApp.configure (Swift)/FIRApp.configure (Objective-C) 上自動呼叫

    		 400 不會發生錯誤，但傳回的 FDL 物件包含空白資料 否*
    重新開啟歸因

    handleUniversalLink (Swift)

    handleUniversalLink (Objective-C)

    		 400 發生錯誤，但失敗原因 否*

    Android

    用途 API 呼叫 狀態碼 行為 應用程式是否會當機？
    建立短連結

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

    		 400 發生錯誤，但失敗原因 否*
    初次開啟出處

    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、AppsFlyer、Bitly、Branch、Kochava 和市場中的其他類似供應商。(請注意，這些供應商尚未經過 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。

如果您看到的遷移情境不符合您的需求，請與我們聯絡。

在 2025 年 8 月 25 日終止服務之前，您還是可以使用 Short Links 和 Analytics (分析) 的 Firebase Dynamic Links API。

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

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

您可以運用匯出指南擷取 Firebase Dynamic Links 中繼資料，包括連結本身。

您可以使用 Firebase Dynamic Links Analytics API 擷取各個 Firebase Dynamic Links 的連結統計資料。這個 Analytics (分析) API 的每秒查詢次數上限為 5 次。如需使用 API 時如何在要求限制內執行作業的範例，請參閱這個 Cloud 工作範例。

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

如果您需要更高的要求比率來協助遷移，請透過 Firebase 支援團隊與我們聯絡。

系統會在 2025 年 8 月 25 日將您的網域和連結中繼資料標示為待刪除，並依據 資料保留政策清除。

可以，您使用 Firebase 驗證功能的電子郵件連結驗證也可以繼續運作。

Firebase 驗證目前使用 Firebase Dynamic Links 自訂驗證連結，但我們會提供需要進行用戶端更新的更新，以確保電子郵件連結驗證功能在 Firebase Dynamic Links 服務關閉後繼續運作。

請注意，Firebase 驗證僅仰賴 Firebase Dynamic Links SDK，但不依賴 Firebase Dynamic Links SDK。

自 2023 年 8 月 25 日終止公告當日起，如果您的 Firebase 專案尚未啟用 FDL，目前還沒有啟用 Firebase Dynamic Links。

如果您需要啟用 Firebase Dynamic Links 來啟用電子郵件連結驗證功能，請與 Firebase 支援團隊聯絡，我們會與您聯絡，協助您完成設定。

請注意，上述功能的連續性與使用 Firebase Dynamic Links 用於儲存和網路轉送的主要用途、延遲及一般深層連結 (將於上述的遷移時程淘汰)。

請參閱 「如何從服務遷移」常見問題，進一步瞭解不同的遷移情境，並針對各種可用的替代做法提供遷移指南。