Parametry i warunki Zdalnej konfiguracji

Szablony możesz skonfigurować pod kątem przypadków użycia zarówno klienta, jak i serwera. Klient szablony są przesyłane do wszystkich instancji aplikacji, które implementują Firebase pakiety SDK klienta dla platformy Remote Config, w tym Android, Apple, Web, Unity oraz aplikacje Flutter i C++. Remote Config parametry i wartości z szablony serwerowe są obsługiwane w implementacjach Remote Config (w tym Cloud Run i Cloud Functions), które korzystają z konsoli administracyjnej Firebase Pakiet SDK Node.js w wersji 12.1.0 lub nowszej.

Jeśli używasz konsoli Firebase lub Remote Config interfejsów API backendu, zdefiniować co najmniej jeden parametr (para klucz-wartość par) i podaj domyślne wartości tych parametrów w aplikacji. Możesz zastąpić domyślnych wartości w aplikacji, definiując wartości parametrów. Klucze i wartości parametrów mają postać ciągów znaków, ale wartości parametrów mogą być przesyłane jako inne typy danych, jeśli używasz ich w do aplikacji.

Korzystając z konsoli Firebase, Admin SDK lub Remote Config interfejs API REST, możesz utworzyć nowe domyślne wartości dla parametrów i wartości warunkowych, które służą do kierowania reklam na grupy aplikacji instancji. Za każdym razem, gdy zaktualizujesz konfigurację w konsoli Firebase, Firebase utworzy i opublikuje nową wersję Twojego szablonu Remote Config. Dostępna jest poprzednia wersja, dzięki czemu w razie potrzeby możesz ją przywrócić lub przywrócić. Te operacje są dostępne w konsoli Firebase, Firebase Admin SDK oraz interfejsu API REST. Zostały one szczegółowo opisane w Zarządzaj wersjami szablonu Remote Config.

W tym przewodniku objaśniamy parametry, warunki, reguły, oraz uszeregowania ich według priorytetów Remote Config na serwerze i w Twojej aplikacji. Znajdziesz tu też informacje o typach z reguł używanych do tworzenia warunków.

Warunki, reguły i wartości warunkowe

Warunek jest używany do kierowania reklam na grupę instancji aplikacji. Warunki zostały określone z co najmniej jednej reguły, która musi zostać obliczona na wartość true, aby warunek został spełniony zwraca wartość true dla danej instancji aplikacji. Jeśli wartość reguły to nieokreślona (np. jeśli żadna wartość nie jest dostępna), reguła oceni, false

Na przykład parametr, który określa parametr na stronie powitalnej aplikacji mogą być wyświetlane różne obrazy w zależności od typu systemu operacyjnego za pomocą funkcji prosta reguła if device_os = Android:

lub warunek czasowy może służyć do określania, kiedy aplikacja ma wyświetlać produktów promocyjnych.

Parametr może zawierać wiele wartości warunkowych, wartości z różnymi warunkami, a parametry mogą mieć takie same warunki w obrębie projekt. Na karcie Parametry. w konsoli Firebase możesz wyświetlić procent pobierania każdej z nich wartości warunkowych parametru. Ten wskaźnik określa odsetek żądań w ciągu ostatnich 24 godzin, które otrzymały każdą wartość.

Priorytet wartości parametru

Z parametrem może być powiązanych kilka wartości warunkowych. te reguły określają, jaką wartość jest pobierana z Remote Config serwer oraz wartość używaną w danej instancji aplikacji w konkretnym momencie godzina:

Wartości parametrów są pobierane zgodnie z następującymi priorytetami lista

1. Najpierw stosowane są wartości warunkowe, jeśli istnieją warunki oceniające do true w przypadku danej instancji aplikacji. Jeśli większa liczba warunków przyjmuje wartość true, pierwszy (najwyższy) widoczny w interfejsie konsoli Firebase ma pierwszeństwo; wartości warunkowe powiązane z tym warunkiem są podawane, gdy aplikacja pobiera wartości z backendu. Priorytet warunków możesz zmienić przez przeciągać i upuszczać warunki na karcie Warunki.

2. Jeśli nie ma wartości warunkowych z warunkami, które przyjmują wartość true, Wartość domyślna parametru Remote Config jest podawana, gdy aplikacja pobiera wartości z z backendem. Jeśli parametr nie istnieje w backendzie lub jeśli wartość domyślna ma ustawienie Użyj wartości domyślnej w aplikacji, nie podano żadnej wartości dla tego parametru. gdy aplikacja pobiera wartości.

W Twojej aplikacji wartości parametrów są zwracane przez metody get zgodnie z tę listę priorytetów

1. Jeśli wartość została pobrana z backendu, a następnie aktywowana, aplikacja używa funkcji pobranej wartości. Aktywowane wartości parametrów są trwałe.

2. Jeśli z backendu nie zostały pobrane żadne wartości lub jeśli wartości zostały pobrane z metody Backend Remote Config nie został aktywowany, aplikacja używa trybu „w aplikacji” wartość domyślną.

   Więcej informacji o uzyskiwaniu i ustawianiu wartości domyślnych znajdziesz w sekcji Pobierz domyślne ustawienia szablonu Remote Config

3. Jeśli nie ustawiono domyślnej wartości w aplikacji, aplikacja używa typu statycznego. (np. 0 w przypadku int i false dla boolean).

Ta grafika podsumowuje priorytety wartości parametrów w Backend Remote Config i w aplikacji:

Typy danych wartości parametrów

Remote Config umożliwia wybór typu danych dla każdego parametru. weryfikuje wszystkie wartości Remote Config w odniesieniu do tego typu przed szablonem . Typ danych jest przechowywany i zwracany na urządzeniu getRemoteConfig użytkownika.

Obecnie obsługiwane typy to:

• String
• Boolean
• Number
• JSON

W interfejsie konsoli Firebase typ danych można wybrać w następnym menu do klucza parametru. W interfejsie API REST typy można ustawiać za pomocą interfejsu value_type. w obiekcie parametru.

Grupy parametrów

Funkcja Remote Config umożliwia grupowanie parametrów, aby można było lepiej je uporządkować Interfejs użytkownika i model psychiczny.

Załóżmy na przykład, że chcesz włączyć lub wyłączyć 3 różne typy uwierzytelniania. podczas wdrażania nowej funkcji logowania. Remote Config umożliwia tworzenie te 3 parametry, aby włączyć poszczególne typy, a następnie uporządkować je według potrzeb grupę o nazwie „Nowy login”, bez konieczności dodawania prefiksów ani specjalnego sortowania.

Grupy parametrów możesz tworzyć za pomocą konsoli Firebase lub Interfejs API typu REST Remote Config. Każda grupa parametrów, którą utworzysz, ma unikalną nazwę Twój szablon Remote Config. Podczas tworzenia grup parametrów pamiętaj o tych kwestiach:

• Parametry można w danym momencie uwzględnić tylko w jednej grupie, a parametr musi być unikalny wśród wszystkich parametrów.
• Nazwy grup parametrów mogą mieć maksymalnie 256 znaków.
• Jeśli używasz zarówno interfejsu API REST, jak i konsoli Firebase, upewnij się, że wszystkie Logika interfejsu API REST została zaktualizowana, aby obsługiwać grupy parametrów podczas publikowania.

Utwórz lub zmodyfikuj grupy parametrów za pomocą konsoli Firebase

Parametry możesz grupować w Karta Parametry funkcji w konsoli Firebase. Aby utworzyć lub zmodyfikować grupę:

1. Wybierz Zarządzaj grupami.
2. Zaznacz pola wyboru obok parametrów, które chcesz dodać, i wybierz Przenieś do grupy.
3. Wybierz istniejącą grupę lub utwórz nową, wpisując nazwę i i wybierz Utwórz nową grupę. Po zapisaniu grupy można ją opublikować przy użyciu Przycisk Opublikuj zmiany.

Automatyczne tworzenie grup

Interfejs Remote Config API REST API udostępnia automatycznego tworzenia i publikowania grup parametrów. Zakładamy, że znasz mechanizm REST i masz skonfigurowane uprawnienia do autoryzowania żądań wysyłanych API, możesz wykonać te czynności, aby automatycznie zarządzać grupami:

1. Pobierz bieżący szablon
2. Dodaj obiekty JSON reprezentujące grupy parametrów
3. Opublikuj grupy parametrów za pomocą żądania HTTP PUT.

Obiekt parameterGroups zawiera klucze grup z zagnieżdżonym opisem i z listą zgrupowanych parametrów. Pamiętaj, że każdy klucz grupy musi być globalnie unikalny.

Oto przykład z wersji szablonu, w której dodano parametr grupa „nowe menu” z 1 parametrem, 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."
        }
      }
    }
  }
}

Typy reguł warunku

Konsola Firebase obsługuje podane niżej typy reguł. Odpowiednik jest dostępna w interfejsie API REST Remote Config, jak opisano w odwołanie do wyrażenia warunkowego.

Wyszukiwanie parametrów i warunków

Możesz wyszukiwać klucze parametrów, wartości parametrów i warunki projektu z konsoli Firebase za pomocą u góry karty Remote Config Parametry.

Ograniczenia parametrów i warunków

W projekcie Firebase możesz mieć do 2000 parametrów do 500 parametrów warunków. Klucze parametrów mogą mieć do 256 znaków i muszą zaczynać się od podkreślenie lub literę alfabetu angielskiego (A–Z, a–z), a także może zawierać liczby. Łączna długość ciągów wartości parametrów w projekcie nie może przekracza 1 000 000 znaków.

Wyświetlanie zmian w parametrach i warunkach

Możesz wyświetlić najnowsze zmiany w swoich szablonach Remote Config w konsoli Firebase. Dla: poszczególnych parametrów i warunków możesz:

• Wyświetl nazwę użytkownika, który ostatnio zmodyfikował parametr lub warunek.

• Jeśli zmiana nastąpiła tego samego dnia, sprawdź liczbę minut lub godz., które upłynęły od opublikowania zmiany w aktywnej Szablon Remote Config.

• Jeśli zmiana miała miejsce co najmniej 1 dzień w przeszłości, wyświetl datę zmiana została opublikowana w aktywnym szablonie Remote Config.

Aktualizacje parametrów

Na stronie Remote Config Parameters na stronie, kolumna Ostatnia publikacja zawiera informacje o użytkowniku, który ostatnio modyfikował poszczególne oraz datę ostatniej publikacji zmiany:

• Aby wyświetlić metadane zmian dla zgrupowanych parametrów, rozwiń grupę parametrów.

• Aby posortować rosnąco lub malejąco według daty publikacji, kliknij Etykieta kolumny Ostatnia publikacja.

Aktualizacje stanu

Remote Config Warunki, możesz wyświetlić ostatniego użytkownika, który zmodyfikował warunek, i datę jego modyfikacji; obok każdego warunku, obok pozycji Ostatnia modyfikacja.

Dalsze kroki

Aby zacząć konfigurować projekt Firebase, zobacz Skonfiguruj projekt Firebase Remote Config.