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

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

多年來，網絡和移動生態系統隨著App Links 、 Google Play Instant 、 Universal Links和App 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 路由、延遲和常規深度鏈接的主要用例是分開的，根據上面共享的遷移時間表，這些功能將被棄用。

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

,

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

多年來，網絡和移動生態系統隨著App Links 、 Google Play Instant 、 Universal Links和App 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 路由、延遲和常規深度鏈接的主要用例是分開的，根據上面共享的遷移時間表，這些功能將被棄用。

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