Referenz zu bedingten Remote Config-Ausdrücken

Diese Seite enthält Referenzinformationen zur Erstellung bedingter Ausdrücke mit Remote Config-Back-End-APIs oder der Firebase-Konsole Für Weitere Informationen zum Einrichten und Verwenden der Back-End-APIs finden Sie unter Remote Config programmatisch ändern

Elemente, die zum Erstellen von Bedingungen verwendet werden

Die Remote Config REST API unterstützt dieselben Elemente, mit denen Sie Bedingungen erstellen können, wenn Sie Remote Config über die Firebase Console konfigurieren:

Element Beschreibung
&&

Wird verwendet, um ein logisches „und“ von Elementen zu erstellen, wenn für eine Bedingung mehrere Elemente verwendet werden. Wenn ein Element in der REST-Syntax ohne das && , wird dieses Element als Bedingung behandelt.

Hinweis: Vor und nach dem Und-Zeichen ist ein Leerzeichen erforderlich. Hier einige Beispiele: element1 && element2
app.build

Wird je nach Wert der Build-Nummer einer App mit TRUE oder FALSE ausgewertet.

Hinweis:Nur auf Apple- und Android-Geräten verfügbar. Verwenden Sie für Apple den Wert von CFBundleVersion und für Android den Wert von versionCode.
app.version

Wird basierend auf dem Wert der Versionsnummer einer App mit TRUE oder FALSE ausgewertet.

Hinweis:Verwenden Sie für Android-Geräte den Wert von versionName, Verwenden Sie für Apple-Geräte den Wert CFBundleShortVersionString.
app.id Ein Element, das auf der Firebase App-ID der App basiert
app.audiences Ein Element, das basierend auf TRUE oder FALSE ausgewertet wird die Anwesenheit oder Abwesenheit des Nutzers in einem oder mehreren Firebase Analytics-Zielgruppe(n):
app.firstOpenTimestamp Ein Element, das darauf basiert, wann der Nutzer eine App zum ersten Mal startet. Es wird aus dem Ereignis Google Analytics first_open abgeleitet. Verwendet ISO-Datum mit der Option, eine feste Zeitzone anzugeben; zum Beispiel app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles') Wenn keine Zeitzone angegeben ist, wird GMT verwendet.
app.userProperty Ein Element, das basierend auf TRUE oder FALSE ausgewertet wird auf den numerischen Wert oder Zeichenfolgenwert eines Firebase Analytics-Nutzereigenschaft:
app.operatingSystemAndVersion

Ein Element, das auf dem Betriebssystem basiert, auf dem eine App ausgeführt wird. Wird mit TRUE ausgewertet, wenn das Betriebssystem und die Betriebssystemversion mit dem angegebenen Ziel übereinstimmen.

Hinweis:Nur für Web-Apps verfügbar.
app.browserAndVersion

Ein Element, das auf dem Browser basiert, in dem eine App ausgeführt wird. Wird mit TRUE ausgewertet, wenn Browser- und Browserversion mit dem angegebenen Ziel.

Hinweis: Nur für Webanwendungen verfügbar.
app.firebaseInstallationId Ein Element, das auf den IDs bestimmter Geräteinstallationen basiert. Wird zu TRUE ausgewertet, wenn die Installations-ID mit einer der angegebenen Installations-IDs übereinstimmt.
device.country Ein Element, das auf der Region/dem Land basiert, in der sich ein Gerät befindet, mit ISO 3166-1 ALPHA-2 (z. B. USA oder Vereinigtes Königreich). Wird ausgewertet als TRUE, wenn ein Land mit einem erwarteten Ländercode übereinstimmt.
device.dateTime Ein Element, das auf der Zeit des letzten Abrufs basiert, den das Gerät ausführt. Verwendet das ISO-Datumsformat mit dem Option zur Angabe einer festen Zeitzone; zum Beispiel dateTime('2017-03-22T13:39:44', 'America/Los_Angeles')
device.language Ein Element, das auf der auf einem Gerät ausgewählten Sprache basiert. Die Sprache ist die durch ein IETF-Sprach-Tag wie es-ES, pt-BR oder en-US dargestellt wird. Wird mit TRUE ausgewertet, wenn eine Sprache mit einer erwarteten Sprache übereinstimmt Code.
device.os Ein Element, das vom Betriebssystem des Geräts abhängt (Apple oder Android). Wird mit TRUE ausgewertet, wenn das Betriebssystem des Geräts dem erwarteten Typ entspricht.
percent Wird auf Grundlage der Einbeziehung eines Nutzers in eine zufällig ausgewählte App als TRUE ausgewertet anteiligen Prozentsatz (mit Stichprobengrößen von 0,000001%) zugewiesen.

Eine Bedingung für ein einzelnes Element enthält drei Felder:

  1. Eine beliebig definierte name (bis zu 100 Zeichen)
  2. Ein Bedingungsausdruck, der zu TRUE oder FALSE ausgewertet wird und aus den oben genannten Elementen besteht.
  3. (Optional) Die tagColor, die sein "BLUE", "BROWN", "CYAN", "DEEP_ORANGE", "GREEN", "INDIGO", „LIME“, „ORANGE“, „PINK“, „PURPLE“ oder „TEAL“. Die Farbe ist Groß- und Kleinschreibung wird nicht berücksichtigt und sie wirkt sich nur darauf aus, wie Bedingungen im Firebase.

Unterstützte Operatoren

Beispiel: app.build.notContains([123, 456]) gibt TRUE zurück, wenn Der tatsächliche App-Build ist 123 oder 492, gibt aber FALSE zurück, wenn der Der tatsächliche App-Build ist 999. Beispiel: app.version.notContains([123, 456]) gibt TRUE zurück, wenn Die tatsächliche App-Version ist 123 oder 492, gibt jedoch FALSE zurück, wenn das die tatsächliche App-Version ist 999.
Element Unterstützte Operatoren Beschreibung
app.audiences .inAtLeastOne([...]) Es wird TRUE zurückgegeben, wenn die tatsächliche Zielgruppe mit mindestens einem Zielgruppennamen in der Liste übereinstimmt.
Beispiel:

app.audiences.inAtLeastOne(['Audience 1', 'Audience 2'])

app.audiences .notInAtLeastOne([...]) Gibt TRUE zurück, wenn die tatsächliche Zielgruppe nicht mindestens mit der einen Zielgruppennamen in der Liste.
app.audiences .inAll([...]) Gibt TRUE zurück, wenn die Zielgruppe zu jedem gehört. Namen der Zielgruppe in die Liste ein.
app.audiences .notInAll([...]) Gibt TRUE zurück, wenn die tatsächliche Zielgruppe keiner Zielgruppe in der Liste angehört.
app.firstOpenTimestamp <=, > Vergleicht die Zeit des first_open-Ereignisses mit der angegebenen Zeit in der Bedingung und gibt TRUE oder FALSE zurück je nach Operator.
Beispiel:
app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles').
So geben Sie einen Bereich an:
app.firstOpenTimestamp >= ('2022-11-01T00:00:00') && app.firstOpenTimestamp < ('2022-12-01T00:00:00') Wenn keine Zeitzone angegeben ist, wird GMT verwendet.
app.userProperty <, <=, ==, !=, >=, > Gibt TRUE zurück, wenn die tatsächliche Nutzereigenschaft numerisch verglichen wird auf den angegebenen Wert so, dass er dem Operator entspricht.
app.userProperty .contains([...]) Gibt TRUE zurück, wenn einer der Zielwerte ein Teilstring von ist. die eigentliche Nutzereigenschaft.
app.userProperty .notContains([...]) Gibt TRUE zurück, wenn keiner der Zielwerte ein Teilstring von ist. die eigentliche Nutzereigenschaft.
app.userProperty .exactlyMatches([...]) Gibt TRUE zurück, wenn die tatsächliche Nutzereigenschaft genau übereinstimmt (unter Berücksichtigung der Groß- und Kleinschreibung) beliebiger Zielwerte in der Liste
app.userProperty .matches([...]) Gibt TRUE zurück, wenn ein beliebiger Zielregulärer Ausdruck in der Liste mit einem Teilstring oder dem gesamten tatsächlichen Wert übereinstimmt. Um den Abgleich des gesamten Strings zu erzwingen, dem regulären Ausdruck das Zeichen „^“ voranstellen und fügen Sie "$" als Suffix hinzu. Verwendungen RE2-Syntax
app.id == Gibt TRUE zurück, wenn der angegebene Wert mit der App-ID der App übereinstimmt.
app.build <, <=, ==, !=, >=, > Gibt TRUE zurück, wenn der tatsächliche App-Build numerisch verglichen wird auf den angegebenen Wert so, dass er dem Operator entspricht.
app.build .contains([...]) Gibt TRUE zurück, wenn einer der Zielwerte ein Teilstring von ist. des eigentlichen App-Builds erstellen, zum Beispiel „a“ und „bc“ sind Teilzeichenfolgen von „abc“ sein.
app.build .notContains([...]) Gibt TRUE zurück, wenn keiner der Zielwerte ein Teilstring von ist. das eigentliche App-Build.
app.build .exactlyMatches([...]) Gibt TRUE zurück, wenn der tatsächliche App-Build genau übereinstimmt beliebiger Zielwert in der Liste.
app.build .matches([...]) Gibt TRUE zurück, wenn ein beliebiger Zielregulärer Ausdruck in der Liste mit einem Teilstring oder dem gesamten tatsächlichen Wert übereinstimmt. Abgleich erzwingen des gesamten Strings müssen Sie dem regulären Ausdruck das Zeichen "^" voranstellen und fügen Sie ein mit „$“. Verwendet RE2-Syntax.
app.version <, <=, ==, !=, >=, > Gibt TRUE zurück, wenn die tatsächliche App-Version numerisch verglichen wird auf den angegebenen Wert so, dass er dem Operator entspricht.
app.version .contains([...]) Gibt TRUE zurück, wenn einer der Zielwerte ein Teilstring von ist. Die tatsächliche App-Version, z. B. „a“ und „bc“ sind Teilzeichenfolgen von „abc“ sein.
app.version .notContains([...]) Gibt TRUE zurück, wenn keiner der Zielwerte ein Teilstring von ist. die tatsächliche Version der App.
app.version .exactlyMatches([...]) Gibt TRUE zurück, wenn die tatsächliche App-Version genau übereinstimmt beliebiger Zielwert in der Liste.
app.version .matches([...]) Gibt TRUE zurück, wenn ein beliebiger regulärer Zielausdruck in der list entspricht einer Teilzeichenfolge oder des gesamten tatsächlichen Werts. Abgleich erzwingen des gesamten Strings müssen Sie dem regulären Ausdruck das Zeichen "^" voranstellen und fügen Sie ein durch „$“. Verwendet RE2-Syntax.
app.operatingSystemAndVersion .inOne([...]) Gibt TRUE zurück, wenn das Betriebssystem und die Version mit einem der Zielwerte in der Liste übereinstimmen.
Beispiel:

    app.operatingSystemAndVersion.inOne([operatingSystemName('Macintosh').version.==('10.15')])

app.browserAndVersion .inOne([...]) Gibt TRUE zurück, wenn Browser und Version mit einem beliebigen der folgenden Parameter übereinstimmen: Zielwerte in der Liste.
Beispiel:

    app.browserAndVersion.inOne([browserName('Chrome').anyVersion])

app.firebaseInstallationId in [...] Gibt TRUE zurück, wenn die Installations-ID mit beliebigen Angaben in der Liste übereinstimmt. Verwendungsbeispiel: app.firebaseInstallationId in ['eyJhbGciOiJFUzI1N_iIs5', 'eapzYQai_g8flVQyfKoGs7']
device.country in [...] Gibt TRUE zurück, wenn sich das Land des Geräts befindet mit beliebigen Angaben in der Liste übereinstimmt. Beispiel: device.country in ['gb', 'us']. Der Ländercode des Geräts wird mithilfe der die IP-Adresse des Geräts in der Anfrage oder der von Firebase ermittelte Ländercode Analytics (wenn Analytics-Daten für Firebase freigegeben werden)
device.dateTime <=, > Vergleicht die aktuelle Uhrzeit zur Zielzeit der Bedingung und wertet TRUE oder FALSE je nach Operator. Verwendungsbeispiel: dateTime < dateTime('2017-03-22T13:39:44')
device.language in [...] Gibt TRUE zurück, wenn eine der Sprachen der App mit einer Sprache übereinstimmt in der Liste. Beispiel: device.language in ['en-UK', 'en-US'].
device.os ==, != Gibt TRUE zurück, wenn das Betriebssystem des Geräts den Wert in diesem Feld mit dem Operator vergleicht.
percent <=, >, between Gibt TRUE zurück, wenn der Wert im Feld percent mit dem Wert verglichen, der dem Operator nach dem Zufallsprinzip zugewiesen wurde.

Sie können einen Seed-Wert angeben, um einen neuen zufällig zugewiesenen Gruppe von Anwendungsinstanzen für einen bestimmten Prozentsatzbereich, wie in Bedingungsregel .

Geben Sie dazu vor dem Operator, wie im folgenden Beispiel: 

percent('keyName') <= 10

Zum Konfigurieren eines bestimmten Bereichs können Sie die between verwenden . So konfigurieren Sie eine Gruppe von 20 bis 60 Nutzern mit dem Standard-Seed: 

percent between 20 and 60

So konfigurieren Sie mithilfe eines benutzerdefinierten Startwerts einen Bereich von 60 bis 80 Nutzern: 

percent('seedName') between 60 and 80