Dynamic Links 淘汰常見問題

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

多年以來，網頁和行動裝置生態系統不斷進化，推出了 應用程式連結、Google Play 免安裝、通用連結和 應用程式精選 等技術，讓應用程式使用者在應用程式和網頁上的使用者歷程更順暢、更可預測。我們相信，直接採用這些技術，並持續推動生態系統發展，將可讓您和使用者獲得更多益處。不過，除了這些新變更之外，Firebase Dynamic Links 所建構的原生 API 也隨之演進，並帶來新的挑戰。

舉例來說，生態系統變更會影響我們為 Firebase 動態連結的其中一個核心功能提供一致穩定體驗的能力，無論平台為何，都能讓應用程式使用者在安裝後順利進入應用程式。

為了不繼續提供不理想的體驗，我們決定停用 Firebase 動態連結，並將資源重新聚焦於解決其他開發人員的痛點。

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

隨著生態系統持續演進和變化，我們會持續改良 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)

    shortenWithCompletion (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、Airbridge、AppsFlyer、Bitly、Branch、Kochava 和市場上的其他類似供應商。(請注意，這些供應商尚未經過 Google 審查，但確實提供與 Firebase Dynamic Links 類似的功能)。

您也可以 匯出深層連結中繼資料，方便將連結遷移至所選供應商。

如要尋找提供與 Firebase 動態連結相符功能的供應商，請參閱下列功能清單。

Firebase 動態連結功能：

  • 讓使用者只要按一下即可前往裝置的正確商店 (必要時會改為網頁)
  • 在使用者下載及安裝應用程式後，提供延遲深層連結，讓他們繼續瀏覽
  • 透過應用程式中的深層連結內容 (已安裝應用程式時)，為使用者提供符合當下情境的體驗
  • 提供與動態連結點擊事件相關的分析資料
  • 提供建立短網址網址的功能
  • 可在連結中加入中繼資料，方便在社群媒體上分享

如果我只在乎在應用程式安裝完成後，深層連結到應用程式，該怎麼辦？

針對這種情況，建議您使用應用程式連結和通用連結，這兩者是平台支援的功能，可讓開發人員為使用者提供深層連結體驗。

請參閱這份指南，進一步瞭解如何遷移至使用應用程式連結和通用連結。

本指南也說明如何選擇使用 Firebase 託管服務，在您打算用於新連結的網域上代管必要的網域和資產連結驗證檔案 (例如 App Links 的 assetlinks.json 檔案，以及 Universal Links 的 apple-app-site-association 檔案)。

在這種情況下，您可能不需要在應用程式中採取任何行動，即可處理即將到來的 sunset，但我們建議您：

  • 按照匯出連結中繼資料的指南檢查現有的 Firebase 動態連結，確保在連結不再提供服務時，不會影響使用者和應用程式。

  • 在 Firebase 控制台中刪除 Firebase 動態連結網址前置字串。注意：網址前置字串網域會在 2025 年 8 月 25 日後自動刪除。

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

如果您發現遷移情境未涵蓋自己的需求，請與我們聯絡

Short Links 和 Analytics 的 Firebase Dynamic Links API 仍可使用至 2025 年 8 月 25 日的停用日期為止。

屆時這些 API 將無法再使用，且服務會關閉。

如要瞭解如何匯出連結中繼資料，請參閱匯出連結中繼資料的指南。

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

您可以使用 Firebase Dynamic Links Analytics API 擷取每個 Firebase Dynamic Links 的連結統計資料。這個 Analytics API 的限制為約 5 QPS。如需使用 API 時如何在要求限制內運作的範例，請參閱這個 Cloud Tasks 範例。

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

如果您需要更高的請求率來協助遷移作業，請與 Firebase 支援團隊聯絡。

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

否，您不需要導入 Firebase Dynamic Links，因為無法再導入。您可以按照更新版指南開始使用電子郵件連結驗證功能，為專案啟用及實作這項功能：

請參閱受這項異動影響的完整動作清單。

電子郵件連結驗證和使用 Firebase 的非頻道電子郵件動作會繼續運作，但您必須升級至最新的 Firebase Authentication SDK，並遷移至新解決方案，才能在 Firebase Dynamic Links 服務於 2025 年 8 月 25 日關閉後繼續使用這些動作。

您可以按照下方連結的指南操作，瞭解如何完成遷移作業：

請參閱受此影響的動作完整清單。

使用 Firebase 驗證 Android SDK 20.0.0 以下版本或 BoM 26.0.0 以下版本的 OAuth 流程實作方式會受到什麼影響？

如要在 Android 應用程式中繼續使用 OAuth 流程導入作業，您必須更新至最新的 Firebase Authentication Android SDK (至少為 20.0.0 以上版本)。

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

否。Firebase Dynamic Link 淘汰作業只會影響行動裝置上處理的傳入網址。

使用 Firebase JS SDK 程式庫驗證 Cordova 應用程式中的 OAuth 提供者時，實作方式會受到哪些影響？

是的，Firebase JS SDK 會使用 Firebase Dynamic Links 導入 OAuth 驗證流程。您必須手動執行 OAuth 流程，並將產生的 OAuth 憑證傳遞至 Firebase，才能修改流程的實作方式，完成驗證流程。

詳情請參閱 Cordova 指南。

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