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 oder das Backend neu bereitgestellt werden muss.

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

In Remote Config werden Parameter und Bedingungen in Vorlagen organisiert. 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, Nutzer-Perzentilen und clientseitigen benutzerdefinierten Signalen ausrichten.

  • Parameter und Bedingungen in Servervorlagen: 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 Rollouts auswerten

Client- und Servervorlagen vergleichen

Client- und Servervorlagen sind für unterschiedliche Architekturen vorgesehen und unterstützen verschiedene SDKs und Targeting-Regeln. Anhand der folgenden Tabelle können Sie ermitteln, 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 Auf Clientgeräten abgerufen und im Cache gespeichert; durch App-Code aktiviert In den Serverspeicher geladen; wird pro Anfrage mit nahezu null Latenz ausgewertet
Bedingungsregeln App-Version, Betriebssystem/Plattform, Gerätesprache, Land/Region, Analytics Zielgruppen und Nutzerattribute, Nutzer im zufälligen Perzentil, erstes Öffnen der App, benutzerdefinierte Clientsignale Nutzer in zufälligem Prozentsatz, benutzerdefinierte Serversignale
Gängige Anwendungsfälle Funktionseinführungen, saisonale Angebote, Benutzeroberflächenthemen, A/B Testing, Personalisierung KI-Prompts und Modellauswahl, serverseitige Feature-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 folgende grundlegende Konzepte:

Parameter

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

  • Parameterschlüssel: Stringkennungen 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 anhand von 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 und Vorlagenstandardwerte 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 Gruppen mit einer oder mehreren Regeln. Alle Regeln in 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

Um Konfigurationen mit Dutzenden oder Hunderten von Parametern zu organisieren, können Sie Parametergruppen verwenden. Gruppen sorgen für eine visuelle Organisation in der Firebase-Konsole und eine logische Gruppierung in der REST API.

  • Ein Parameter kann jeweils nur einer Gruppe angehören.
  • Parameterschlüssel bleiben in Ihrem Projekt unabhängig von der Gruppierung global eindeutig.
  • Die Gruppierung ändert nicht, 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 für Vorlagen und Rollbacks

Jedes Mal, wenn Sie Parameter oder Bedingungen in Remote Config aktualisieren und veröffentlichen, wird in Firebase eine neue Version Ihrer Vorlage erstellt und gespeichert. Sie können den Versionsverlauf aufrufen, Änderungen zwischen Versionen vergleichen und bei Bedarf zu einer früheren Version zurückkehren.

Weitere Informationen zur Verwaltung von Vorlagenversionen 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 in einem Projekt.

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

Nächste Schritte