Referenz zu bedingten Remote Config-Ausdrücken

Auf dieser Seite finden Sie Referenzinformationen zum Erstellen von bedingten Ausdrücken mit Remote Config-Back-End-APIs oder der Firebase-Konsole. Weitere Informationen zum Einrichten und Verwenden der Backend APIs finden Sie unter Remote Config programmatisch ändern.

Elemente zum Erstellen von Bedingungen

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 `&&` verwendet wird, wird es als Bedingung behandelt. Hinweis:Vor und nach den kaufmännischen Und-Zeichen ist ein Leerzeichen erforderlich. Beispiel: `element1 && element2`.
`app.build`	Wird je nach Wert der Build-Nummer einer App zu `TRUE` oder `FALSE` ausgewertet. Hinweis:Nur auf Apple- und Android-Geräten verfügbar. Verwenden Sie für Apple den Wert CFBundleVersion und für Android den Wert versionCode.
`app.version`	Wird je nach Wert der Versionsnummer einer App als `TRUE` oder `FALSE` ausgewertet. Hinweis:Verwenden Sie für Android-Geräte den Wert versionName und 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 je nach Anwesenheit oder Abwesenheit des Nutzers in einer oder mehreren Analytics for Firebase-Zielgruppen den Wert `TRUE` oder `FALSE` zurückgibt.
`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. Es wird das ISO-Datumsformat mit der Option zum Angeben einer festen Zeitzone verwendet, z. B. `app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles')`. Wenn keine Zeitzone angegeben ist, wird GMT verwendet.
`app.userProperty`	Ein Element, das je nach numerischem oder Stringwert einer Google Analytics Nutzereigenschaft zu `TRUE` oder `FALSE` ausgewertet wird.
`app.operatingSystemAndVersion`	Ein Element, das vom Betriebssystem abhängt, 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 Webanwendungen verfügbar.
`app.browserAndVersion`	Ein Element, das vom Browser abhängt, in dem eine App ausgeführt wird. Wird mit `TRUE` ausgewertet, wenn der Browser und die Browserversion mit dem angegebenen Ziel übereinstimmen. 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.
`app.customSignal`	Ein Element, das je nach numerischem, semantischem oder Stringwert der Bedingungen für benutzerdefinierte Signale zu `TRUE` oder `FALSE` ausgewertet wird.
`device.country`	Ein Element, das auf der Region/dem Land basiert, in dem sich ein Gerät befindet, gemäß dem ISO 3166-1 Alpha-2-Standard (z. B. USA oder Vereinigtes Königreich). Wird mit `TRUE` ausgewertet, 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. Es wird das ISO-Datumsformat mit der Option verwendet, um eine feste Zeitzone anzugeben, z. B. `dateTime('2017-03-22T13:39:44', 'America/Los_Angeles')`.
`device.language`	Ein Element, das von der auf einem Gerät ausgewählten Sprache abhängt. Die Sprache wird mit einem IETF-Sprach-Tag wie „de-DE“, „pt-BR“ oder „en-US“ dargestellt. Wird mit `TRUE` ausgewertet, wenn eine Sprache mit einem erwarteten Sprachcode übereinstimmt.
`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 zu `TRUE` ausgewertet, wenn ein Nutzer in einen zufällig zugewiesenen anteiligen Prozentsatz aufgenommen wurde (mit Stichprobengrößen von bis zu 0,000001%).

Eine Bedingung mit einem einzelnen Element enthält drei Felder:

Ein beliebig definiertes name (bis zu 100 Zeichen)
Ein Bedingungsausdruck, der zu TRUE oder FALSE ausgewertet wird und aus den oben genannten Elementen besteht.
Optional: Die tagColor, die „BLUE“, „BROWN“, „CYAN“, „DEEP_ORANGE“, „GREEN“, „INDIGO“, „LIME“, „ORANGE“, „PINK“, „PURPLE“ oder „TEAL“ sein kann. Die Farbe ist nicht groß- und kleinschreibungsempfindlich und wirkt sich nur darauf aus, wie Bedingungen in der Firebase-Konsole angezeigt werden.

Unterstützte Operatoren

Beispiel: app.build.notContains([123, 456]) gibt TRUE zurück, wenn die tatsächliche App-Build-Nummer 123 oder 492 ist, aber FALSE, wenn die tatsächliche App-Build-Nummer 999 ist. Beispiel: app.version.notContains([123, 456]) gibt TRUE zurück, wenn die tatsächliche App-Version 123 oder 492 ist, aber FALSE, wenn die tatsächliche App-Version 999 ist.

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([...])`	Es wird `TRUE` zurückgegeben, wenn die tatsächliche Zielgruppe mit mindestens einem Zielgruppennamen in der Liste nicht übereinstimmt.
`app.audiences`	`.inAll([...])`	Gibt `TRUE` zurück, wenn die tatsächliche Zielgruppe zu jeder Zielgruppe in der Liste gehört.
`app.audiences`	`.notInAll([...])`	Gibt `TRUE` zurück, wenn die tatsächliche Zielgruppe keiner Zielgruppe in der Liste angehört.
`app.firstOpenTimestamp`	`<=, >`	Vergleicht die Uhrzeit des `first_open`-Ereignisses mit der angegebenen Uhrzeit in der Bedingung und gibt je nach Operator `TRUE` oder `FALSE` zurück. Beispiel: `app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles')`. So legen Sie einen Zeitraum fest: `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 mit dem angegebenen Wert verglichen wird und der Operator zutrifft.
`app.userProperty`	`.contains([...])`	Gibt `TRUE` zurück, wenn einer der Zielwerte ein Teilstring der tatsächlichen Nutzereigenschaft ist.
`app.userProperty`	`.notContains([...])`	Gibt `TRUE` zurück, wenn keiner der Zielwerte ein Teilstring der tatsächlichen Nutzereigenschaft ist.
`app.userProperty`	`.exactlyMatches([...])`	Gibt `TRUE` zurück, wenn die tatsächliche Nutzereigenschaft genau mit einem der Zielwerte in der Liste übereinstimmt (Groß- und Kleinschreibung wird berücksichtigt).
`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. Wenn Sie eine Übereinstimmung des gesamten Strings erzwingen möchten, setzen Sie vor den regulären Ausdruck „^“ und nach dem regulären Ausdruck „$“. Dabei wird die RE2-Syntax verwendet.
`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 mit dem angegebenen Wert verglichen wird und der Operator zutrifft.
`app.build`	`.contains([...])`	Gibt `TRUE` zurück, wenn einer der Zielwerte ein Teilstring der tatsächlichen App-Build-Version ist. „a“ und „bc“ sind beispielsweise Teilstrings von „abc“.
`app.build`	`.notContains([...])`	Gibt `TRUE` zurück, wenn keiner der Zielwerte ein Teilstring der tatsächlichen App-Build-Version ist.
`app.build`	`.exactlyMatches([...])`	Gibt `TRUE` zurück, wenn der tatsächliche App-Build genau mit einem der Zielwerte in der Liste übereinstimmt.
`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. Wenn Sie eine Übereinstimmung des gesamten Strings erzwingen möchten, setzen Sie vor den regulären Ausdruck „^“ und nach dem regulären Ausdruck „$“. Es wird die RE2-Syntax verwendet.
`app.version`	`<`, `<=`, `==`, `!=`, `>=`, `>`	Gibt `TRUE` zurück, wenn die tatsächliche App-Version numerisch mit dem angegebenen Wert verglichen wird und der Operator zutrifft.
`app.version`	`.contains([...])`	Gibt `TRUE` zurück, wenn einer der Zielwerte ein Teilstring der tatsächlichen App-Version ist. „a“ und „bc“ sind beispielsweise Teilstrings von „abc“.
`app.version`	`.notContains([...])`	Gibt `TRUE` zurück, wenn keiner der Zielwerte ein Teilstring der tatsächlichen App-Version ist.
`app.version`	`.exactlyMatches([...])`	Gibt `TRUE` zurück, wenn die tatsächliche App-Version genau mit einem der Zielwerte in der Liste übereinstimmt.
`app.version`	`.matches([...])`	Gibt `TRUE` zurück, wenn ein beliebiger Zielregulärer Ausdruck in der Liste mit einem Teilstring oder dem gesamten tatsächlichen Wert übereinstimmt. Wenn Sie eine Übereinstimmung des gesamten Strings erzwingen möchten, setzen Sie vor den regulären Ausdruck „^“ und nach dem regulären Ausdruck „$“. Es wird die RE2-Syntax verwendet.
`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 der Browser und die Version mit einem der Zielwerte in der Liste übereinstimmen. Beispiel: app.browserAndVersion.inOne([browserName('Chrome').anyVersion])
`app.firebaseInstallationId`	`in [...]`	Gibt `TRUE` zurück, wenn die Installations-ID mit einer in der Liste angegebenen übereinstimmt. Beispiel: `app.firebaseInstallationId in ['eyJhbGciOiJFUzI1N_iIs5', 'eapzYQai_g8flVQyfKoGs7']`
`app.customSignal`	`<`, `<=`, `==`, `!=`, `>=`, `>`	Gibt `TRUE` zurück, wenn die benutzerdefinierte Signalbedingung numerisch mit dem angegebenen Wert verglichen wird und der Operator zutrifft.
`app.customSignal`	`.contains([...])`	Gibt `TRUE` zurück, wenn einer der Zielwerte ein Teilstring der tatsächlichen benutzerdefinierten Signalbedingung ist.
`app.customSignal`	`.notContains([...])`	Gibt `TRUE` zurück, wenn einer der Zielwerte ein Teilstring der tatsächlichen benutzerdefinierten Signalbedingung ist.
`app.customSignal`	`.exactlyMatches([...])`	Gibt `TRUE` zurück, wenn die tatsächliche benutzerdefinierte Signalbedingung genau mit einem der Zielwerte in der Liste übereinstimmt (Groß- und Kleinschreibung wird berücksichtigt).
`app.customSignal`	`.matches([...])`	Gibt `TRUE` zurück, wenn ein regulärer Ausdruck in der Liste mit einem Teilstring oder der gesamten benutzerdefinierten Signalbedingung übereinstimmt. Wenn Sie eine Übereinstimmung des gesamten Strings erzwingen möchten, setzen Sie vor den regulären Ausdruck „^“ und nach dem regulären Ausdruck „$“. Es wird die RE2-Syntax verwendet.
`version(app.customSignal)`	`<`, `<=`, `==`, `!=`, `>=`, `>`	Gibt `TRUE` zurück, wenn die benutzerdefinierte Signalbedingung semantisch mit dem angegebenen Wert verglichen wird und dem Operator entspricht.
`device.country`	`in [...]`	Gibt `TRUE` zurück, wenn das Land des Geräts mit einem in der Liste angegebenen Land übereinstimmt. Beispiel: `device.country in ['gb', 'us']`. Der Ländercode des Geräts wird anhand der IP-Adresse des Geräts in der Anfrage oder des von Firebase Analytics ermittelten Ländercodes ermittelt (sofern Analytics-Daten mit Firebase geteilt werden).
`device.dateTime`	`<=`, `>`	Vergleicht die aktuelle Uhrzeit mit der Zielzeit der Bedingung und ergibt je nach Operator `TRUE` oder `FALSE`. Beispiel: `dateTime < dateTime('2017-03-22T13:39:44')`.
`device.language`	`in [...]`	Gibt `TRUE` zurück, wenn eine der Sprachen der App mit einer Sprache in der Liste übereinstimmt. 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 wird, der dem Operator zufällig zugewiesen wurde. Sie können einen Startwert angeben, um eine neue, zufällig zugewiesene Gruppe von App-Instanzen für einen bestimmten Prozentsatzbereich auszuwählen, wie unter Arten von Bedingungsregeln beschrieben. Geben Sie dazu den Namen des Startwerts vor dem Operator an, wie im folgenden Beispiel: percent('keyName') <= 10 Mit dem Operator `between` können Sie einen bestimmten Bereich konfigurieren. So konfigurieren Sie eine Gruppe von Nutzern zwischen 20 und 60 mit dem Standard-Seed: percent between 20 and 60 So konfigurieren Sie eine Gruppe von 60 bis 80 Nutzern mit einem benutzerdefinierten Startwert: percent('seedName') between 60 and 80