Szablony możesz konfigurować zarówno w przypadku klienta, jak i serwera. Szablony klienta są dostarczane do wszystkich instancji aplikacji, które implementują pakiety SDK klienta Firebase dla Remote Config, w tym do aplikacji na Androida, Apple, w przeglądarce, w Unity, Flutter i C++. Parametry i wartości Remote Config z szablonów związanych z serwerem są dostarczane do implementacji Remote Config (w tym Cloud Run i Cloud Functions), które korzystają z pakietu Firebase Admin Node.js SDK 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 są ciągami, ale wartości parametrów można przekształcić w inne typy danych, gdy używasz ich w aplikacji.
Za pomocą konsoli Firebase, Admin SDK lub Remote Config interfejsu API REST możesz tworzyć nowe wartości domyślne parametrów, a także wartości warunkowe, które służą do kierowania na grupy instancji aplikacji. Za każdym razem, gdy zaktualizujesz konfigurację w konsoli Firebase, Firebase utworzy i opublikuje nową wersję Twojego szablonu Remote Config. Poprzednia wersja jest przechowywana, dzięki czemu w razie potrzeby możesz ją odzyskać 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 w backendzie i aplikacji. Strona ta zawiera również szczegółowe informacje typów 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 składają się z co najmniej 1 reguły, która musi zwracać wartość true, aby warunek zwracał wartość true w przypadku danego wystąpienia aplikacji. Jeśli wartość reguły jest niezdefiniowana (np. gdy nie ma żadnej wartości), reguła zostanie oceniona jako false.
Możesz na przykład utworzyć parametr definiujący nazwę i ciąg znaków wersji dużego modelu językowego (LLM) oraz wyświetlać odpowiedzi z różnych modeli na podstawie reguł sygnałów niestandardowych. W w tym przypadku użycia, możesz użyć stabilnej wersji modelu jako wartości domyślnej obsługuje większość żądań i używa sygnału niestandardowego do stosowania modelu eksperymentalnego, odpowiadać na testowe żądania klientów.
Parametr może mieć wiele wartości warunkowych, które korzystają z różnych warunków, a parametry mogą mieć wspólne warunki w ramach projektu. Na karcie Parametry w konsoli Firebase możesz sprawdzić odsetek pobierania dla wartości warunkowych każdego 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 oraz wartości używane w danym wystąpieniu aplikacji w danym momencie punkt w czasie:
Najpierw wartości warunkowe są stosowane do dowolnych warunki, które dla danego żądania klienta przyjmują wartość
true. Jeśli wiele warunków ma wartośćtrue, pierwsza (górna) wartość wyświetlana w interfejsie konsoli Firebase ma pierwszeństwo, a wartości warunkowe powiązane z tym warunkiem są udostępniane, gdy aplikacja pobiera wartości z backendu. Priorytet warunków możesz zmienić, przeciągając je i upuszczając na karcie Warunki.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 z backendu. Jeśli parametr nie istnieje na zapleczu lub jeśli jego wartość domyślna to Użyj wartości domyślnej w aplikacji, podczas pobierania wartości przez aplikację nie jest podawana żadna wartość tego parametru.
W aplikacji wartości parametrów są zwracane przez metody get zgodnie z tą listą priorytetów:
- 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.
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 pobieraniu i ustawianiu wartości domyślnych znajdziesz w artykule Pobieranie domyślnych wartości szablonu Remote Config.
Jeśli nie ustawisz wartości domyślnej w aplikacji, aplikacja użyje wartości statycznej (np.
0dlaintifalsedlaboolean).
Na tej grafice znajdziesz podsumowanie sposobu ustalania priorytetów wartości parametrów na zapleczu Remote Config i w aplikacji:
Typy danych wartości parametrów
Remote Config umożliwia wybranie typu danych dla każdego parametru i sprawdza wszystkie wartości Remote Config pod kątem tego typu przed aktualizacją szablonu. Typ danych jest przechowywany i zwracany na urządzeniu getRemoteConfig
użytkownika.
Obsługiwane typy danych:
StringBooleanNumberJSON
W interfejsie konsoli Firebase typ danych można wybrać z menu obok klucza parametru. W interfejsie API typu REST typy można ustawiać za pomocą
w polu value_type w obiekcie parametru.
Grupy parametrów
Remote Config umożliwia grupowanie parametrów w celu uporządkowania interfejsu użytkownika i zwiększenia jego użyteczności.
Załóżmy na przykład, że podczas wdrażania nowej funkcji logowania musisz włączyć lub wyłączyć 3 różne typy uwierzytelniania. Remote Config umożliwia tworzenie te trzy parametry, by włączyć żądane typy, a potem uporządkować je 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 mogą być uwzględniane tylko w jednej grupie w danym momencie, a klucz parametru musi być unikalny w stosunku do 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, sprawdź, czy logika interfejsu API REST została zaktualizowana, aby obsługiwać grupy parametrów po opublikowaniu.
Utwórz lub zmodyfikuj grupy parametrów za pomocą konsoli Firebase
Parametry możesz grupować w funkcji Parametry w konsoli Firebase. Aby utworzyć lub zmodyfikować grupę:
- Wybierz Zarządzaj grupami.
- Zaznacz pola wyboru obok parametrów, które chcesz dodać, i wybierz Przenieś do grupy.
- Wybierz istniejącą grupę lub utwórz nową, wpisując jej nazwę i opis oraz klikając Utwórz nową grupę. Po zapisaniu grupy możesz ją opublikować, klikając przycisk Opublikuj zmiany.
Typy reguł warunku
Konsola Firebase obsługuje podane niżej typy reguł. Odpowiednie funkcje są dostępne w interfejsie API REST Remote Config, jak opisano w dokumentacji wyrażeń warunkowych.
| Typ reguły | Operatorzy | Wartości | Uwaga |
| Aplikacja | == | Wybierz z listy identyfikatory aplikacji powiązane z Twoim projektem Firebase. | Podczas dodawania aplikacji do Firebase wpisujesz identyfikator pakietu lub nazwę pakietu na Androida, które definiują atrybut udostępniany w regułach Remote Config jako identyfikator aplikacji.
Używaj tego atrybutu w ten sposób:
|
| Wersja aplikacji |
W przypadku wartości ciągów: ściśle pasuje do, zawiera, nie zawiera, zawiera wyrażenie regularne W przypadku wartości liczbowych: <, <=, =, !=, >, >= |
Określ wersje aplikacji, na które chcesz kierować reklamy. Zanim użyjesz tej reguły, musisz użyć reguły Identyfikator aplikacji, aby wybrać aplikację na Androida lub Apple powiązaną z Twoim projektem Firebase. |
Na platformach Apple: użyj wartości CFBundleShortVersionString aplikacji. Uwaga: upewnij się, że Twoja aplikacja Apple korzysta z pakietu SDK platform Apple na platformy Firebase. wersji 6.24.0 lub nowszej, ponieważ CFBundleShortVersionString nie jest wysyłane wcześniejszych wersji (zobacz informacje o wersji). Android: użyj parametru versionName aplikacji. W porównaniach ciągów znaków w ramach tej reguły wielkość liter ma znaczenie. Jeśli korzystasz z metody ściśle pasuje do, zawiera, nie zawiera lub zawiera wyrażenie regularne. Gdy używasz operatora zawiera wyrażenie regularne, możesz utworzyć zwykłe wyrażenia w RE2. . Wyrażenie regularne może pasować do całości lub części wersji docelowej ciągu znaków. Możesz też użyć kotwic ^ i $, aby dopasować początku, końca lub całości docelowego ciągu znaków. |
| Numer kompilacji |
W przypadku wartości ciągów: ściśle pasuje do, zawiera, nie zawiera, wyrażenie regularne W przypadku wartości liczbowych: =, ≠, >, ≥, <, ≤ |
Określ kompilacje aplikacji, na które chcesz kierować reklamy. Zanim użyjesz tej reguły, musisz użyć reguły Identyfikator aplikacji, aby wybrać aplikację na iOS lub Androida powiązaną z Twoim projektem Firebase. |
Ten operator jest dostępny tylko w przypadku aplikacji na urządzenia z systemem Apple i Android. Odpowiada ona CFBundleVersion na urządzeniu Apple i versionCode na Androidzie. Porównanie ciągów znaków w przypadku tej reguły to . Gdy używasz operatora ściśle pasuje do, zawiera, nie zawiera lub zawiera wyrażenie regularne, możesz wybrać większą liczbę wartości. Korzystając z operatora contains regex, możesz tworzyć wyrażenia regularne w formacie RE2. Wyrażenie regularne może pasować do całości lub części docelowego ciągu znaków. Możesz też użyć zakotwiczenia ^ i $, aby dopasować początek, koniec lub cały ciąg docelowy. |
| Platforma | == | iOS Android Sieć |
|
| System operacyjny | == |
Określ systemy operacyjne, na które chcesz kierować reklamy. Zanim użyjesz tej reguły, musisz użyć reguły Identyfikator aplikacji, by wybrać Aplikacja internetowa powiązana z projektem Firebase. |
W przypadku danej instancji aplikacji internetowej ta reguła zwraca wartość true, jeśli
system operacyjny i jego wersja są zgodne z wartością docelową na określonej liście.
|
| Przeglądarka | == |
Określ przeglądarki, na które chcesz kierować reklamy. Zanim użyjesz tej reguły, musisz użyć reguły Identyfikator aplikacji, aby wybrać aplikację internetową powiązaną z Twoim projektem Firebase. |
Ta reguła przyjmuje wartość true w przypadku danej instancji aplikacji internetowej, jeśli przeglądarka i jej wersja są zgodne z wartością docelową na określonej liście.
|
| Kategoria urządzenia | to, nie jest | komórka | Ta reguła określa, czy urządzenie, które korzysta z Twojej aplikacji internetowej, jest na inne urządzenia (komputery lub konsole). Ten typ reguły jest dostępny tylko w przypadku aplikacji internetowych. |
| Języki | zawiera się w | Wybierz co najmniej jeden język. | Ta reguła przyjmuje wartość true w przypadku danej instancji aplikacji, jeśli ta instancja jest zainstalowana na urządzeniu, na którym używany jest jeden z wymienionych języków.
|
| Kraj/region | zawiera się w | Wybierz co najmniej jeden region lub kraj. | Ta reguła przyjmuje wartość true dla danej instancji aplikacji, jeśli instancja znajduje się w którymś z wymienionych regionów lub krajów. 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).
|
| Odbiorcy | Zawiera przynajmniej jeden | Wybierz co najmniej jedną z listy Google Analytics grup odbiorców, która skonfigurowane na potrzeby projektu. | To wymaga reguły identyfikatora aplikacji, aby wybrać aplikację powiązaną z Twoim projektem Firebase. Uwaga: ponieważ wiele Analytics list odbiorców jest definiowanych na podstawie zdarzeń lub właściwości użytkownika, które mogą zależeć od działań użytkowników aplikacji, może minąć trochę czasu, zanim reguła Użytkownik na liście odbiorców zacznie obowiązywać w przypadku danej instancji aplikacji. |
| Właściwość użytkownika |
W przypadku wartości ciągu znaków:
zawiera, nie zawiera, ściśle pasuje do, zawiera wyrażenie regularne Wartości liczbowe: =, ≠, >, ≥, <, ≤ Uwaga: na kliencie możesz ustawić tylko wartości w postaci ciągu znaków dla użytkownika usług. W przypadku warunków z operatorami liczbowymi Remote Config konwertuje wartość odpowiedniej wartości właściwości użytkownika na liczbę całkowitą/zmiennoprzecinkową. |
Wybierz z listy dostępnych użytkowników aplikacji Google Analytics usług. | Aby dowiedzieć się, jak za pomocą właściwości użytkownika możesz dostosować aplikację do konkretnych segmentów bazy użytkowników, zapoznaj się z artykułem Właściwości użytkownika i Remote Config.
Aby dowiedzieć się więcej o właściwościach użytkownika, zapoznaj się z tymi przewodnikami:
Jeśli używasz opcji ściśle pasuje do, zawiera, nie zawiera lub zawiera wyrażenie regularne. Gdy używasz operatora zawiera wyrażenie regularne, możesz utworzyć zwykłe wyrażenia w RE2. . Wyrażenie regularne może pasować do całości lub części docelowego ciągu znaków. Możesz też użyć zakotwiczenia ^ i $, aby dopasować początek, koniec lub cały ciąg docelowy. Uwaga: zbierane automatycznie właściwości użytkownika niedostępne podczas tworzenia warunków Remote Config. |
| Użytkownik w losowym przedziale procentowym | Suwak (w konsoli Firebase.
Interfejs API REST używa
<=, > i between).
|
0-100 |
Użyj tego pola, aby zastosować zmianę do losowej próbki instancji aplikacji (z małymi próbkami) jako 0,0001%) przy użyciu widżetu suwaka, aby podzielić losowo wybranych użytkowników (wystąpienia aplikacji) grup. Każda instancja aplikacji jest stale mapowana na losową liczbę całkowitą lub ułamkową zgodnie z wartością zaczynu zdefiniowaną w tym projekcie. Reguła będzie używać klucza domyślnego (wyświetlanego jako Edytuj nasiono w konsoli Firebase), chyba że zmodyfikujesz wartość nasienia. Aby przywrócić regułę do używania klucza domyślnego, opróżnij pole Nasienie. Aby konsekwentnie kierować te same wystąpienia aplikacji do określonych zakresów procentowych, używaj w warunkach tej samej wartości początkowej. Możesz też wybrać nową losowo przypisaną grupę instancji aplikacji dla danego zakresu procentowego przez określenie nowego materiału wyjściowego. Aby na przykład utworzyć 2 powiązane warunki, z których każdy będzie dotyczyć nienakładających się na siebie 5% użytkowników aplikacji, możesz skonfigurować 1 warunek tak, aby pasował do wartości procentowej między 0% a 5%, a drugi – tak, aby pasował do zakresu między 5% a 10%. Aby niektórzy użytkownicy mogli losowo pojawiać się w obu grupach, użyj różnych wartości początkowych dla reguł w każdym z warunków. |
| Zaimportowany segment | zawiera się w | Wybierz co najmniej 1 zaimportowany segment. | To wymaga skonfigurowania importowanych segmentów niestandardowych. |
| Data/godzina | Przed i po | określona data i godzina w strefie czasowej urządzenia lub w określonym miejscu. strefę czasową, na przykład „(GMT+11) czas Sydney”. | Porównuje bieżącą godzinę z czasem pobrania z urządzenia. |
| Pierwsze uruchomienie | Przed i po | Określona data i godzina w określonej strefie czasowej. | Dopasowuje użytkowników, którzy po raz pierwszy uruchomili docelową aplikację w określonym regionie zakres czasowy. Wymaga tych pakietów SDK:
|
| Identyfikator instalacji | zawiera się w | Podaj co najmniej 1 identyfikator instalacji (maksymalnie 50), na który chcesz kierować reklamy. | Ta reguła zwraca wartość true w przypadku danej instalacji, jeśli ta wartość
jest na liście wartości rozdzielonych przecinkami.
Aby dowiedzieć się, jak pobrać identyfikatory instalacji, przeczytaj artykuł Pobieranie identyfikatorów klienta. |
| Użytkownik istnieje | (brak operatora) | Kieruje reklamy na wszystkich użytkowników wszystkich aplikacji w bieżącym projekcie. |
Użyj tej reguły warunku, aby dopasować wszystkich użytkowników w projekcie, niezależnie od aplikacji lub platformy. |
Parametry i warunki wyszukiwania
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ć maksymalnie 2000 parametrów i 500 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 znaków wartości parametrów w projekcie nie może przekraczać 1 mln znaków.
Wyświetlanie zmian parametrów i warunków
Możesz wyświetlić najnowsze zmiany w swoich szablonach Remote Config w konsoli Firebase. W przypadku każdego parametru i każdego warunku 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ń temu, sprawdź, kiedy została opublikowana w aktywnym szablonie Remote Config.
Historia zmian parametrów
Na stronie Remote Config Parametry kolumna Ostatnia publikacja zawiera informacje o użytkowniku, który ostatnio zmodyfikował dany parametr, oraz o dacie ostatniej publikacji zmiany:
Aby wyświetlić metadane zmian dla zgrupowanych parametrów, rozwiń grupę parametrów.
Aby posortować według daty publikacji w kolejności rosnącej lub malejącej, kliknij etykietę kolumny Ostatnia publikacja.
Historia zmian warunków
Na stronie Remote Config Warunki możesz zobaczyć ostatniego użytkownika, który zmodyfikował warunek, oraz datę modyfikacji obok każdego warunku obok Ostatnia modyfikacja.