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 na potrzeby Zdalnej konfiguracji, w tym Android, Apple, Web, Unity oraz aplikacje Flutter i C++. Parametry i wartości Zdalnej konfiguracji z: szablony serwerowe są udostępniane w ramach implementacji Zdalnej konfiguracji; (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 interfejsy API backendu Zdalnej konfiguracji, 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.
Za pomocą konsoli Firebase pakiet Admin SDK lub Zdalna konfiguracja REST API, 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ę szablonu Zdalnej konfiguracji. Dostępna jest poprzednia wersja, dzięki czemu w razie potrzeby możesz ją przywrócić lub przywrócić. Operacje te są dostępne w konsoli Firebase, pakietu Firebase Admin SDK i interfejsu API REST. Zostały one szczegółowo opisane w Zarządzaj wersjami szablonów Zdalnej konfiguracji.
W tym przewodniku objaśniamy parametry, warunki, reguły, oraz uszeregowania ich według priorytetów na serwerze Zdalnej konfiguracji i w 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ą, która wartość jest pobierana ze Zdalnej konfiguracji. 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
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
, pierwszeństwo ma pierwsza (najwyższa) opcja widoczna w interfejsie konsoli Firebase; 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.Jeśli nie ma wartości warunkowych z warunkami, które przyjmują wartość
true
, domyślna wartość Zdalnej konfiguracji 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
- 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 Zdalnej konfiguracji nie został aktywowany, aplikacja korzysta z interfejsu wartość domyślną.
Więcej informacji o uzyskiwaniu i ustawianiu wartości domyślnych znajdziesz w sekcji Pobierz wartości domyślne szablonu Zdalnej konfiguracji
Jeśli nie ustawiono domyślnej wartości w aplikacji, aplikacja używa typu statycznego. (np.
0
w przypadkuint
ifalse
dlaboolean
).
Ta grafika podsumowuje priorytety wartości parametrów w w backendzie Zdalnej konfiguracji i w aplikacji:
Typy danych wartości parametrów
Zdalna konfiguracja pozwala wybrać typ danych dla każdego parametru.
sprawdza wszystkie wartości Zdalnej konfiguracji dla 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ć z menu
do klucza parametru. W interfejsie API REST typy można ustawiać za pomocą interfejsu value_type
.
w obiekcie parametru.
Grupy parametrów
Zdalna konfiguracja pozwala grupować parametry, aby lepiej zorganizować 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. Dzięki Zdalnej konfiguracji możesz tworzyć 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 Zdalnej konfiguracji. Każda grupa parametrów, którą utworzysz, ma unikalną nazwę z szablonu Zdalnej konfiguracji. 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.
Tworzenie i modyfikowanie grup parametrów za pomocą konsoli Firebase
Parametry możesz grupować w Karta Parametry funkcji 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 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:
- Pobierz bieżący szablon
- Dodaj obiekty JSON reprezentujące grupy parametrów
- 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 typu REST Zdalnej konfiguracji, jak opisano w odniesienie do wyrażenia warunkowego.
Typ reguły | Operatory | Wartości | Uwaga |
---|---|---|---|
Aplikacja | == | Wybierz z listy identyfikatory aplikacji powiązanych z Firebase w projektach AI. | Dodając aplikację do Firebase, podajesz identyfikator pakietu lub Androida.
nazwę pakietu, która definiuje atrybut widoczny jako App ID w
Reguły Zdalnej konfiguracji.
Użyj tego atrybutu w następujący sposób:
|
Wersja aplikacji |
W przypadku wartości ciągów: ściśle pasuje do, zawiera, nie 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, by wybrać Aplikacja na Androida lub Apple powiązana z projektem Firebase. |
Platformy Apple: użyj parametru 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 przypadku tej reguły wielkość liter ma znaczenie. Jeśli korzystasz z metody ściśle pasuje do, zawiera, nie zawiera lub wyrażenie regularne, możesz wybrać wiele wartości. Korzystając z operatora wyrażenia regularnego, możesz tworzyć 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 App ID, aby wybrać Apple lub Aplikacja na Androida powiązana z projektem Firebase. |
Ten operator jest dostępny tylko w przypadku aplikacji Apple i na Androida. Odpowiada ona CFBundleVersion na urządzeniu Apple i versionCode na Androidzie. Porównanie ciągów znaków w przypadku tej reguły to . Jeśli używasz opcji ściśle pasuje do, zawiera, nie zawiera lub wyrażenie regularne, możesz wybrać wiele wartości. Korzystając z operatora wyrażenia regularnego, możesz tworzyć 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. |
Platforma | == | iOS Android Internet |
|
System operacyjny | == |
Określ systemy operacyjne, na które mają być kierowane 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 mają być kierowane 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
przeglądarki i jej wersji pasują do wartości docelowej 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 witryn aplikacji. |
Języki | zawiera się w | Wybierz co najmniej jeden język. | W przypadku danej instancji aplikacji ta reguła zwraca wartość true , jeśli
instancja aplikacji jest zainstalowana na urządzeniu używającym jednego z wymienionych języków.
|
Kraj lub region | zawiera się w | Wybierz co najmniej jeden region lub kraj. | W przypadku danej instancji aplikacji ta reguła zwraca wartość true , jeśli
znajduje się w dowolnym z wymienionych regionów lub krajów. Kod kraju urządzenia
jest określany na podstawie adresu IP urządzenia wskazanego w żądaniu lub kodu kraju
zależy od Firebase Analytics (jeśli dane Analytics są udostępniane Firebase).
|
Odbiorcy | Zawiera przynajmniej jeden | Wybierz co najmniej jedną listę odbiorców Google Analytics, która skonfigurowane na potrzeby projektu. | Ta reguła wymaga, aby reguła identyfikatora aplikacji mogła wybrać aplikację powiązaną z Twoim kontem projekt Firebase. Uwaga: wiele list odbiorców Analytics jest definiowanych przez zdarzenia lub właściwości użytkownika, które mogą być oparte na działaniach użytkowników aplikacji, może zająć trochę czasu, zanim reguła Użytkownik na liście odbiorców zacznie obowiązywać w przypadku danej aplikacji. instancji. |
Właściwość użytkownika |
W przypadku wartości ciągu znaków:
zawiera, nie zawiera, ściśle pasuje do, 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 Zdalna konfiguracja konwertuje wartość odpowiednich wartości właściwości użytkownika na liczbę całkowitą/zmiennoprzecinkową. |
Wybierz użytkownika z listy dostępnych użytkowników Google Analytics usług. | Aby dowiedzieć się, jak wykorzystać właściwości użytkownika do dostosowania aplikacji
segmentów odbiorców, zapoznaj się z
Zdalna konfiguracja i właściwości użytkownika.
Więcej informacji o właściwościach użytkownika znajdziesz w tych przewodnikach:
Jeśli używasz opcji ściśle pasuje do, zawiera, nie zawiera lub wyrażenia regularnego, możesz wybrać wiele wartości. Korzystając z operatora wyrażenia regularnego, możesz tworzyć 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. Uwaga: zbierane automatycznie właściwości użytkownika nie są obecnie dostępne podczas tworzenia warunków Zdalnej konfiguracji. |
Użytkownik w losowym procentie | 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 próbkami o wielkości od 0,0001%) przy użyciu widżetu suwaka , aby podzielić losowo dobranych użytkowników (wystąpienia aplikacji) w grupy. Każda instancja aplikacji jest trwale zmapowana na losową całość. lub liczbę ułamkową zgodnie z wartością wyjściowej zdefiniowanej w danym projekcie. Reguła będzie używać klucza domyślnego (wyświetlanego jako Edytuj plik wyjściowy w konsoli Firebase), chyba że zmodyfikujesz wartość początkową. Możesz zwrócić regułę do przy użyciu klucza domyślnego, usuwając pole Seed (Materiał wyjściowy). Spójność adresowania tych samych wystąpień aplikacji z uwzględnieniem określonego odsetka możesz używać tej samej wartości wyjściowej w różnych warunkach. Możesz też wybrać nowy losowo przypisana grupa instancji aplikacji w danym zakresie procentowym przez i określić nowe źródło. Aby np. utworzyć 2 powiązane warunki, z których każdy będzie miał zastosowanie do użytkowników aplikacji nie może nakładać się na 5% użytkowników, można skonfigurować jeden warunek dopasowania wartość procentową od 0% do 5% i skonfigurować inny warunek, aby pasował do zakresu. od 5% do 10%. Aby umożliwić niektórym użytkownikom losowe pojawianie się w obu grupach, użyj funkcji różne wartości wyjściowe dla reguł w każdym warunku. |
Zaimportowany segment | zawiera się w | Wybierz co najmniej 1 zaimportowany segment. | Ta reguła wymaga skonfigurowania niestandardowej zaimportowanych segmentów. |
Data/godzina | Przed, 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, 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), który ma być celem kierowania. | W przypadku danej instalacji reguła ta zwraca wartość true , jeśli
jest na liście wartości rozdzielonych przecinkami.
Aby dowiedzieć się, jak uzyskać identyfikatory instalacji, zobacz Pobieranie identyfikatorów klientów. |
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.
|
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 Parameters Zdalnej konfiguracji.
Ograniczenia parametrów i warunków
W projekcie Firebase możesz mieć do 2000 parametrów do 500 parametrów conditions. 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 szablonach Zdalnej konfiguracji z 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 Zdalnej konfiguracji.
Jeśli zmiana miała miejsce co najmniej 1 dzień w przeszłości, wyświetl datę zmiana została opublikowana w aktywnym szablonie Zdalnej konfiguracji.
Aktualizacje parametrów
W sekcji Parametry Zdalnej konfiguracji. na stronie, kolumna Ostatnia publikacja zawiera informacje o tym, kto 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
W Zdalnej konfiguracji Warunki możesz wyświetlić ostatniego użytkownika, który zmodyfikował warunek, i datę jego modyfikacji; obok każdego warunku, obok pola Ostatnia modyfikacja.
Dalsze kroki
Aby zacząć konfigurować projekt Firebase, zobacz Skonfiguruj projekt Zdalnej konfiguracji Firebase.