Sie können Vorlagen sowohl für Client- als auch für Serveranwendungen konfigurieren. Client-Vorlagen werden an alle App-Instanzen gesendet, die die Firebase-Client-SDKs für Remote Config implementieren, einschließlich Android-, Apple-, Web-, Unity-, Flutter- und C++-Apps. Remote Config Parameter und Werte aus serverspezifische Vorlagen werden in Remote Config-Implementierungen ausgeliefert (einschließlich Cloud Run und Cloud Functions), die die Firebase Admin-Konsole verwenden Node.js SDK ab Version 12.1.0
Wenn Sie die Firebase Console 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 in andere Datentypen umwandeln, wenn Sie diese Werte in für Ihre App.
Über die Firebase-Konsole Admin SDK oder die Remote Config REST API können Sie neue Standardwerte für Ihre Parameter und bedingte Werte, die für die Ausrichtung auf App-Gruppen verwendet werden, Instanzen. 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 durchführen können. Diese Vorgänge sind in der Firebase-Konsole verfügbar: Firebase Admin SDK und der REST API und ausführlicher beschrieben in Remote Config Vorlagenversionen verwalten.
In diesem Leitfaden werden Parameter, Bedingungen, Regeln und und die Priorisierung verschiedener Parameterwerte Remote Config im Back-End und in Ihrer Anwendung. Sie enthält auch Details zum Regeltypen, mit denen Bedingungen erstellt werden.
Bedingungen, Regeln und bedingte Werte
Mit einer Bedingung wird eine Gruppe von App-Instanzen ausgewählt. Bedingungen erfüllt sind
aus einer oder mehreren Regeln, die alle den Wert true ergeben müssen, damit die Bedingung
für eine bestimmte Anwendungsinstanz als true auszuwerten. Wenn der Wert für eine Regel nicht definiert ist (z. B. wenn kein Wert verfügbar ist), wird für diese Regel false zurückgegeben.
Sie können beispielsweise einen Parameter erstellen, der den Namen und den Versionsstring eines Large Language Models (LLM) definiert, und Antworten von verschiedenen Modellen basierend auf benutzerdefinierten Signalregeln ausliefern. In diesem Anwendungsfall können Sie eine stabile Modellversion als Standardwert verwenden, um die meisten Anfragen zu bedienen, und das benutzerdefinierte Signal verwenden, um mit einem experimentellen Modell auf Clientanfragen zu reagieren.
Ein Parameter kann mehrere bedingte Werte mit unterschiedlichen Bedingungen haben. Außerdem können Parameter innerhalb eines Projekts gemeinsame Bedingungen haben. Auf dem Tab Parameter der Firebase-Konsole können Sie den Abrufprozentsatz für jede bedingten Werte des Parameters. Dieser Messwert gibt den Prozentsatz der Anfragen an, in den letzten 24 Stunden.
Priorität des Parameterwerts
Mit einem Parameter können mehrere bedingte Werte verknüpft sein. Anhand der folgenden Regeln wird festgelegt, welcher Wert aus der Remote Config-Vorlage abgerufen und welcher Wert in einer bestimmten App-Instanz zu einem bestimmten Zeitpunkt verwendet wird:
Zuerst werden bedingte Werte für alle Bedingungen angewendet, die für eine bestimmte Kundenanfrage zu
trueführen. Wenn mehrere Bedingungen zutrueführen, hat die erste (oberste) Bedingung in der Firebase-Benutzeroberfläche der Console Vorrang. Die zugehörigen bedingten Werte werden bereitgestellt, wenn eine App Werte aus dem Backend abruft. Sie können die Priorität von Bedingungen ändern, indem Sie und löschen Sie Bedingungen auf dem Tab Bedingungen.Wenn es keine bedingten Werte mit Bedingungen gibt, die zu
trueführen, wird der Standardwert von Remote Config angegeben, wenn eine App Werte aus dem Backend abruft. Wenn ein Parameter im Backend nicht vorhanden ist oder der Standardwert auf In-App-Standard verwenden festgelegt ist, wird für diesen Parameter kein Wert angegeben, wenn eine App Werte abruft.
In Ihrer App werden Parameterwerte von get-Methoden gemäß der folgenden Prioritätsliste zurückgegeben.
- Wenn ein Wert aus dem Backend abgerufen und dann aktiviert wurde, verwendet die App den abgerufenen Wert. Aktivierte Parameterwerte bleiben erhalten.
Wenn kein Wert aus dem Backend abgerufen wurde oder die aus dem Remote Config-Backend abgerufenen Werte nicht aktiviert wurden, verwendet die App den In-App-Standardwert.
Weitere Informationen zum Abrufen und Festlegen von Standardwerten finden Sie unter Standardvorlagen für Remote Config herunterladen
Wenn kein In-App-Standardwert festgelegt wurde, verwendet die App einen statischen Typ Wert (z. B.
0fürintundfalsefürboolean).
Diese Grafik fasst zusammen, wie Parameterwerte in der Remote Config im Back-End und in Ihrer Anwendung:
Datentypen für Parameterwerte
Mit Remote Config können Sie für jeden Parameter einen Datentyp auswählen. Vor dem Aktualisieren einer Vorlage werden alle Remote Config-Werte anhand dieses Typs validiert. Der Datentyp wird in einem getRemoteConfig gespeichert und zurückgegeben.
Folgende Datentypen werden unterstützt:
StringBooleanNumberJSON
In der Firebase-Benutzeroberfläche kann der Datentyp über ein 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 zu organisieren und die Nutzerfreundlichkeit zu verbessern.
Angenommen, Sie müssen beim Einführen einer neuen Anmeldefunktion drei verschiedene Authentifizierungstypen aktivieren oder deaktivieren. Mit Remote Config können Sie die drei Parameter, um die gewünschten Typen zu aktivieren. mit dem Namen „Neue Anmeldung“ ohne Präfixe oder spezielle Sortierung.
Sie können Parametergruppen mit der Firebase Console oder der Remote Config REST API erstellen. Jede von Ihnen erstellte Parametergruppe hat in der Remote Config-Vorlage einen eindeutigen Namen. Beachten Sie beim Erstellen von Parametergruppen Folgendes:
- Parameter können jeweils nur in einer Gruppe enthalten sein. Ein Parameter Schlüssel muss über alle Parameter hinweg eindeutig sein.
- Parametergruppennamen sind auf 256 Zeichen beschränkt.
- Wenn Sie sowohl die REST API als auch die Firebase-Konsole verwenden, achten Sie darauf, dass alle Die REST API-Logik wurde aktualisiert, um Parametergruppen bei der Veröffentlichung zu verarbeiten.
Parametergruppen mit der Firebase-Console erstellen oder ändern
Sie können Parameter auf dem Tab Parameter der Firebase-Konsole gruppieren. So erstellen oder ändern Sie eine Gruppe:
- Wählen Sie Gruppen verwalten aus.
- Klicken Sie die Kästchen für die Parameter an, die Sie hinzufügen möchten, und wählen Sie In Gruppe verschieben
- 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, können Sie sie über die Schaltfläche Änderungen veröffentlichen veröffentlichen.
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.
| Regeltyp | Betreiber | Wert(e) | Hinweis |
| App | == | App-IDs für Apps, die mit Firebase verknüpft sind, aus einer Liste auswählen Projekt arbeiten. | Wenn Sie eine App zu Firebase hinzufügen, geben Sie eine Bundle-ID oder Android ein
Paketname, der ein Attribut definiert, das in der folgenden Tabelle als App-ID offengelegt wird.
Remote Config-Regeln.
Verwenden Sie dieses Attribut so:
|
| App-Version |
Für Stringwerte: stimmt genau überein, enthält, enthält nicht, enthält Regex Für numerische Werte: <, <=, =, !=, >, >= |
Geben Sie die Versionen Ihrer App an, auf die Sie Ihre Anzeigen ausrichten möchten. Bevor Sie diese Regel verwenden können, müssen Sie mit einer App-ID-Regel eine Android- oder Apple-App auswählen, die mit Ihrem Firebase-Projekt verknüpft ist. |
Apple-Plattformen: Verwenden Sie die CFBundleShortVersionString der App. Hinweis:Achten Sie darauf, dass Ihre Apple-App das Firebase Apple Platform SDK verwendet. Version 6.24.0 oder höher, da CFBundleShortVersionString nicht im früheren Versionen (siehe Versionshinweise). Android:Geben Sie den versionName der App ein. Bei Stringvergleichen für diese Regel wird die Groß- und Kleinschreibung beachtet. Bei Verwendung des stimmt genau überein, enthält, enthält nicht oder enthält Regex können Sie mehrere Werte auswählen. Mit dem Operator enthält Regex können Sie reguläre Ausdrücke in RE2 Format. Ihr regulärer Ausdruck kann mit dem gesamten oder einem Teil des Zielversionsstrings übereinstimmen. Sie können auch die Anker ^ und $ verwenden, um den Anfang, das Ende oder den gesamten Zielstring abzugleichen. |
| Build-Nummer |
Für Stringwerte: stimmt genau überein, enthält, enthält nicht, regulärer Ausdruck Für numerische Werte: =, ≠, >, ≥, <, ≤ |
Geben Sie die Builds Ihrer App an, auf die Sie abzielen möchten. Bevor Sie diese Regel verwenden, müssen Sie eine App-ID-Regel verwenden, um eine Apple- oder Android-App, die mit Ihrem Firebase-Projekt verknüpft ist. |
Dieser Operator ist nur für Apple- und Android-Apps verfügbar. Sie entspricht dem CFBundleVersion für Apple und versionCode für Android. Stringvergleiche für diese Regel sind Groß- und Kleinschreibung berücksichtigen. Bei Verwendung von stimmt genau überein, enthält, enthält nicht oder enthält Regex können Sie mehrere Werte auswählen. Mit dem Operator enthält Regex können Sie reguläre Ausdrücke in RE2 Format. Der reguläre Ausdruck kann mit der gesamten oder einem Teil der Zielversion übereinstimmen . Sie können auch die Anker ^ und $ verwenden, Anfang, Ende oder als Ganzes eines Zielstrings. |
| Plattform | == | iOS Android Web |
|
| Betriebssystem | == |
Geben Sie die Betriebssysteme für das Targeting an. Bevor Sie diese Regel verwenden, müssen Sie eine App-ID-Regel verwenden, um eine Mit Ihrem Firebase-Projekt verknüpfte Web-App. |
Diese Regel wird für eine bestimmte Instanz der Webanwendung mit true ausgewertet, wenn das Betriebssystem und seine Version mit einem Zielwert in der angegebenen Liste übereinstimmen.
|
| Browser | == |
Geben Sie die Browser an, auf die Sie Ihre Anzeigen ausrichten möchten. Bevor Sie diese Regel verwenden, müssen Sie eine App-ID-Regel verwenden, um eine Mit Ihrem Firebase-Projekt verknüpfte Web-App. |
Diese Regel ergibt für eine bestimmte Instanz der Webanwendung den Wert true, wenn der Browser und seine Version mit einem Zielwert in der angegebenen Liste übereinstimmen.
|
| Gerätekategorie | ist, ist nicht | mobil | Mit dieser Regel wird ermittelt, ob das Gerät, von dem aus auf Ihre Webanwendung zugegriffen wird, ein Mobilgerät oder ein Computer (Desktop oder Konsole) ist. Dieser Regeltyp ist nur für das Web verfügbar Apps. |
| Sprachen | ist in | Wählen Sie eine oder mehrere Sprachen aus. | Diese Regel ergibt für eine bestimmte App-Instanz den Wert true, wenn diese App-Instanz auf einem Gerät installiert ist, auf dem eine der aufgeführten Sprachen verwendet wird.
|
| Land/Region | ist in | Wählen Sie eine oder mehrere Regionen oder Länder aus. | Diese Regel wird für eine bestimmte App-Instanz als true ausgewertet, wenn sich die Instanz in einer der aufgeführten Regionen oder Länder befindet. Ländercode des Geräts
wird anhand der IP-Adresse des Geräts in der Anfrage oder des Ländercodes ermittelt
werden von Firebase Analytics ermittelt, sofern Analytics-Daten für Firebase freigegeben werden.
|
| Nutzerzielgruppe(n) | Enthält mindestens eines | Wählen Sie mindestens eine Zielgruppe aus der Liste von Google Analytics Zielgruppen aus, die Sie für Ihr Projekt eingerichtet haben. | Für diese Regel ist eine App-ID-Regel erforderlich, um eine App auszuwählen, die mit Ihrem Firebase-Projekt Hinweis:Da viele Analytics-Zielgruppen durch Ereignisse oder Nutzereigenschaften, die auf den Aktionen von App-Nutzern basieren können, einige Zeit, bis die Regel Nutzer in Zielgruppe für eine bestimmte App wirksam wird Instanz. |
| Nutzereigenschaft |
Für Stringwerte:
enthält, enthält nicht, stimmt genau überein, enthält Regex Für numerische Werte: =, ≠, >, ≥, <, ≤ Hinweis: Auf dem Client können Sie nur Stringwerte für Nutzer festlegen. Eigenschaften. Für Bedingungen mit numerischen Operatoren Remote Config wandelt den Wert des entsprechenden Nutzereigenschaft in eine Ganzzahl/Gleitkommazahl umzuwandeln. |
Google Analytics-Nutzer aus einer Liste auswählen Eigenschaften. | Hier erfahren Sie, wie Sie Ihre App mithilfe von Nutzereigenschaften für
Segmente Ihrer Nutzerbasis ermitteln,
Remote Config und Nutzereigenschaften.
Weitere Informationen zu Nutzereigenschaften finden Sie in den folgenden Leitfäden: Bei Verwendung von stimmt genau überein, enthält, enthält nicht oder enthält Regex können Sie mehrere Werte auswählen. Mit dem Operator enthält Regex können Sie reguläre Ausdrücke in RE2 Format. Der reguläre Ausdruck kann mit der gesamten oder einem Teil der Zielversion übereinstimmen . Sie können auch die Anker ^ und $ verwenden, um den Anfang, das Ende oder den gesamten Zielstring abzugleichen. Hinweis:Automatisch erfasste Nutzereigenschaften sind beim Erstellen von Remote Config-Bedingungen nicht verfügbar. |
| Nutzer in zufälliger Prozentzahl | Schieberegler (in der Firebase Console. Die
Verwendung der REST API
die Operatoren <=, > und between).
|
0–100 |
Verwenden Sie dieses Feld, um eine Änderung auf eine zufällige Stichprobe von App-Instanzen (mit so kleinen Stichprobengrößen) anzuwenden als 0,0001%), mit dem Schieberegler-Widget, um zufällig zufällige Nutzer (App-Instanzen) in Gruppen. Jede Anwendungsinstanz wird dauerhaft einer zufälligen Ganzzahl oder Bruchzahl zugeordnet, seed, der in diesem Projekt definiert ist. Eine Regel verwendet den Standardschlüssel, der in der Firebase-Konsole als Seed bearbeiten angezeigt wird, es sei denn, Sie den Seed-Wert ändern. Sie können eine Regel zur Verwendung des Standardschlüssels zurücksetzen, indem Sie die Seed (Seed) ein. Verwenden Sie denselben Seed-Wert, um innerhalb bestimmter Prozentbereiche konsistent die gleichen App-Instanzen anzusprechen. für alle Bedingungen. Oder wählen Sie eine neue zufällig zugewiesene Gruppe von App-Instanzen für eine bestimmte indem Sie einen neuen Startwert angeben. Um beispielsweise zwei miteinander in Beziehung stehende Bedingungen zu erstellen, die jeweils für 5% des Bereichs einer App gelten, der sich nicht überschneidet, können Sie eine Bedingung so konfigurieren, dass sie einem Prozentsatz zwischen 0% und 5% entspricht, und um einen Bereich zwischen 5% und 10 % abzugleichen. Damit einige Nutzer verwenden Sie unterschiedliche Startwerte für die Regeln innerhalb der jeweiligen Bedingung. |
| Importiertes Segment | ist in | Wählen Sie ein oder mehrere importierte Segmente aus. | Für diese Regel müssen Sie benutzerdefinierte importierte Segmente einrichten. |
| Datum/Uhrzeit | Vorher, Nachher | Datum und Uhrzeit, entweder in der Zeitzone des Geräts oder an einem bestimmten Zeitzone wie „(GMT+11) Sydney-Zeit“. | Vergleicht die aktuelle Uhrzeit mit der Abrufzeit des Geräts. |
| Erstes Öffnen | Vorher, Nachher | Ein bestimmtes Datum und eine bestimmte Uhrzeit in der angegebenen Zeitzone. | Die Ausrichtung erfolgt auf Nutzer, die die App, auf die ausgerichtet wird, innerhalb des angegebenen Zeitraums zum ersten Mal öffnen. Folgende SDKs sind erforderlich:
|
| Installations-ID | ist in | Geben Sie eine oder mehrere Installations-IDs (bis zu 50) für das Ziel an. | Diese Regel wird für eine bestimmte Installation als true ausgewertet, wenn
Die Installations-ID befindet sich in der durch Kommas getrennten Liste von Werten.
Informationen zum Abrufen von Installations-IDs finden Sie unter Client-IDs abrufen. |
| Nutzer existiert | (kein Operator) | Ein Targeting auf alle Nutzer aller Apps im aktuellen Projekt. |
Mit dieser Bedingungsregel können Sie alle Nutzer im Projekt abgleichen, unabhängig von App oder Plattform. |
Suchparameter und -bedingungen
Sie können in den Parameterschlüsseln, Parameterwerten und Bedingungen Ihres Projekts suchen in der Firebase-Konsole mithilfe des Suchfeld oben auf dem Tab Remote Config Parameter.
Beschränkungen für Parameter und Bedingungen
Innerhalb eines Firebase-Projekts können Sie bis zu 2.000 Parameter und bis zu 500 Bedingungen verwenden. Parameterschlüssel können bis zu 256 Zeichen lang sein, müssen mit einem Unterstrich oder einem lateinischen Buchstaben (A–Z, a–z) beginnen und dürfen Zahlen enthalten. Die Gesamtlänge der Parameterwertstrings innerhalb eines Projekts darf 1.000.000 Zeichen nicht überschreiten.
Änderungen an Parametern und Bedingungen ansehen
Die letzten Änderungen an Ihren Remote Config-Vorlagen können Sie in der Firebase-Konsole einsehen. Für jeden einzelnen Parameter und jede einzelne Bedingung haben Sie folgende Möglichkeiten:
Der Name des Nutzers, der den Parameter oder die Bedingung zuletzt geändert hat.
Wenn die Änderung am selben Tag aufgetreten ist, sehen Sie sich die Anzahl der Minuten oder Stunden, die seit der Veröffentlichung der Änderung im Vorlage „Remote Config“.
Wenn die Änderung vor mindestens einem Tag stattgefunden hat, sehen Sie sich das Datum an, an dem die Änderung in der aktiven Remote Config-Vorlage veröffentlicht wurde.
Änderungsverlauf für Parameter
Auf der Seite Remote ConfigParameter wird in der Spalte Zuletzt veröffentlicht der Nutzer angezeigt, der den jeweiligen Parameter zuletzt geändert hat, sowie das Datum der letzten Veröffentlichung der Änderung:
Wenn Sie die Änderungsmetadaten für gruppierte Parameter aufrufen möchten, maximieren Sie die Parametergruppe.
Wenn Sie nach dem Veröffentlichungsdatum in aufsteigender oder absteigender Reihenfolge sortieren möchten, klicken Sie auf das Spaltenlabel Zuletzt veröffentlicht.
Änderungsverlauf für Bedingungen
Auf der Seite Remote Config Bedingungen sehen Sie neben jeder Bedingung unter Letzte Änderung den Nutzer, der die Bedingung zuletzt geändert hat, und das Datum der Änderung.