動態鏈接棄用常見問題解答

我們在 7 年前推出了 Firebase 動態鏈接,以使 URL 更加強大 - 例如,根據運行時條件動態更改鏈接的目標。

多年來,網路和行動生態系統隨著App LinksGoogle Play InstantUniversal LinksApp Clips等技術的發展而不斷發展,並使應用程式使用者在應用程式和網路上的用戶旅程變得更加無縫和可預測。我們相信,您和您的用戶將透過直接採​​用這些技術並繼續推動生態系統向前發展而受益更多。然而,除了這些新變化之外,Firebase 動態連結所基於的原始本機 API 也在不斷發展並帶來了新的挑戰。

例如,生態系統的變化影響了我們為 Firebase Dynamic Links 的核心功能之一提供一致穩定的體驗的能力 - 讓應用程式使用者在安裝後順利過渡到應用程序,無論平台如何。

我們不再繼續支援不太理想的體驗,而是決定取消 Firebase 動態鏈接,並將我們的資源重新集中在解決其他開發人員痛點上。

我們了解,這項變更將需要您花時間評估和採用市場上的替代解決方案或平台提供者。

隨著生態系統的不斷發展和變化,我們將繼續發展 Firebase 以滿足您的需求。我們將繼續在 Firebase 產品中推出新功能和更新,並致力於協助您在應用程式開發之旅中脫穎而出。

我需要知道什麼?

2025 年 8 月 25 日,Firebase 動態連結將關閉。 Firebase 動態連結(託管在自訂網域和 page.link 子網域上)提供的所有連結都將停止運作,您將無法再建立新連結。

為了幫助您決定如何從Firebase 動態連結進行遷移,我們將繼續更新此常見問題解答文檔,提供供您考慮的其他信息,並提供可能與您當前使用Firebase 動態連結的方式相匹配的不同遷移場景的遷移指南。

隨著棄用日期接近 2025 年 8 月 25 日日落日期,我們還將繼續更新本指南,提供更多常見問題解答,並且在幫助支援您的遷移工作時發現任何其他問題。

請參閱下面的常見問題解答,以幫助回答您的一些最重要的問題。

要開始遷移,請查看下面的「我應該如何從服務遷移」常見問題

2025 年 8 月 25 日,Firebase 動態連結將關閉。 Firebase 動態連結提供的所有連結(託管在自訂網域和 page.link 子網域上的連結)都將停止運作。

我需要多長時間進行遷移?

您必須在 2025 年 8 月 25 日之前完成遷移。

是的,您的新連結和現有連結將繼續有效,直到動態連結服務於 2025 年 8 月 25 日關閉為止。

當 Firebase 動態連結停用後,您可以預期:

  • 點選的所有連結都會向最終使用者傳回 HTTP 404 狀態回應。
  • 所有 HTTP 請求:

    • https://firebasedynamiclinks.googleapis.com/v1/shortLinks(短連結 API)
    • https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats(連結統計 API)

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

  • 以下行為是基於您的應用程式中進行的 SDK 平台版本和 API 呼叫:

    iOS系統

    使用案例API呼叫狀態碼行為您的應用程式會崩潰嗎?
    建立短連結

    縮短(斯威夫特)

    縮短網址(Swift)

    縮短完成(Objective-C)

    400發出錯誤並說明失敗原因不*
    首次開放歸因

    FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C) 上自動調用

    400不會發出錯誤,但會發回有空資料的 FDL 對象不*
    重新開啟歸因

    處理通用連結(Swift)

    處理UniversalLink (Objective-C)

    400發出錯誤並說明失敗原因不*

    安卓

    使用案例API呼叫狀態碼行為您的應用程式會崩潰嗎?
    建立短連結

    buildShortDynamicLink (Kotlin)

    建構短動態連結(Java)

    400發出錯誤並說明失敗原因不*
    首次開放歸因

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    400任務返回成功回應,但 FDL 資料將為空不*
    重新開啟歸因

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    400任務返回成功回應,但 FDL 資料將為空不*
    接受邀請處理意圖重新導向時呼叫 Google Play 服務中的 AppInvite 模組(來自 *.page.link 或自訂網域) 400呼叫 Google Play 服務時顯示微調器,返回 400 回應時消失不*

我應該如何從該服務遷移?

我們發現不同的開發者在使用 Firebase 動態連結時有不同的需求。

根據您自己的使用案例以及對 Firebase 動態連結使用情況的評估,以下場景之一可能會滿足您的需求。

對於這種場景,我們建議您使用其他深度連結服務提供者/供應商,例如Adjust、AppsFlyer、Bitly、Branch、Kochava 以及市場上其他類似的供應商。 (請注意,這些提供者尚未經過 Google 審查,但確實提供了與 Firebase 動態連結類似的功能)。

您還可以匯出深層連結元數據,這可以使您更輕鬆地將連結遷移到您選擇的提供者。

為了協助找到具有與 Firebase 動態連結相符的功能的供應商,請參閱下面的功能清單。

Firebase 動態連結功能:

  • 只需單擊一次即可將用戶路由到適合其設備的正確商店(如果需要,則返回網頁)
  • 在下載並安裝應用程式後為用戶提供旅程的延續查看延遲的深層鏈接
  • 透過應用程式中的深層連結內容為用戶提供上下文體驗(如果已安裝)
  • 提供與動態連結點擊事件相關的分析數據
  • 提供建立短連結 URL 的能力
  • 提供將元資料新增至社交分享連結的能力

如果我只關心應用程式安裝後的深層連結怎麼辦?

對於這種情況,我們建議使用應用程式鏈接通用鏈接,它們是平台支援的方式,供開發人員為其用戶提供深度鏈接體驗。

請查看本指南,以了解有關如何遷移到使用應用程式連結和通用連結的更多詳細資訊

本指南還介紹如何選擇使用Firebase 託管在您計劃用於新連結的網域上託管必要的網域和資產連結驗證檔案(例如,用於應用程式連結的assetlinks.json 檔案、用於應用程式連結的apple -app-site-association 檔案)。通用連結)。

對於這種情況,您可能不需要在應用程式中採取任何操作來處理即將到來的日落,但我們建議:

  • 請按照匯出連結元資料的指南檢查現有的 Firebase 動態鏈接,以確保連結不再提供後您的使用者和應用程式不會受到影響。

  • Firebase 控制台中刪除 Firebase 動態連結 URL 前綴。注意:URL 前綴域將在 2025 年 8 月 25 日之後自動刪除。

  • 從您的應用程式中刪除 Firebase 動態連結 SDK。

如果您發現遷移方案無法滿足您自己的需求,請聯絡我們告知

用於短連結分析的 Firebase 動態連結 API 將保持可用,直至 2025 年 8 月 25 日日落日期。

在此日期之後,這些 API 將不再可用,並且該服務將關閉

請參閱匯出連結元資料指南,以了解如何匯出連結元資料的說明。

您可以使用匯出指南來擷取 Firebase 動態連結元數據,其中包括連結本身。

您可以使用Firebase 動態連結分析 API檢索每個 Firebase 動態連結的連結統計資料。此 Analytics API 限制為 ~5 QPS。有關使用 API 時如何在該請求限制內進行操作的範例,請參閱此Cloud Task 範例

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

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

您的網域和連結元資料將於 2025 年 8 月 25 日標記為刪除,並根據我們的資料保留政策進行清除。

是的,您使用 Firebase 驗證的電子郵件連結驗證將繼續有效。

Firebase 身份驗證目前使用 Firebase 動態鏈接來自定義身份驗證鏈接,但我們將提供更新以確保此功能在 Firebase 動態鏈接服務關閉後繼續工作。

請注意,此功能的延續與將 Firebase 動態連結用於商店和 Web 路由、延遲和常規深度連結的主要用例是分開的,根據上面共享的遷移時間表,這些功能將被棄用。

請參閱「我應該如何從服務遷移」常見問題解答,其中詳細介紹了不同的遷移方案,並提供了各種可用替代方案的遷移指南。