Google 致力于为黑人社区推动种族平等。查看具体举措
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Remote-Konfigurationsparameter und -bedingungen

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 In-App-Standardwerte überschreiben, indem Sie serverseitige Parameterwerte definieren. Parameterschlüssel und Parameterwerte sind Zeichenfolgen, aber Parameterwerte können als andere Datentypen umgewandelt werden, wenn Sie diese Werte in Ihrer App verwenden.

Mithilfe der Firebase-Konsole oder der Remote Config REST-API können Sie neue Standardwerte für Ihre Parameter sowie bedingte Werte erstellen, die für Zielgruppen 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 nach Bedarf abrufen oder zurücksetzen können. Diese Vorgänge stehen Ihnen auch über die REST-API zur Verfügung.

In diesem Handbuch werden Parameter, Bedingungen, Regeln, bedingte Werte und die Priorisierung verschiedener Parameterwerte auf dem Remote Config Server und in Ihrer App erläutert. Es enthält auch Details zu den Regeltypen, die zum Erstellen von Bedingungen verwendet werden.

Bedingungen, Regeln und bedingte Werte

Eine Bedingung wird verwendet, um auf eine Gruppe von App-Instanzen abzuzielen. 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 undefiniert ist (z. B. wenn kein Wert verfügbar ist), wird diese Regel als false ausgewertet.

Beispielsweise kann ein Parameter, der die if device_os = Android einer App definiert, je nach Betriebssystemtyp verschiedene Bilder anzeigen, wobei die einfache Regel verwendet wird, if device_os = Android :

Oder eine Zeitbedingung kann verwendet werden, um zu steuern, wann Ihre App spezielle Werbeartikel anzeigt.

Ein Parameter kann mehrere bedingte Werte haben, die unterschiedliche Bedingungen verwenden, und Parameter können Bedingungen innerhalb eines Projekts gemeinsam nutzen. Auf der Registerkarte Parameter der Firebase-Konsole können Sie den Abrufprozentsatz für die bedingten Werte der einzelnen Parameter anzeigen. Diese Metrik gibt den Prozentsatz der Anfragen in den letzten 24 Stunden an, die jeden Wert erhalten haben.

Parameterwertpriorität

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

Serverseitige Parameterwerte werden gemäß der folgenden Prioritätsliste abgerufen

  1. Zunächst werden bedingte Werte angewendet, wenn Bedingungen vorliegen, die für eine bestimmte App-Instanz als true ausgewertet werden. Wenn mehrere Bedingungen als true ausgewertet werden, hat die erste (obere) Bedingung, die in der Benutzeroberfläche der Firebase-Konsole angezeigt wird, Vorrang, und mit dieser Bedingung verknüpfte bedingte Werte werden bereitgestellt, wenn eine App Werte aus dem Backend abruft. Sie können die Priorität der Bedingungen ändern durch Ziehen und Bedingungen in der Registerkarte Bedingungen fallen zu lassen.

  2. Wenn es keine bedingten Werte mit Bedingungen gibt, die als true ausgewertet werden, wird der serverseitige Standardwert bereitgestellt, wenn eine App Werte aus dem Backend abruft. Wenn im Backend kein Parameter vorhanden ist oder der Standardwert auf Kein Wert 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

  1. Wenn ein Wert aus dem Backend abgerufen und dann aktiviert wurde, verwendet die App den abgerufenen Wert. Aktivierte Parameterwerte bleiben bestehen.
  2. Wenn kein Wert aus dem Backend abgerufen wurde oder wenn Werte, die aus dem Remote Config-Backend abgerufen wurden, nicht aktiviert wurden, verwendet die App den Standardwert in der App.
  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 ).

Diese Grafik fasst zusammen, wie Parameterwerte im Remote Config-Backend und in Ihrer App priorisiert werden:

Parametergruppen

Mit Remote Config können Sie Parameter für eine besser organisierte Benutzeroberfläche und ein besseres mentales Modell gruppieren.

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 Typen wie gewünscht zu aktivieren, und sie dann in einer Gruppe mit dem Namen "Neue Anmeldung" organisieren, ohne Präfixe oder spezielle Sortierungen hinzufügen zu müssen.

Sie können Parametergruppen mithilfe der Firebase-Konsole 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 weiterhin für alle Parameter eindeutig sein.
  • Parametergruppennamen sind auf 256 Zeichen begrenzt.
  • Wenn Sie sowohl die REST-API als auch die Firebase-Konsole verwenden, stellen Sie sicher, dass alle REST-API-Logik aktualisiert wird, um Parametergruppen beim Veröffentlichen zu verarbeiten.

Erstellen oder ändern Sie Parametergruppen mithilfe der Firebase-Konsole

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

  1. Wählen Sie Gruppen verwalten .
  2. Aktivieren Sie die Kontrollkästchen für die Parameter, die Sie hinzufügen möchten, und wählen Sie In Gruppe verschieben .
  3. 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.

Erstellen Sie programmgesteuert Gruppen

Die Remote Config REST-API bietet eine automatisierte Möglichkeit zum Erstellen und Veröffentlichen von Parametergruppen. Angenommen, Sie sind mit REST vertraut und so eingerichtet, dass Anforderungen an die API autorisiert werden, können Sie die folgenden Schritte ausführen, um Gruppen programmgesteuert 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 mithilfe einer HTTP-PUT-Anforderung.

Das parameterGroups Objekt enthält Gruppenschlüssel mit einer verschachtelten Beschreibung und einer Liste gruppierter Parameter. Beachten Sie, dass jeder Gruppenschlüssel global eindeutig sein muss.

Hier ist zum Beispiel ein Auszug aus einer Vorlagenrevision, die die Parametergruppe "Neues Menü" mit einem Parameter, pumpkin_spice_season , pumpkin_spice_season :

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

    …


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

Bedingungsregelarten

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 Werte) Hinweis
App == Wählen Sie aus einer Liste von App-IDs für Apps aus, die Ihrem Firebase-Projekt zugeordnet sind. Wenn Sie Firebase eine App hinzufügen, geben Sie eine iOS-Bundle-ID oder einen Android-Paketnamen ein, der ein Attribut definiert, das in den Remote-Konfigurationsregeln als App-ID verfügbar gemacht wird.

Verwenden Sie dieses Attribut wie folgt:
  • Für iOS: Verwenden Sie den CFBundleIdentifier der App. Sie finden die Bundle-ID auf der Registerkarte Allgemein für das primäre Ziel Ihrer App in Xcode.
  • Für Android: Verwenden Sie die Anwendungs- ID der App. Sie finden die applicationId in Ihrer build.gradle Datei auf App-Ebene.
App Version Für Zeichenfolgenwerte:
genau passt,
enthält,
beinhaltet nicht,
regulären Ausdruck

Für numerische Werte:
=, ≠,>, ≥, <, ≤

Geben Sie die Version (en) Ihrer App an, auf die Sie abzielen möchten.

Bevor Sie diese Regel verwenden, müssen Sie eine App-ID- Regel verwenden, um eine Android / iOS-App auszuwählen, die Ihrem Firebase-Projekt zugeordnet ist.

Für iOS: Verwenden Sie den CFBundleShortVersionString der App.

Hinweis: Stellen Sie sicher , dass Ihr iOS - App ist mit iOS SDK Firebase Version 6.24.0 oder höher, als CFBundleShortVersionString nicht in früheren Versionen (siehe gesendet werden wird , Release Notes ).

Für Android: Verwenden Sie den Versionsnamen der App.

Bei Zeichenfolgenvergleichen für diese Regel wird zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie den Operator für exakte Übereinstimmungen , enthält , nicht enthalten oder reguläre Ausdrücke verwenden , können Sie mehrere Werte auswählen.

Wenn Sie den Operator für reguläre Ausdrücke verwenden , können Sie reguläre Ausdrücke im RE2- Format erstellen. Ihr regulärer Ausdruck kann mit der gesamten oder einem Teil der Zielversionszeichenfolge übereinstimmen. Sie können auch die Anker ^ und $ verwenden , um den Anfang, das Ende oder die Gesamtheit einer Zielzeichenfolge abzugleichen.

Build-Nummer Für Zeichenfolgenwerte:
genau passt,
enthält,
beinhaltet nicht,
regulären 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 iOS- oder Android-App auszuwählen, die Ihrem Firebase-Projekt zugeordnet ist.

Dieser Operator ist nur für iOS- und Android-Apps verfügbar. Sie entspricht der App CFBundleVersion für iOS und version für Android. Bei Zeichenfolgenvergleichen für diese Regel wird zwischen Groß- und Kleinschreibung unterschieden.

Wenn Sie den Operator für exakte Übereinstimmungen , enthält , nicht enthalten oder reguläre Ausdrücke verwenden , können Sie mehrere Werte auswählen.

Wenn Sie den Operator für reguläre Ausdrücke verwenden , können Sie reguläre Ausdrücke im RE2- Format erstellen. Ihr regulärer Ausdruck kann mit der gesamten oder einem Teil der Zielversionszeichenfolge übereinstimmen. Sie können auch die Anker ^ und $ verwenden , um den Anfang, das Ende oder die Gesamtheit einer Zielzeichenfolge abzugleichen.

Plattform == iOS
Android
Netz
Betriebssystem ==

Geben Sie die Betriebssysteme an, auf die Sie abzielen möchten.

Bevor Sie diese Regel verwenden, müssen Sie eine App-ID- Regel verwenden, um eine Web-App auszuwählen, die Ihrem Firebase-Projekt zugeordnet ist.

Diese Regel wird für eine bestimmte Web-App-Instanz als 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 abzielen möchten.

Bevor Sie diese Regel verwenden, müssen Sie eine App-ID- Regel verwenden, um eine Web-App auszuwählen, die Ihrem Firebase-Projekt zugeordnet ist.

Diese Regel wird für eine bestimmte Web-App-Instanz als true ausgewertet, wenn der Browser und seine Version mit einem Zielwert in der angegebenen Liste übereinstimmen.
Terminzeit <=,> Ein bestimmtes Datum und eine bestimmte Uhrzeit, entweder in der Zeitzone des Geräts oder in einer bestimmten Zeitzone, z. B. "(GMT + 11) Sydney-Zeit". Vergleicht die aktuelle Zeit mit der Abrufzeit des Geräts.
Benutzer im zufälligen Perzentil <=,> 0-100

Verwenden Sie dieses Feld, um eine Änderung auf eine zufällige Stichprobe von App-Instanzen anzuwenden (mit Stichprobengrößen von nur 0,0001%), und verwenden Sie die Operatoren <= und > , um Benutzer (App-Instanzen) in Gruppen zu segmentieren.

Jede App-Instanz wird entsprechend einem in diesem Projekt definierten Schlüssel dauerhaft einer zufälligen ganzen oder gebrochenen Zahl zugeordnet. Eine Regel verwendet den Standardschlüssel (in der Firebase-Konsole als DEF angezeigt), sofern Sie keinen anderen Schlüssel auswählen oder erstellen. Sie können eine Regel auf die Verwendung des Standardschlüssels zurücksetzen, indem Sie die Option Benutzer mit diesem Schlüsselfeld randomisieren deaktivieren . Sie können einen einzelnen Schlüssel über Regeln hinweg verwenden, um dieselben App-Instanzen innerhalb bestimmter Prozentbereiche konsistent zu adressieren. Sie können auch eine neue zufällig zugewiesene Gruppe von App-Instanzen für einen bestimmten Prozentbereich auswählen, indem Sie einen neuen Schlüssel erstellen.

Um beispielsweise zwei verwandte Bedingungen zu erstellen, die jeweils für nicht überlappende 5% der Benutzer einer App gelten, kann eine Bedingung eine <= 5% -Regel und eine andere Bedingung sowohl eine > 5% -Regel als auch eine <= enthalten 10% Regel. Verwenden Sie unterschiedliche Schlüssel für die Regeln in jeder Bedingung, damit einige Benutzer zufällig in beiden Gruppen angezeigt werden können.

Benutzer im Publikum == Wählen Sie eine oder mehrere aus einer Liste von Google Analytics-Zielgruppen aus, die Sie für Ihr Projekt eingerichtet haben.

Diese Regel erfordert eine App-ID-Regel, um eine App auszuwählen, die Ihrem Firebase-Projekt zugeordnet ist.

Hinweis: Da viele Analytics-Zielgruppen durch Ereignisse oder Benutzereigenschaften definiert sind, die auf den Aktionen von App-Benutzern basieren können, kann es einige Zeit dauern, bis ein Benutzer in der Zielgruppenregel für eine bestimmte App-Instanz wirksam wird.

Gerät in Region / Land == 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 aufgelisteten Regionen oder Länder befindet. Der Ländercode des Geräts wird anhand der IP-Adresse des Geräts in der Anforderung oder des von Firebase Analytics festgelegten Ländercodes ermittelt (wenn Analytics-Daten mit Firebase geteilt werden).
Gerätesprache == Wählen Sie eine oder mehrere Sprachen aus. Diese Regel wird für eine bestimmte App-Instanz als true ausgewertet, wenn diese App-Instanz auf einem Gerät installiert ist, das eine der aufgelisteten Sprachen verwendet.
Benutzereigenschaft Für Zeichenfolgenwerte:
enthält,
beinhaltet nicht,
genau passt,
regulären Ausdruck

Für numerische Werte:
=, ≠,>, ≥, <, ≤

Hinweis: Auf dem Client können Sie nur Zeichenfolgenwerte für Benutzereigenschaften festlegen. Für Bedingungen, die numerische Operatoren verwenden, konvertiert Remote Config den Wert der entsprechenden Benutzereigenschaft in eine Ganzzahl / einen Gleitkommawert.
Wählen Sie aus einer Liste der verfügbaren Google Analytics-Benutzereigenschaften aus. Informationen dazu, wie Sie Benutzereigenschaften verwenden können, um Ihre App für ganz bestimmte Segmente Ihrer Benutzerbasis anzupassen, finden Sie unter Remote-Konfiguration und Benutzereigenschaften .

Weitere Informationen zu Benutzereigenschaften finden Sie in den folgenden Handbüchern:

Wenn Sie den Operator für exakte Übereinstimmungen , enthält , nicht enthalten oder reguläre Ausdrücke verwenden , können Sie mehrere Werte auswählen.

Wenn Sie den Operator für reguläre Ausdrücke verwenden , können Sie reguläre Ausdrücke im RE2- Format erstellen. Ihr regulärer Ausdruck kann mit der gesamten oder einem Teil der Zielversionszeichenfolge übereinstimmen. Sie können auch die Anker ^ und $ verwenden , um den Anfang, das Ende oder die Gesamtheit einer Zielzeichenfolge abzugleichen.

Hinweis: Automatisch erfasste Benutzereigenschaften sind derzeit nicht verfügbar, wenn Remotekonfigurationsbedingungen erstellt werden.
Importiertes Segment == Wählen Sie ein oder mehrere importierte Segmente aus. Diese Regel erfordert das Einrichten von benutzerdefinierten importierten Segmenten .

Suche nach Parametern und Bedingungen

Sie können Ihr Projekt Parameterschlüssel, Parameterwerte und Bedingungen von der Suche Firebase - Konsole über das Suchfeld am oberen Rand des Remote Config Registerkarte Parameter.

Grenzen für Parameter und Bedingungen

Innerhalb eines Firebase-Projekts können Sie bis zu 2000 Parameter und bis zu 500 Bedingungen festlegen. Parametertasten können bis zu 256 Zeichen lang sein, müssen mit einem Unterstrich oder einem englischen Buchstaben (AZ, az) beginnen und können auch Zahlen enthalten. Die Gesamtlänge der Parameterwertzeichenfolgen innerhalb eines Projekts darf 800.000 Zeichen nicht überschreiten.

Nächste Schritte

Informationen zum Konfigurieren Ihres Firebase-Projekts finden Sie unter Einrichten eines Firebase-Remotekonfigurationsprojekts .