Remote Config-Parameter und ‑Bedingungen

Mit Firebase Remote Config können Sie das Verhalten und das Design Ihrer Anwendungen dynamisch steuern, ohne dass Nutzer ein App-Update herunterladen müssen oder Backend-Bereitstellungen erforderlich sind.

Wenn Sie Ihre Anwendungen konfigurieren möchten, definieren Sie Parameter (Schlüssel/Wert-Paare) in Remote Config und verwenden sie in Ihrer App oder Ihrem Backend-Code. Sie können auch Bedingungen (Targeting-Regeln) definieren, um bedingte Werte zuzuweisen, die die Standardwerte für bestimmte Zielgruppen, Umgebungen oder benutzerdefinierte Kriterien überschreiben.

Remote Config organisiert Parameter und Bedingungen in Vorlagen. Je nach Architektur können Sie Clientvorlagen, Servervorlagen oder beides verwenden:

  • Parameter und Bedingungen in Clientvorlagen: Konfigurationen für Client-App-Instanzen auf Apple-, Android-, Web-, Flutter-, Unity- und C++-Plattformen bereitstellen. Sie können App-Instanzen mithilfe von Google Analytics-Zielgruppen, App-Versionen, Plattform, Gerätesprache, Land, Nutzerperzentilen und benutzerdefinierten clientseitigen Signalen gezielt ansprechen.

  • Parameter und Bedingungen in Servervorlagen: Sie können Konfigurationen für Backend-Umgebungen wie Cloud Run, Cloud Functions for Firebase oder containerisierte Server mit dem Firebase Admin SDK für Node.js, Python, Go und Java bereitstellen. Parameter serverseitig mit nahezu null Latenz mithilfe von benutzerdefinierten Serversignalen und zufälligen prozentualen Roll-outs auswerten.

Client- und Servervorlagen vergleichen

Client- und Servervorlagen dienen unterschiedlichen Architekturen und unterstützen verschiedene SDKs und Targeting-Regeln. Anhand der folgenden Tabelle können Sie feststellen, welcher Vorlagentyp für Ihren Anwendungsfall geeignet ist:

Funktion Clientvorlagen Servervorlagen
Zielumgebungen Client-Apps (Apple, Android, Web, Flutter, Unity, C++) Serverumgebungen (Cloud Run, Cloud Functions for Firebase, GKE, Backend-Dienste)
Unterstützte SDKs Firebase-Client-SDKs Firebase Admin SDK (Node.js, Python, Go, Java)
Bewertungsmodell Wird auf Clientgeräten abgerufen und im Cache gespeichert; wird durch App-Code aktiviert In den Serverspeicher geladen; wird pro Anfrage mit einer Latenz von fast null ausgewertet
Bedingungsregeln App-Version, Betriebssystem/Plattform, Gerätesprache, Land/Region, Analytics-Zielgruppen und -Nutzereigenschaften, Nutzer in zufälligem Perzentil, erstes Öffnen der App, benutzerdefinierte Signale des Clients Nutzer in zufälligem Prozentwert, benutzerdefinierte Signale des Servers
Gängige Anwendungsfälle Funktionseinführungen, saisonale Werbeaktionen, UI-Designs, A/B Testing, Personalisierung KI-Prompt- und Modellauswahl, serverseitige Funktions-Flags, Backend-Ratenbegrenzung, dynamisches Routing
Detaillierte Anleitung Parameter in Clientvorlagen Parameter in Servervorlagen

Wichtige Konzepte

Unabhängig davon, ob Sie mit Client- oder Servervorlagen arbeiten, gelten für Remote Config die folgenden grundlegenden Konzepte:

Parameter

Parameter sind Schlüssel/Wert-Paare, die Sie in der Firebase-Konsole oder über die Remote Config-Backend-APIs definieren.

  • Parameterschlüssel: String-IDs für Ihre Parameter. Schlüssel können bis zu 256 Zeichen lang sein, müssen mit einem Unterstrich oder einem Buchstaben des lateinischen Alphabets (A–Z, a–z) beginnen und dürfen Zahlen enthalten.
  • Parameterwerte: Die Werte, die Ihren Parametern zugewiesen sind. Werte werden als Strings gespeichert. Sie können jedoch in der Console Datentypen auswählen, um Werte mit Formaten wie String, Boolean, Number oder JSON zu validieren.
  • Standardwerte: Der Basiswert, der zugewiesen wird, wenn keine Bedingungsregeln gelten. Sie können In-App-Standardwerte in Ihrem Code sowie Vorlagen-Standardwerte im Remote Config-Backend definieren.

Bedingungen, Regeln und bedingte Werte

Mit Bedingungen können Sie bestimmte Segmente von App-Nutzern oder Serveranfragen mit benutzerdefinierten Parameterwerten ansprechen:

  • Regeln: Einzelne Kriterien, die anhand von Client-Metadaten oder Anfragekontexten (z. B. Versionsnummer, Land oder benutzerdefiniertes Signal) ausgewertet werden.
  • Bedingungen: Benannte Sätze mit einer oder mehreren Regeln. Alle Regeln innerhalb einer Bedingung müssen als true ausgewertet werden, damit die Bedingung als true ausgewertet wird.
  • Bedingte Werte: Alternative Werte, die einem Parameter zugewiesen werden, wenn eine Bedingung als true ausgewertet wird. Wenn mehrere Bedingungen als true ausgewertet werden, hat die Bedingung mit der höchsten Priorität in der Firebase-Konsole Vorrang.

Parametergruppen

Wenn Sie Konfigurationen mit Dutzenden oder Hunderten von Parametern organisieren möchten, können Sie Parametergruppen verwenden. Gruppen ermöglichen eine visuelle Organisation in der Firebase-Konsole und eine logische Gruppierung in der REST API.

  • Ein Parameter kann jeweils nur zu einer Gruppe gehören.
  • Parameterschlüssel bleiben unabhängig von der Gruppierung global eindeutig in Ihrem Projekt.
  • Die Gruppierung hat keinen Einfluss darauf, wie auf Parameterwerte in Ihrem SDK-Code verwiesen wird.

Eine Anleitung zum Erstellen und Verwalten von Gruppen finden Sie in den detaillierten Parameterleitfäden für Clients oder Server.

Versionsverwaltung und Rollbacks für Vorlagen

Jedes Mal, wenn Sie Parameter oder Bedingungen in Remote Config aktualisieren und veröffentlichen, erstellt und speichert Firebase eine neue Version Ihrer Vorlage. Sie können den Versionsverlauf aufrufen, Änderungen zwischen Versionen vergleichen und bei Bedarf ein Rollback auf eine frühere Version durchführen.

Weitere Informationen zur Versionsverwaltung von Vorlagen finden Sie unter Remote Config-Vorlagenversionen verwalten.

Kontingente und Limits

In einem Firebase-Projekt gelten für Remote Config die folgenden Limits:

  • Parameter: Bis zu 3.000 Parameter pro Projekt.
  • Bedingungen: Bis zu 2.000 Bedingungen pro Projekt.
  • Länge des Parameterschlüssels: bis zu 256 Zeichen.
  • Gesamtlänge des Wertstrings: Bis zu 1.000.000 Zeichen für alle Parameterwerte innerhalb eines Projekts.

Eine vollständige Liste der Limits finden Sie unter Kontingente und Limits.

Nächste Schritte