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
Najpierw stosowane są wartości warunkowe, jeśli istnieją warunki oceniające do
truew 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.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
- 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 uzyskiwaniu i ustawianiu wartości domyślnych znajdziesz w sekcji Pobierz domyślne ustawienia szablonu Remote Config
Jeśli nie ustawiono domyślnej wartości w aplikacji, aplikacja używa typu statycznego. (np.
0w przypadkuintifalsedlaboolean).
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:
StringBooleanNumberJSON
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ę:
- 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 REST Remote Config, jak opisano w odwołanie 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
Remote Config reguł.
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/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ą z listy Google Analytics grup odbiorców, 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: ponieważ wielu odbiorców Analytics jest zdefiniowanych na podstawie zdarzeń 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 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 wykorzystać właściwości użytkownika do dostosowania aplikacji
segmentów odbiorców, zapoznaj się z
Remote Config 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 Remote Config. |
| 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 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 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.