遠端設定參數和條件

Firebase Remote Config 可讓您動態控管應用程式的行為和外觀,不必要求使用者下載應用程式更新,也不必重新部署後端。

如要設定應用程式,請在 Remote Config 中定義參數 (鍵/值組合),並在應用程式或後端程式碼中使用這些參數。您也可以定義條件 (指定目標規則),指派條件式值,針對特定目標對象、環境或自訂條件,覆寫預設值。

Remote Config 會將參數和條件彙整在範本中。 視架構而定,您可以使用用戶端範本、伺服器範本或兩者:

  • 用戶端範本中的參數和條件: 在 Apple、Android、Web、 Flutter、Unity 和 C++ 平台,為用戶端應用程式執行個體提供設定。使用Google Analytics目標對象、應用程式版本、平台、裝置語言、國家/地區、使用者百分位數和用戶端自訂信號,指定應用程式例項。

  • 伺服器範本中的參數和條件: 使用 Node.js、Python、Go 和 Java 的 Firebase Admin SDK,將設定提供給後端環境,例如 Cloud Run、Cloud Functions for Firebase 或容器化伺服器。使用伺服器自訂信號和隨機百分比推出功能,以趨近於零的延遲時間評估伺服器端的參數。

比較用戶端和伺服器範本

用戶端和伺服器範本適用於不同架構,並支援不同的 SDK 和指定目標規則。請參閱下表,瞭解哪種範本類型適合您的用途:

功能 用戶端範本 伺服器範本
目標環境 用戶端應用程式 (Apple、Android、Web、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 個字元。

如需完整限制清單,請參閱「配額與限制」。

後續步驟