Firebase Remote Config 可讓您動態控制應用程式的行為和外觀,使用者不必下載應用程式更新,您也不必重新部署後端。
如要設定應用程式,請在 Remote Config 中定義參數 (鍵/值組合),並在應用程式或後端程式碼中使用這些參數。您也可以定義條件 (指定規則),指派條件值,覆寫特定目標對象、環境或自訂條件的預設值。
Remote Config 會將參數和條件整理成範本。視架構而定,您可以使用用戶端範本、伺服器範本,或兩者並用:
用戶端範本中的參數和條件:將設定提供給 Apple、Android、Web、Flutter、Unity 和 C++ 平台上的用戶端應用程式執行個體。使用 Google Analytics 目標對象、應用程式版本、平台、裝置語言、國家/地區、使用者百分位數和用戶端自訂信號,指定應用程式執行個體。
伺服器範本中的參數和條件:使用 Firebase Admin SDK 搭配 Node.js、Python、Go 和 Java,將設定提供給後端環境,例如 Cloud Run、Cloud Functions for Firebase 或容器化伺服器。使用伺服器自訂信號和隨機百分比推出,在伺服器端評估參數,延遲時間趨近於零。
比較用戶端和伺服器範本
用戶端和伺服器範本適用於不同架構,並支援不同的 SDK 和指定規則。請參閱下表,瞭解哪種範本類型適合您的用途:
| 功能 | 用戶端範本 | 伺服器範本 |
|---|---|---|
| 目標環境 | 用戶端應用程式 (Apple、Android、網頁、Flutter、Unity、C++) | 伺服器環境 (Cloud Run、Cloud Functions for Firebase、GKE、後端服務) |
| 支援的 SDK | Firebase 用戶端 SDK | Firebase Admin SDK (Node.js、Python、Go、Java) |
| 評估模型 | 在用戶端裝置上擷取及快取,並由應用程式程式碼啟用 | 載入伺服器記憶體;每次要求都會評估,延遲時間趨近於零 |
| 條件規則 | 應用程式版本、OS/平台、裝置語言、國家/地區、Analytics目標對象和使用者屬性、隨機百分位數中的使用者、初次開啟應用程式、用戶端自訂信號 | 隨機百分比中的使用者、伺服器自訂信號 |
| 常見用途 | 功能推出、季節性促銷活動、UI 主題、A/B Testing、個人化 | AI 提示和模型選取、伺服器端功能旗標、後端頻率限制、動態轉送 |
| 詳細指南 | 用戶端範本中的參數 | 伺服器範本中的參數 |
核心概念
無論您使用的是用戶端範本還是伺服器範本,Remote Config 都會共用基本概念:
參數
參數是您在 Firebase 控制台或使用Remote Config後端 API 定義的鍵/值組合。
- 參數鍵:參數的字串 ID。鍵的長度上限為 256 個字元,開頭須為底線或英文字母 (A 至 Z、a 至 z),可包含數字。
- 參數值:指派給參數的值。值會以字串形式儲存,但您可以在控制台中選取資料類型,根據
String、Boolean、Number或JSON等格式驗證值。 - 預設值:未套用任何條件規則時,系統指派的基準值。您可以在程式碼中定義應用程式內預設值,也可以在 Remote Config 後端定義範本預設值。
條件、規則和條件值
您可以透過條件,指定特定應用程式使用者區隔或伺服器要求,並提供自訂參數值:
- 規則:根據用戶端中繼資料或要求情境 (例如版本號碼、國家/地區或自訂信號) 評估的個別條件。
- 條件:一或多項規則的命名組合。條件中的所有規則都必須評估為
true,條件才會評估為true。 - 條件值:條件評估為
true時,指派給參數的替代值。如果多個條件的評估結果為true,則以 Firebase 控制台中優先順序最高的條件為準。
參數群組
如要整理含有數十或數百個參數的設定,可以使用參數群組。群組在 Firebase 控制台中提供視覺化組織,在 REST API 中提供邏輯群組。
- 一個參數一次只能屬於一個群組。
- 無論分組方式為何,參數鍵在整個專案中仍會保持全域不重複。
- 分組不會改變 SDK 程式碼參照參數值的方式。
如需建立及管理群組的操作說明,請參閱用戶端或伺服器參數的詳細指南。
範本版本管理和復原
每次在 Remote Config 中更新及發布參數或條件時,Firebase 都會建立並儲存新版範本。您可以查看版本記錄、比較版本之間的差異,並視需要復原至先前的版本。
如要進一步瞭解範本版本管理,請參閱「管理 Remote Config 範本版本」。
配額與限制
在 Firebase 專案中,Remote Config會強制執行下列限制:
- 參數:每項專案最多 3,000 個參數。
- 條件:每項專案最多 2,000 個條件。
- 參數鍵長度:最多 256 個半形字元。
- 值字串總長度:專案中所有參數值最多可達 1,000,000 個字元。
如需完整的限制清單,請參閱「配額與限制」。
後續步驟
- 用戶端應用程式:請參閱「用戶端範本中的參數和條件」,瞭解如何設定參數、指定規則和優先順序。
- 伺服器應用程式:請參閱「伺服器範本中的參數和條件」,瞭解如何設定伺服器參數、自訂信號和伺服器評估。
- 開始使用用戶端 SDK:按照「開始使用 Firebase Remote Config」指南設定用戶端應用程式。
- 開始使用伺服器 SDK:請參閱「在伺服器環境中使用 Remote Config」指南,設定後端環境。
- 自動更新:請參閱「以程式輔助方式修改 Remote Config」,瞭解如何以程式輔助方式修改範本。