遠端設定參數和條件

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 個字元。

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

後續步驟