Parametry i warunki Zdalnej konfiguracji

Firebase Remote Config umożliwia dynamiczne kontrolowanie działania i wyglądu aplikacji bez konieczności pobierania aktualizacji przez użytkowników ani ponownego wdrażania backendu.

Aby skonfigurować aplikacje, definiujesz parametry (pary klucz-wartość) w Remote Config i używasz ich w kodzie aplikacji lub backendu. Możesz też zdefiniować warunki (reguły kierowania), aby przypisać wartości warunkowe, które zastępują wartości domyślne w przypadku określonych odbiorców, środowisk lub kryteriów niestandardowych.

Remote Config porządkuje parametry i warunki w szablony. W zależności od architektury możesz używać szablonów klienta, szablonów serwera lub obu tych typów:

  • Parametry i warunki w szablonach klienta: udostępniaj konfiguracje instancjom aplikacji klienckich na platformach Apple, Android, Web, Flutter, Unity i C++. Kieruj reklamy na instancje aplikacji, korzystając z odbiorców, wersji aplikacji, platformy, języka urządzenia, kraju, percentyli użytkowników i niestandardowych sygnałów po stronie klienta w usłudze Google Analytics.

  • Parametry i warunki w szablonach serwera: udostępniaj konfiguracje środowiskom backendu, takim jak Cloud Run, Cloud Functions for Firebase lub serwery kontenerowe, za pomocą Firebase Admin SDK w przypadku Node.js, Pythona, Go i Javy. Oceniaj parametry po stronie serwera z niemal zerowym opóźnieniem, korzystając z niestandardowych sygnałów serwera i losowych procentowych wdrożeń.

Porównanie szablonów klienta i serwera

Szablony klienta i serwera obsługują różne architektury, pakiety SDK i reguły kierowania. W tabeli poniżej znajdziesz informacje o tym, który typ szablonu pasuje do Twojego przypadku użycia:

Funkcja Szablony klienta Szablony serwerów
Środowiska docelowe Aplikacje klienckie (Apple, Android, Web, Flutter, Unity, C++) środowiska serwerów (Cloud Run, Cloud Functions for Firebase, GKE, usługi backendu);
Obsługiwane pakiety SDK Pakiety SDK klienta Firebase Firebase Admin SDK (Node.js, Python, Go, Java)
Model oceny Pobierane i zapisywane w pamięci podręcznej na urządzeniach klientów; aktywowane przez kod aplikacji Wczytywane do pamięci serwera; oceniane na żądanie z czasem oczekiwania bliskim zeru
Reguły dotyczące stanu Wersja aplikacji, system operacyjny/platforma, język urządzenia, kraj/region, Analytics odbiorcy i właściwości użytkownika, użytkownik w losowym percentylu, pierwsze otwarcie aplikacji, niestandardowe sygnały klienta Użytkownik w losowym odsetku, niestandardowe sygnały serwera
Częste przypadki użycia Wdrażanie funkcji, promocje sezonowe, motywy interfejsu, A/B Testing, personalizacja Prompt AI i wybór modelu, flagi funkcji po stronie serwera, ograniczanie liczby żądań backendu, dynamiczne kierowanie
Szczegółowy przewodnik Parametry w szablonach klienta Parametry w szablonach serwera

Podstawowe pojęcia

Niezależnie od tego, czy pracujesz z szablonami klienta czy serwera, Remote Config ma te same podstawowe pojęcia:

Parametry

Parametry to pary klucz-wartość, które definiujesz w konsoli Firebase lub za pomocą interfejsów API backendu Remote Config.

  • Klucze parametrów: ciągi znaków identyfikujące parametry. Klucze mogą mieć do 256 znaków, muszą zaczynać się od podkreślenia lub litery z alfabetu angielskiego (A–Z, a–z) i mogą zawierać cyfry.
  • Wartości parametrów: wartości przypisane do parametrów. Wartości są przechowywane jako ciągi znaków, ale w konsoli możesz wybrać typy danych, aby sprawdzać wartości pod kątem formatów takich jak String, Boolean, Number lub JSON.
  • Wartości domyślne: wartość podstawowa przypisywana, gdy nie obowiązują żadne reguły warunkowe. Możesz zdefiniować domyślne wartości w aplikacji w kodzie, a także domyślne wartości szablonu w backendzie Remote Config.

Warunki, reguły i wartości warunkowe

Warunki umożliwiają kierowanie na określone segmenty użytkowników aplikacji lub żądań serwera z dostosowanymi wartościami parametrów niestandardowych:

  • Reguły: poszczególne kryteria oceniane na podstawie metadanych klienta lub kontekstów żądań (np. numeru wersji, kraju lub sygnału niestandardowego).
  • Warunki: nazwane zestawy co najmniej 1 reguły. Aby warunek został oceniony jako true, wszystkie reguły w warunku muszą zostać ocenione jako true.
  • Wartości warunkowe: wartości alternatywne przypisywane do parametru, gdy warunek ma wartość true. Jeśli kilka warunków ma wartość true, pierwszeństwo ma warunek o najwyższym priorytecie w konsoli Firebase.

Grupy parametrów

Aby uporządkować konfiguracje z dziesiątkami lub setkami parametrów, możesz użyć grup parametrów. Grupy zapewniają wizualną organizację w konsoli Firebase i logiczne grupowanie w interfejsie REST API.

  • Parametr może należeć tylko do jednej grupy naraz.
  • Klucze parametrów pozostają globalnie unikalne w projekcie niezależnie od grupowania.
  • Grupowanie nie zmienia sposobu odwoływania się do wartości parametrów w kodzie pakietu SDK.

Instrukcje tworzenia grup i zarządzania nimi znajdziesz w szczegółowych przewodnikach po parametrach klienta i serwera.

Obsługa wersji szablonów i przywracanie

Za każdym razem, gdy aktualizujesz i publikujesz parametry lub warunki w Remote Config, Firebase tworzy i zapisuje nową wersję szablonu. Możesz wyświetlać historię zmian, porównywać zmiany między wersjami i w razie potrzeby przywracać poprzednią wersję.

Więcej informacji o zarządzaniu wersjami szablonów znajdziesz w artykule Zarządzanie wersjami szablonów Remote Config.

Limity

W projekcie w Firebase Remote Config stosuje te limity:

  • Parametry: maksymalnie 3000 parametrów na projekt.
  • Warunki: maksymalnie 2000 warunków na projekt.
  • Długość klucza parametru: do 256 znaków.
  • Łączna długość ciągu znaków wartości: do 1 000 000 znaków we wszystkich wartościach parametrów w projekcie.

Pełną listę limitów znajdziesz w artykule Limity.

Dalsze kroki