Remote Config-Parameter und ‑Bedingungen in Clientvorlagen

Sie können Remote Config-Parameter und ‑Werte aus Clientvorlagen für alle App-Instanzen bereitstellen, die die Firebase-Client-SDKs für Remote Config implementieren, einschließlich Apple-, Android-, Web-, Flutter-, Unity- und C++-Apps.

Wenn Sie die Firebase-Konsole oder die Remote Config-Backend-APIs verwenden, definieren Sie einen oder mehrere Parameter (Schlüssel/Wert-Paare) und geben In-App-Standardwerte für diese Parameter an. Sie können die In-App-Standardwerte überschreiben, indem Sie Parameterwerte definieren. Parameterschlüssel und Parameterwerte sind Strings, aber Parameterwerte können in andere Datentypen umgewandelt werden, wenn Sie diese Werte in Ihrer App verwenden.

In der Firebase Console, mit Admin SDK oder mit der Remote Config REST API können Sie neue Standardwerte für Ihre Parameter sowie bedingte Werte erstellen, die für die Ausrichtung auf Gruppen von App-Instanzen verwendet werden. Jedes Mal, wenn Sie Ihre Konfiguration in der Firebase-Konsole aktualisieren, erstellt und veröffentlicht Firebase eine neue Version Ihrer Remote Config-Vorlage. Die vorherige Version wird gespeichert, sodass Sie sie bei Bedarf abrufen oder ein Rollback ausführen können. Diese Vorgänge sind in der Firebase Console, der Firebase Admin SDK und der REST API verfügbar und werden unter Remote Config-Vorlagenversionen verwalten ausführlicher beschrieben.

In diesem Leitfaden werden Parameter, Bedingungen, Regeln, bedingte Werte und die Priorisierung verschiedener Parameterwerte im Remote Config-Backend und in Ihrer App erläutert. Außerdem finden Sie hier Details zu den Regeltypen, die zum Erstellen von Bedingungen verwendet werden.

Bedingungen, Regeln und bedingte Werte

Eine Bedingung wird verwendet, um eine Gruppe von App-Instanzen anzusprechen. Bedingungen bestehen aus einer oder mehreren Regeln, die alle als true ausgewertet werden müssen, damit die Bedingung für eine bestimmte App-Instanz als true ausgewertet wird. Wenn der Wert für eine Regel nicht definiert ist (z. B. wenn kein Wert verfügbar ist), wird diese Regel als false ausgewertet.

Beispielsweise könnte ein Parameter, der die Splash-Seite einer App definiert, basierend auf dem Betriebssystemtyp unterschiedliche Bilder anzeigen, wenn die Regel if device_os = Android verwendet wird:

Oder Sie können eine Zeitbedingung verwenden, um zu steuern, wann Ihre App spezielle Werbeartikel anzeigt.

Ein Parameter kann mehrere bedingte Werte haben, die unterschiedliche Bedingungen verwenden. Parameter können Bedingungen innerhalb eines Projekts gemeinsam nutzen. Rufen Sie in der Firebase-Konsole die Seite DevOps & Engagement > Remote Config > Parameter auf, um den Abrufprozentsatz für die bedingten Werte der einzelnen Parameter aufzurufen. Dieser Messwert gibt den Prozentsatz der Anfragen in den letzten 24 Stunden an, die den jeweiligen Wert erhalten haben.

Bedingungen über die Firebase-Konsole hinzufügen, bearbeiten, neu anordnen oder löschen

Sie können Targeting-Bedingungen in der Firebase Console erstellen, bearbeiten, neu anordnen und löschen. Bedingungen werden von allen Parametern innerhalb eines Projekts gemeinsam genutzt. So verwalten Sie Bedingungen:

1. Rufen Sie in der Firebase-Konsole die Seite DevOps & Engagement > Remote Config > Bedingungen auf oder wählen Sie auf der Seite Parameter die Option Bedingungen verwalten aus.
2. Bedingung hinzufügen: Klicken Sie auf Bedingung hinzufügen (oder Erste Bedingung erstellen), geben Sie einen Namen ein, der das Targeting-Ziel definiert, und wählen Sie eine oder mehrere Targeting-Regeln aus.
3. Bedingung bearbeiten: Klicken Sie auf den Namen der Bedingung oder auf das Bearbeitungssymbol, ändern Sie die Regeln nach Bedarf und klicken Sie auf Speichern.
4. Priorität von Bedingungen ändern: Ziehen Sie auf der Seite Bedingungen die Bedingungen am Ziehpunkt, um sie neu anzuordnen. Bedingungen, die weiter oben in der Liste stehen, haben Vorrang vor Bedingungen, die weiter unten stehen.
5. Bedingung löschen: Klicken Sie neben der Bedingung, die Sie entfernen möchten, auf das Löschsymbol. Wenn die Bedingung von einem Parameter referenziert wird, werden durch das Entfernen auch die zugehörigen bedingten Werte entfernt.

Nachdem Sie die Änderungen an den Bedingungen gespeichert haben, veröffentlichen Sie die Vorlage mit Änderungen veröffentlichen.

IPv6-Einschränkung bei IP-basierter Zugriffssteuerung

Remote Config bietet nur eingeschränkte Unterstützung für IPv6, wenn es mit IP-basierten Zugriffsrichtlinien verwendet wird. Wenn Ihre Organisation den Zugriff auf bestimmte öffentliche IP-Bereiche einschränkt, kann die Verbindung über ein IPv6-Netzwerk die folgenden Probleme verursachen:

• Konsolenzugriff: Sie können bestimmte Remote Config-Funktionen in der Firebase-Konsole möglicherweise nicht verwenden, z. B. das Laden von Daten oder das Einrichten von Targeting.
• Clientzugriff: Bei Client-Apps können PERMISSION_DENIED-Fehler auftreten.

Um diese Probleme zu vermeiden, konfigurieren Sie Ihr Netzwerk so, dass IPv4 verwendet wird, oder fügen Sie die erforderlichen Firebase-IP-Bereiche der Zulassungsliste Ihrer Organisation hinzu.

Priorität des Parameterwerts

Einem Parameter können mehrere bedingte Werte zugeordnet sein. Die folgenden Regeln bestimmen, welcher Wert aus der Remote Config-Vorlage abgerufen und welcher Wert in einer bestimmten App-Instanz zu einem bestimmten Zeitpunkt verwendet wird:

1. Zuerst werden bedingte Werte für alle Bedingungen angewendet, die für eine bestimmte Clientanfrage als true ausgewertet werden. Wenn mehrere Bedingungen als true ausgewertet werden, hat die oberste Bedingung in der Firebase-Console-UI Vorrang. Die mit dieser Bedingung verknüpften bedingten Werte werden bereitgestellt, wenn eine App Werte aus dem Backend abruft. Sie können die Priorität von Bedingungen ändern, indem Sie Bedingungen auf der Seite Bedingungen per Drag-and-drop verschieben.

2. Wenn es keine bedingten Werte mit Bedingungen gibt, die als true ausgewertet werden, wird der Standardwert von Remote Config bereitgestellt, wenn eine App Werte aus dem Backend abruft. Wenn ein Parameter im Backend nicht vorhanden ist oder der Standardwert auf In-App-Standardwert verwenden festgelegt ist, wird für diesen Parameter kein Wert bereitgestellt, wenn eine App Werte abruft.

In Ihrer App werden Parameterwerte von get-Methoden gemäß der folgenden Prioritätsliste zurückgegeben:

1. Wenn ein Wert vom Backend abgerufen und dann aktiviert wurde, verwendet die App den abgerufenen Wert. Aktivierte Parameterwerte sind dauerhaft.

2. Wenn kein Wert vom Backend abgerufen wurde oder wenn vom Remote Config-Backend abgerufene Werte nicht aktiviert wurden, verwendet die App den In-App-Standardwert.

   Weitere Informationen zum Abrufen und Festlegen von Standardwerten finden Sie unter Standardwerte für Remote Config-Vorlage herunterladen.

3. Wenn kein In-App-Standardwert festgelegt wurde, verwendet die App einen statischen Typwert (z. B. 0 für int und false für boolean).

In dieser Grafik wird zusammengefasst, wie Parameterwerte im Remote Config-Backend und in Ihrer App priorisiert werden:

Datentypen für Parameterwerte

Mit Remote Config können Sie für jeden Parameter einen Datentyp auswählen. Alle Remote Config-Werte werden vor einer Vorlagenaktualisierung mit diesem Typ abgeglichen. Der Datentyp wird gespeichert und bei einer getRemoteConfig-Anfrage zurückgegeben.

Folgende Datentypen werden unterstützt:

• String
• Boolean
• Number
• JSON

In der Firebase-Konsolen-UI kann der Datentyp aus einem Drop-down-Menü neben dem Parameterschlüssel ausgewählt werden. In der REST API können Typen mit dem Feld value_type im Parameterobjekt festgelegt werden.

Parametergruppen

Mit Remote Config können Sie Parameter gruppieren, um die Benutzeroberfläche übersichtlicher zu gestalten und die Nutzerfreundlichkeit zu verbessern.

Angenommen, Sie müssen drei verschiedene Authentifizierungstypen aktivieren oder deaktivieren, während Sie eine neue Anmeldefunktion einführen. Mit Remote Config können Sie die drei Parameter erstellen, um die gewünschten Typen zu aktivieren, und sie dann in einer Gruppe namens „Neue Anmeldung“ organisieren, ohne Präfixe oder eine spezielle Sortierung hinzufügen zu müssen.

Sie können Parametergruppen mit der Firebase Console oder der Remote Config REST API erstellen. Jede von Ihnen erstellte Parametergruppe hat einen eindeutigen Namen in Ihrer Remote Config-Vorlage. Beachten Sie beim Erstellen von Parametergruppen Folgendes:

• Parameter können jeweils nur in einer Gruppe enthalten sein und ein Parameterschlüssel muss für alle Parameter eindeutig sein.
• Namen von Parametergruppen dürfen maximal 256 Zeichen lang sein.
• Wenn Sie sowohl die REST API als auch die Firebase-Konsole verwenden, achten Sie darauf, dass die REST API-Logik so aktualisiert wird, dass Parametergruppen bei der Veröffentlichung verarbeitet werden.

Parametergruppen mit der Firebase Console erstellen oder ändern

Sie können Parameter in der Firebase-Konsole gruppieren. So erstellen oder ändern Sie eine Gruppe:

1. Rufen Sie in der Firebase-Konsole die Seite DevOps & Engagement > Remote Config > Parameter auf.
2. Wählen Sie Gruppen verwalten aus.
3. Klicken Sie die Kästchen für die Parameter an, die Sie hinzufügen möchten, und wählen Sie In Gruppe verschieben aus.
4. Wählen Sie eine vorhandene Gruppe aus oder erstellen Sie eine neue Gruppe, indem Sie einen Namen und eine Beschreibung eingeben und Neue Gruppe erstellen auswählen. Nachdem Sie eine Gruppe gespeichert haben, kann sie über die Schaltfläche Änderungen veröffentlichen veröffentlicht werden.

Gruppen programmatisch erstellen

Die Remote Config REST API bietet eine automatisierte Möglichkeit, Parametergruppen zu erstellen und zu veröffentlichen. Wenn Sie mit REST vertraut sind und Anfragen an die API autorisieren können, können Sie die folgenden Schritte ausführen, um Gruppen programmatisch zu verwalten:

1. Rufen Sie die aktuelle Vorlage ab.
2. Fügen Sie JSON-Objekte hinzu, um Ihre Parametergruppen darzustellen.
3. Veröffentlichen Sie die Parametergruppen mit einer HTTP-PUT-Anfrage.

Das parameterGroups-Objekt enthält Gruppenschlüssel mit einer verschachtelten Beschreibung und einer Liste gruppierter Parameter. Jeder Gruppenschlüssel muss global eindeutig sein.

Hier ist ein Auszug aus einer Vorlagenversion, in der die Parametergruppe „new menu“ mit dem Parameter pumpkin_spice_season hinzugefügt wird:

{
  "parameters": {},
  "version": {
    "versionNumber": "1",

    …

  },
  "parameterGroups": {
    "new menu": {
      "description": "New Menu",
      "parameters": {
        "pumpkin_spice_season": {
          "defaultValue": {
            "value": "true"
          },
          "description": "Whether it's pumpkin spice season."
        }
      }
    }
  }
}

Bedingungen für benutzerdefinierte Signale

Mit bedingten Werten für benutzerdefinierte Signale können Sie beliebige Signale, die Sie in Ihrer Anwendung definieren und senden, mit Bedingungen abgleichen, die Sie basierend auf den Signalen in Remote Config erstellen. So können Sie die App- oder clientseitige Nutzung anpassen.

Bedingungen für benutzerdefinierte Signale sind für die folgenden Clientumgebungen verfügbar:

• iOS: Version 11.8.0 oder höher
• Android: v22.1.0 oder höher (Firebase BoM v33.8.0 oder höher)
• Web: v11.2.0 oder höher
• Flutter: Flutter BoM-Version 3.6.0 oder höher

Angenommen, Sie arbeiten an einer Ticket-App, bei der Sie ein Banner auf dem Startbildschirm anzeigen möchten. Sie können clientseitige Bedingungen für benutzerdefinierte Signale verwenden, um diese Banner basierend auf dem Standort und den Interessen des Nutzers zu personalisieren. Sie könnten Folgendes tun:

1. Fügen Sie der Remote Config-Kundenvorlage die banner_image_url und die banner_link hinzu. Diese stellen das Bild des Banners und die mit diesem Bild verknüpfte Ereignisseite dar.
2. Legen Sie benutzerdefinierte Signale aus Ihrer App mit den Werten city und preferred_event_category fest.
3. Fügen Sie der clientspezifischen Remote Config-Vorlage Standardwerte hinzu und erstellen Sie bedingte Werte basierend auf den benutzerdefinierten Signalen, die Sie im vorherigen Schritt festgelegt haben.
4. Fügen Sie Ihrer kundenspezifischen Remote Config-Vorlage Standardwerte und bedingte Werte für jede von Ihnen definierte Bedingung hinzu.
5. Aktualisieren Sie Ihren Anwendungscode, um die benutzerdefinierten Signalbedingungen festzulegen und zu verwenden.

Ihre App kann jetzt die entsprechenden banner_image_url und banner_link herunterladen, wenn sie diese Parameter vom Remote Config-Server abruft.

Limits

Beim Erstellen von Bedingungen für benutzerdefinierte Signale müssen Sie die folgenden Limits einhalten:

• Anzahl der benutzerdefinierten Signale: Sie können bis zu 100 benutzerdefinierte Signale pro App-Instanz erstellen. Sie können ein benutzerdefiniertes Signal deaktivieren, indem Sie seinen Wert auf „null“ setzen.
• Name des benutzerdefinierten Signals: Jeder Name eines benutzerdefinierten Signals darf maximal 250 Zeichen lang sein.
• Benutzerdefinierter Signalwert: Jeder benutzerdefinierte Signalwert kann bis zu 500 Zeichen enthalten. Bei regulären Ausdrücken liegt das Limit bei 250 Zeichen.

Regeltypen für Bedingungen

Die folgenden Regeltypen werden in der Firebase-Konsole unterstützt. Entsprechende Funktionen sind in der Remote Config REST API verfügbar, wie in der Referenz zu bedingten Ausdrücken beschrieben.

Suchparameter und ‑bedingungen

Sie können die Parameterschlüssel, Parameterwerte und Bedingungen Ihres Projekts in der Firebase-Konsole über das Suchfeld oben auf der Seite DevOps & Engagement > Remote Config > Parameter durchsuchen.

Limits für Parameter und Bedingungen

In einem Firebase-Projekt können Sie bis zu 3.000 Parameter und bis zu 2.000 Bedingungen haben. Parameterschlü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 auch Zahlen enthalten. Die Gesamtlänge der Parameterwert-Strings innerhalb eines Projekts darf 1.000.000 Zeichen nicht überschreiten. Außerdem können Bedingungsregeln, die auf Nutzereigenschaften basieren, bis zu 100 Nutzereigenschaftswerte enthalten. Eine vollständige Liste der Limits finden Sie unter Kontingente und Limits.

Änderungen an Parametern und Bedingungen ansehen

Sie können die neuesten Änderungen an Ihren Remote Config-Vorlagen in der Firebase-Konsole aufrufen. Für jeden einzelnen Parameter und jede Bedingung haben Sie folgende Möglichkeiten:

• Name des Nutzers, der den Parameter oder die Bedingung zuletzt geändert hat.

• Wenn die Änderung am selben Tag vorgenommen wurde, sehen Sie die Anzahl der Minuten oder Stunden, die seit der Veröffentlichung der Änderung in der aktiven Remote Config-Vorlage vergangen sind.

• Wenn die Änderung vor einem oder mehreren Tagen vorgenommen wurde, sehen Sie sich das Datum an, an dem die Änderung in der aktiven Remote Config-Vorlage veröffentlicht wurde.

Änderungsverlauf für Parameter

Rufen Sie in der Firebase-Konsole die Seite DevOps & Engagement > Remote Config > Parameter auf. In der Spalte Zuletzt veröffentlicht sehen Sie, wer den jeweiligen Parameter zuletzt geändert hat und wann die Änderung veröffentlicht wurde:

• Wenn Sie Änderungsmetadaten für gruppierte Parameter aufrufen möchten, maximieren Sie die Parametergruppe.

• Wenn Sie die Liste nach Veröffentlichungsdatum aufsteigend oder absteigend sortieren möchten, klicken Sie auf die Spaltenüberschrift Zuletzt veröffentlicht.

Änderungsverlauf für Bedingungen

Rufen Sie in der Firebase Console die Seite DevOps & Engagement > Remote Config > Bedingungen auf. Neben Zuletzt geändert unter jeder Bedingung sehen Sie den letzten Nutzer, der die Bedingung geändert hat, und das Datum, an dem sie geändert wurde.

Nächste Schritte

Informationen zum Konfigurieren Ihres Firebase-Projekts und Ihrer App für die Verwendung von Remote Config finden Sie unter Erste Schritte mit Firebase Remote Config.