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 lub ponownego wdrażania backendu.

Aby skonfigurować aplikacje, zdefiniuj w Remote Config parametry (pary klucz-wartość) i użyj ich w kodzie aplikacji lub backendu. Możesz też zdefiniować warunki (reguły kierowania), aby przypisywać 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 szablonach. W zależności od architektury możesz używać szablonów klientów, szablonów serwera lub obu tych rodzajów szablonów:

  • Parametry i warunki w szablonach klienta: konfiguracje wyświetlania w instancjach aplikacji klienckiej na platformach Apple, Android, Web, Flutter, Unity i C++. Kieruj reklamy na instancje aplikacji za pomocą Google Analyticsgrup odbiorców, wersji aplikacji, platformy, języka urządzenia, kraju, percentyli użytkowników i niestandardowych sygnałów po stronie klienta.

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

Porównywanie szablonów klienta i serwera

Szablony klienta i serwera obsługują różne architektury i różne pakiety SDK oraz reguły kierowania. W tabeli poniżej znajdziesz informacje o tym, który typ szablonu jest odpowiedni w Twoim przypadku:

Funkcja Szablony klientów Szablony serwerów
Środowiska docelowe Aplikacje klienckie (Apple, Android, internetowe, Flutter, Unity, C++) Środowiska serwerowe (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 przechowywane w pamięci podręcznej na urządzeniach klientów; aktywowane przez kod aplikacji Wczytane do pamięci serwera; oceniane na podstawie każdego żądania z niemal zerowym czasem oczekiwania.
Reguły warunków wersja aplikacji, system operacyjny lub platforma, język urządzenia, kraj lub 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 Wprowadzanie nowych funkcji, promocje sezonowe, motywy interfejsu, A/B Testing, personalizacja wybór promptów i modeli AI, flagi funkcji po stronie serwera, ograniczanie liczby żądań backendu, dynamiczne routing
Szczegółowy przewodnik Parametry w szablonach klienta Parametry w szablonach serwera

Podstawowe pojęcia

Niezależnie od tego, czy pracujesz z szablonami klienta czy szablonami serwera, Remote Config mają one wspólne podstawowe pojęcia:

Parametry

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

  • Klucze parametrów: ciągi znaków identyfikujące parametry. Klucze mogą mieć maksymalnie 256 znaków, muszą zaczynać się od podkreślenia lub litery 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 przypisana, gdy nie obowiązują żadne reguły warunków. Wartości domyślne w aplikacji możesz zdefiniować w kodzie, a wartości domyślne szablonu w Remote Config backendzie.

Warunki, reguły i wartości warunkowe

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

  • Reguły: poszczególne kryteria oceniane na podstawie metadanych klienta lub kontekstów żądań (np. numeru wersji, kraju lub sygnału niestandardowego).
  • Warunki: nazwane zbiory 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 przyjmuje 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 API REST.

  • Parametr może należeć tylko do jednej grupy naraz.
  • Klucze parametrów pozostają globalnie niepowtarzalne w całym 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.

Wersje szablonu i przywracanie

Za każdym razem, gdy aktualizujesz i publikujesz parametry lub warunki w Remote Config, Firebase tworzy i zapisuje nową wersję szablonu. W razie potrzeby możesz wyświetlić historię zmian, porównać zmiany między wersjami i wycofać zmiany do poprzedniej wersji.

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

Limity

W projekcie w Firebase Remote Config obowiązują te limity:

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

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

Dalsze kroki