Odwołanie do wyrażenia warunkowego Zdalnej konfiguracji

Ta strona zawiera informacje referencyjne dotyczące tworzenia wyrażeń warunkowych za pomocą interfejsów API backendu Zdalnej konfiguracji lub konsoli Firebase. Aby uzyskać więcej informacji na temat konfigurowania i korzystania z API zaplecza, patrz Modyfikuj Remote Config programowo .

Elementy używane do tworzenia warunków

Interfejs API REST Remote Config obsługuje te same elementy, których można użyć do tworzenia warunków podczas konfigurowania zdalnej konfiguracji za pomocą konsoli Firebase:

Element Opis
&&

Służy do tworzenia logicznego „i” elementów, jeśli dla warunku używany jest więcej niż jeden element. Jeśli używany jest element składni odpoczynek bez && , element ten jest traktowany jako stan.

Uwaga: wymagana jest przestrzeń przed i po ampersandów. Na przykład: element1 && element2 .

app.build

Zwraca TRUE lub FALSE na podstawie wartości liczby budowania aplikacji.

Uwaga: Opcja dostępna tylko dla urządzeń Apple i Android. Dla Apple, użyj wartości CFBundleVersion i dla Androida, użyj wartości versionCode .

app.version

Zwraca TRUE lub FALSE w oparciu o wartości numeru wersji danej aplikacji.

Uwaga: W przypadku urządzeń z Androidem użyć wartości versionName oraz dla Apple urządzenia korzystają wartość CFBundleShortVersionString .

app.id Element oparty na identyfikatorze aplikacji Firebase App ID
app.audiences Element, który ma wartość TRUE lub FALSE na podstawie obecności lub nieobecności użytkownika, w jednym lub więcej odbiorców Firebase Analytics (ów) .
app.predictionScores.id Element, który ocenia prawdopodobieństwo percentyla użytkownika wywołującego dla danego identyfikatora Firebase Predictions.
app.userProperty Element, który ma wartość TRUE lub FALSE w oparciu o numeryczną lub strun wartość Firebase Analytics Nieruchomość użytkownika .
app.operatingSystemAndVersion

Element oparty na systemie operacyjnym, na którym działa aplikacja. Zwraca TRUE gdy OS i OS wersja pasuje do określonego celu.

Uwaga: Funkcja dostępna tylko dla aplikacji internetowych.

app.browserAndVersion

Element oparty na przeglądarce, w której działa aplikacja. Zwraca TRUE jeśli wersja przeglądarki i przeglądarka pasuje do określonego celu.

Uwaga: Funkcja dostępna tylko dla aplikacji internetowych.

app.firebaseInstallationId Element oparty na identyfikatorach konkretnych instalacji urządzeń. Zwraca TRUE jeśli identyfikator instalacji pasuje do jednego z podanych identyfikatorów instalacji.
device.country Element oparty na regionie/kraju, w którym znajduje się urządzenie, przy użyciu standardu ISO 3166-1 alpha-2 (na przykład USA lub Wielka Brytania). Zwraca TRUE gdy kraj pasuje oczekiwany kod kraju.
device.dateTime Element oparty na czasie ostatniego pobrania wykonanego przez urządzenie. Używa formatu daty ISO z opcją określenia stałej strefy czasowej; na przykład, dateTime('2017-03-22T13:39:44', 'America/Los_Angeles') .
device.language Element oparty na języku wybranym na urządzeniu. Język jest reprezentowany za pomocą znacznika języka IETF, takiego jak es-ES, pt-BR lub en-US. Zwraca TRUE gdy język pasuje oczekiwany kod języka.
device.os Element oparty na systemie operacyjnym używanym na urządzeniu (Apple lub Android). Zwraca TRUE gdy urządzenie OS jest oczekiwana typu.
percent Zwraca TRUE podstawie integracji użytkownika w losowo przypisany percentyla frakcjonowanej (przy wielkości próbek tak małe jak 0,000001%).

Warunek jednoelementowy zawiera trzy pola:

  1. Dowolnie definiowane name (do 100 znaków)
  2. Wyrażenie warunkowe, że ma wartość TRUE lub FALSE , składający się z elementów przedstawionych powyżej.
  3. (Opcjonalnie) tagColor , które mogą być " BLUE ", " BROWN ", " CYAN ", " DEEP_ORANGE ", " GREEN ", " INDIGO ", " LIME ", " ORANGE ", " PINK ", " PURPLE " lub " TEAL ". Wielkość liter nie jest rozróżniana i wpływa tylko na sposób wyświetlania warunków w konsoli Firebase.

Obsługiwani operatorzy

Na przykład, app.build.notContains([123, 456]) zwraca TRUE , jeżeli rzeczywista aplikacja wykonania jest 123 lub 492, ale zwraca FALSE , jeśli rzeczywista budowa Aplikacja 999. Na przykład, app.version.notContains([123, 456]) zwraca TRUE , jeżeli rzeczywista wersja aplikacji jest 123 lub 492, ale zwraca FALSE , jeśli rzeczywisty wersja aplikacji 999.
Element Obsługiwani operatorzy Opis
app.audiences .inAtLeastOne([...]) Zwraca TRUE jeśli rzeczywista publiczność odpowiada co najmniej jedno nazwisko z listy odbiorców.
Na przykład:

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

app.audiences .notInAtLeastOne([...]) Zwraca TRUE jeśli rzeczywista publiczność nie zgadza się przynajmniej jedno nazwisko z listy odbiorców.
app.audiences .inAll([...]) Zwraca TRUE jeśli rzeczywista publiczność jest członkiem każdej nazwy odbiorców na liście.
app.audiences .notInAll([...]) Zwraca TRUE jeśli rzeczywista publiczność nie jest członkiem żadnej publiczności na liście.
app.predictionScores.id .between(..., ...) Zwraca TRUE jeśli użytkownik rozmówcy percentyla prawdopodobieństwa dla predykcji jest w danym zakresie.
Na przykład:

app.predictionScores.id('churn').between(0.25, 1.00)

app.userProperty < , <= , == , != , >= , > Zwraca TRUE jeśli rzeczywista własność użytkownik numerycznie porównuje się do wartości określonej w sposób, który odpowiada operator.
app.userProperty .contains([...]) Zwraca TRUE jeśli którykolwiek z wartościami docelowymi jest podciąg rzeczywistej mienia użytkownika.
app.userProperty .notContains([...]) Zwraca TRUE jeśli żadna z wartości docelowych jest podciąg rzeczywistej mienia użytkownika.
app.userProperty .exactlyMatches([...]) Zwraca TRUE jeśli rzeczywista własność użytkownik odpowiada dokładnie (wielkość liter ma znaczenie) wszelkie wartości docelowych na liście.
app.userProperty .matches([...]) Zwraca TRUE jeśli dowolny cel wyrażenie regularne w liście dopasowuje podciąg lub całą, rzeczywistą wartość. Aby wymusić dopasowanie całego ciągu, poprzedź wyrażenie regularne "^" i dodaj do niego "$". Używa RE2 składnię.
app.id == Zwraca TRUE , jeśli wartość określona mecze w aplikacji App ID.
app.build < , <= , == , != , >= , > Zwraca TRUE jeśli rzeczywista aplikacja build numerycznie porównuje się do wartości określonej w sposób, który odpowiada operator.
app.build .contains([...]) Zwraca TRUE jeśli którykolwiek z wartościami docelowymi jest podciąg rzeczywistej aplikacji wbudowanych na przykład „a” i „bc” są podciągi z „ABC”.
app.build .notContains([...]) Zwraca TRUE jeśli żadna z wartości docelowych jest podciąg rzeczywistej aplikacji kompilacji.
app.build .exactlyMatches([...]) Zwraca TRUE jeśli rzeczywista aplikacja budować dokładnie pasuje do żadnej z wartości docelowych na liście.
app.build .matches([...]) Zwraca TRUE jeśli dowolny cel wyrażenie regularne w liście dopasowuje podciąg lub całą, rzeczywistą wartość. Aby wymusić dopasowanie całego ciągu, poprzedź wyrażenie regularne "^" i dodaj do niego "$". Używa RE2 składnię.
app.version < , <= , == , != , >= , > Zwraca TRUE jeśli rzeczywista wersja aplikacji numerycznie porównuje się do wartości określonej w sposób, który odpowiada operator.
app.version .contains([...]) Zwraca TRUE jeśli którykolwiek z wartościami docelowymi jest podciąg rzeczywistej aplikacji wersji, na przykład, „a” i „bc” są podciągi z „ABC”.
app.version .notContains([...]) Zwraca TRUE jeśli żadna z wartości docelowych jest podciąg od aktualnej wersji aplikacji.
app.version .exactlyMatches([...]) Zwraca TRUE jeśli rzeczywista wersja aplikacji dokładnie pasuje do żadnej z wartości docelowych na liście.
app.version .matches([...]) Zwraca TRUE jeśli dowolny cel wyrażenie regularne w liście dopasowuje podciąg lub całą, rzeczywistą wartość. Aby wymusić dopasowanie całego ciągu, poprzedź wyrażenie regularne "^" i dodaj "$". Używa RE2 składnię.
app.operatingSystemAndVersion .inOne([...]) Zwraca TRUE jeśli system operacyjny i jego wersja pasuje do dowolnej wartości docelowych na liście.
Na przykład:

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

app.browserAndVersion .inOne([...]) Zwraca TRUE jeśli przeglądarka i wersja pasuje do dowolnej wartości docelowych na liście.
Na przykład:

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

app.firebaseInstallationId in [...] Zwraca TRUE jeśli mecze ID instalacji dowolnego wymienione w wykazie. Wykorzystanie próbki: app.firebaseInstallationId in ['eyJhbGciOiJFUzI1N_iIs5', 'eapzYQai_g8flVQyfKoGs7']
device.country in [...] Zwraca TRUE jeśli mecze country urządzenia za dowolny podany w liście. Wykorzystanie próbki: device.country in ['gb', 'us'] . Kod kraju urządzenia jest określany na podstawie adresu IP urządzenia w żądaniu lub kodu kraju określonego przez Firebase Analytics (jeśli dane Analytics są udostępniane Firebase).
device.dateTime <= , > Porównuje aktualnego czasu do czasu docelowego stanu i ma wartość TRUE lub FALSE w oparciu o operatora. Wykorzystanie próbki: dateTime < dateTime('2017-03-22T13:39:44') .
device.language in [...] Zwraca TRUE jeśli którykolwiek z języków Aplikacja jest dopasować język na liście. Wykorzystanie próbki: device.language in ['en-UK', 'en-US'] .
device.os == , != Zwraca TRUE jeśli system operacyjny urządzenia porównuje się do wartości w tej dziedzinie odpowiadającej operatora.
percent <= , > Zwraca TRUE , jeśli wartość w percent pola porównuje się do wartości, który został losowo przydzielony dopasowanie operatora.