Diese Seite wurde von der Cloud Translation API übersetzt.

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 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 `&&` verwendet wird, wird dieses Element 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 von CFBundleVersion und für Android den Wert von 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 Firebase 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 dem angegebenen Ziel entsprechen. Hinweis:Nur für Webanwendungen verfügbar.
`app.browserAndVersion`	Ein Element, das auf dem Browser basiert, 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 mit `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 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. Verwendet das ISO-Datumsformat mit der Option, 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 bedingter Ausdruck, der aus den oben gezeigten Elementen TRUE oder FALSE ergibt.
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. app.version.notContains([123, 456]) gibt beispielsweise TRUE zurück, wenn die tatsächliche App-Version 123 oder 492 ist, und 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 eigentliche Zielgruppe zu den einzelnen Zielgruppennamen 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 in der Bedingung angegebenen Uhrzeit 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 des tatsächlichen App-Builds ist. „a“ und „bc“ sind beispielsweise Teilstrings von „abc“.
`app.build`	`.notContains([...])`	Gibt `TRUE` zurück, wenn keiner der Zielwerte ein Teilstring des tatsächlichen Anwendungs-Builds 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. Um einen Abgleich des gesamten Strings zu erzwingen, stellen Sie dem regulären Ausdruck „^“ voran und geben ihm als Suffix „$“ an. Dazu wird die RE2-Syntax verwendet.
`app.version`	`<`, `<=`, `==`, `!=`, `>=`, `>`	Gibt `TRUE` zurück, wenn die tatsächliche App-Version numerisch mit dem angegebenen Wert verglichen wird, der dem Operator entspricht.
`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. Um einen Abgleich des gesamten Strings zu erzwingen, stellen Sie dem regulären Ausdruck „^“ voran und geben ihm als Suffix „$“ an. Dazu 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. Verwendungsbeispiel: `app.firebaseInstallationId in ['eyJhbGciOiJFUzI1N_iIs5', 'eapzYQai_g8flVQyfKoGs7']`
`device.country`	`in [...]`	Gibt `TRUE` zurück, wenn das Land des Geräts mit einem Land in der Liste ü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 für Firebase freigegeben 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 einen Bereich von 20 bis 60 Nutzer 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