Вы можете настроить шаблоны для случаев использования как клиента, так и сервера. Клиентские шаблоны обслуживаются любыми экземплярами приложений, которые реализуют клиентские SDK Firebase для Remote Config , включая приложения Android, Apple, Web, Unity, Flutter и C++. Параметры и значения Remote Config из шаблонов, специфичных для сервера, обслуживаются реализациями Remote Config (включая Cloud Run и Cloud Functions), которые используют следующие серверные среды:
- Firebase Admin Node.js SDK v12.1.0+
- Firebase Admin Python SDK v6.7.0+
При использовании консоли Firebase или API-интерфейсов Remote Config backend вы определяете один или несколько параметров (пар ключ-значение) и предоставляете значения по умолчанию в приложении для этих параметров. Вы можете переопределить значения по умолчанию в приложении, определив значения параметров. Ключи и значения параметров являются строками, но значения параметров могут быть преобразованы в другие типы данных, когда вы используете эти значения в своем приложении.
Используя консоль Firebase , Admin SDK или REST API Remote Config , вы можете создавать новые значения по умолчанию для своих параметров, а также условные значения, которые используются для целевых групп экземпляров приложений. Каждый раз, когда вы обновляете свою конфигурацию в консоли Firebase , Firebase создает и публикует новую версию вашего шаблона Remote Config . Предыдущая версия сохраняется, что позволяет вам извлекать или откатывать ее по мере необходимости. Эти операции доступны вам в консоли Firebase , Firebase Admin SDK и REST API и более подробно описаны в разделе Управление версиями шаблонов Remote Config .
В этом руководстве объясняются параметры, условия, правила, условные значения и то, как различные значения параметров приоритизируются на бэкэнде Remote Config и в вашем приложении. В нем также приводятся сведения о типах правил, используемых для создания условий.
Условия, правила и условные значения
Условие используется для нацеливания на группу экземпляров приложения. Условия состоят из одного или нескольких правил, которые должны все оцениваться как true , чтобы условие оценивалось как true для данного экземпляра приложения. Если значение правила не определено (например, когда нет доступных значений), это правило будет оцениваться как false .
Например, вы можете создать параметр, который определяет имя модели большой языковой модели (LLM) и строку версии, и обслуживать ответы от разных моделей на основе пользовательских правил сигнала . В этом варианте использования вы можете использовать стабильную версию модели в качестве значения по умолчанию для обслуживания большинства запросов и использовать пользовательский сигнал для использования экспериментальной модели для ответа на запросы тестовых клиентов.
Параметр может иметь несколько условных значений, которые используют разные условия, а параметры могут совместно использовать условия в рамках проекта. На вкладке Параметры консоли Firebase можно просмотреть процент выборки для условных значений каждого параметра. Эта метрика указывает процент запросов за последние 24 часа, которые получили каждое значение.
Приоритет значения параметра
Параметр может иметь несколько условных значений, связанных с ним. Следующие правила определяют, какое значение извлекается из шаблона Remote Config и какое значение используется в данном экземпляре приложения в определенный момент времени:
Во-первых, условные значения применяются для любых условий, которые оцениваются как
trueдля данного клиентского запроса. Если несколько условий оцениваются какtrue, первое (верхнее) условие, показанное в пользовательском интерфейсе консоли Firebase имеет приоритет, и условные значения, связанные с этим условием, предоставляются, когда приложение извлекает значения из бэкэнда. Вы можете изменить приоритет условий, перетаскивая условия на вкладке Условия .Если нет условных значений с условиями, которые оцениваются как
true, то значение по умолчанию Remote Config предоставляется, когда приложение извлекает значения из бэкэнда. Если параметр не существует в бэкэнде или если значение по умолчанию установлено на Use in-app default , то для этого параметра не предоставляется значение, когда приложение извлекает значения.
В вашем приложении значения параметров возвращаются методами get в соответствии со следующим списком приоритетов:
- Если значение было извлечено из бэкэнда и затем активировано, приложение использует извлеченное значение. Активированные значения параметров являются постоянными.
Если из бэкэнда не было получено ни одного значения или если значения, полученные из бэкэнда Remote Config не были активированы, приложение использует встроенное в приложение значение по умолчанию.
Дополнительную информацию о получении и настройке значений по умолчанию см. в разделе Загрузка шаблонов Remote Config по умолчанию .
Если в приложении не установлено значение по умолчанию, приложение использует статическое значение типа (например,
0дляintиfalseдляboolean).
На этом рисунке показано, как значения параметров приоритетны в бэкэнде Remote Config и в вашем приложении:
Типы данных значений параметров
Remote Config позволяет выбрать тип данных для каждого параметра и проверяет все значения Remote Config по этому типу перед обновлением шаблона. Тип данных сохраняется и возвращается по запросу getRemoteConfig .
Поддерживаемые типы данных:
-
String -
Boolean -
Number -
JSON
В пользовательском интерфейсе консоли Firebase тип данных можно выбрать из раскрывающегося списка рядом с ключом параметра. В REST API типы можно задать с помощью поля value_type в объекте параметра.
Группы параметров
Remote Config позволяет группировать параметры для более организованного пользовательского интерфейса и повышения удобства использования.
Например, скажем, вам нужно включить или отключить три разных типа аутентификации при развертывании новой функции входа. С помощью Remote Config вы можете создать три параметра для включения нужных вам типов, а затем организовать их в группу под названием «Новый вход», без необходимости добавлять префиксы или специальную сортировку.
Вы можете создавать группы параметров с помощью консоли Firebase или REST API Remote Config . Каждая созданная вами группа параметров имеет уникальное имя в шаблоне Remote Config . При создании групп параметров имейте в виду:
- Параметры могут быть включены только в одну группу одновременно, и ключ параметра должен быть уникальным для всех параметров.
- Длина имен групп параметров ограничена 256 символами.
- Если вы используете и REST API, и консоль Firebase , убедитесь, что вся логика REST API обновлена для обработки групп параметров при публикации.
Создание или изменение групп параметров с помощью консоли Firebase
Вы можете группировать параметры на вкладке «Параметры» консоли Firebase . Чтобы создать или изменить группу:
- Выберите Управление группами .
- Установите флажки для параметров, которые вы хотите добавить, и выберите Переместить в группу .
- Выберите существующую группу или создайте новую, введя имя и описание и выбрав Создать новую группу . После сохранения группы ее можно опубликовать с помощью кнопки Опубликовать изменения .
Типы правил условий
В консоли Firebase поддерживаются следующие типы правил. Эквивалентные функции доступны в Remote Config REST API, как подробно описано в справочнике условных выражений .
| Тип правила | Оператор(ы) | Ценности) | Примечание |
| Приложение | == | Выберите из списка идентификаторов приложений, связанных с вашим проектом Firebase. | При добавлении приложения в Firebase вы вводите идентификатор пакета или имя пакета Android, определяющее атрибут, который отображается как идентификатор приложения в правилах Remote Config . Используйте этот атрибут следующим образом:
|
| Версия приложения | Для строковых значений: точно совпадает, содержит, не содержит, содержит регулярное выражение Для числовых значений: <, <=, =, !=, >, >= | Укажите целевую версию(и) вашего приложения. Перед использованием этого правила необходимо использовать правило App ID , чтобы выбрать приложение Android/Apple, связанное с вашим проектом Firebase. | Для платформ Apple: используйте CFBundleShortVersionString приложения. Примечание: Убедитесь, что ваше приложение Apple использует Firebase Apple platform SDK версии 6.24.0 или выше, так как CFBundleShortVersionString не отправляется в более ранних версиях (см. примечания к выпуску ). Для Android: используйте versionName приложения. Сравнения строк для этого правила чувствительны к регистру. При использовании оператора exact matches , contains , does not contain или contains regex можно выбрать несколько значений. При использовании оператора contains regex вы можете создавать регулярные выражения в формате RE2 . Ваше регулярное выражение может соответствовать всей или части целевой строки версии. Вы также можете использовать якоря ^ и $ для соответствия началу, концу или всей целевой строке. |
| Номер сборки | Для строковых значений: точно совпадает, содержит, не содержит, регулярное выражение Для числовых значений: =, ≠, >, ≥, <, ≤ | Укажите целевую сборку(ы) вашего приложения. Перед использованием этого правила необходимо использовать правило App ID , чтобы выбрать приложение Apple или Android, связанное с вашим проектом Firebase. | Этот оператор доступен только для приложений Apple и Android. Он соответствует CFBundleVersion приложения для Apple и versionCode для Android. Сравнения строк для этого правила чувствительны к регистру. При использовании оператора регулярного выражения «точно соответствует» , «содержит» , «не содержит» или «содержит» можно выбрать несколько значений. При использовании оператора contains regex вы можете создавать регулярные выражения в формате RE2 . Ваше регулярное выражение может соответствовать всей или части целевой строки версии. Вы также можете использовать якоря ^ и $ для соответствия началу, концу или всей целевой строке. |
| Платформа | == | iOS андроид Веб | |
| Операционная система | == | Укажите целевую операционную систему(ы). Перед использованием этого правила необходимо использовать правило App ID , чтобы выбрать веб-приложение, связанное с вашим проектом Firebase. | Это правило оценивается как true для данного экземпляра веб-приложения, если операционная система и ее версия соответствуют целевому значению в указанном списке. |
| Браузер | == | Укажите целевой браузер(ы). Перед использованием этого правила необходимо использовать правило App ID , чтобы выбрать веб-приложение, связанное с вашим проектом Firebase. | Это правило оценивается как true для данного экземпляра веб-приложения, если браузер и его версия соответствуют целевому значению в указанном списке. |
| Категория устройства | есть, нет | мобильный | Это правило оценивает, является ли устройство, получающее доступ к вашему веб-приложению, мобильным или немобильным (настольным компьютером или консолью). Этот тип правила доступен только для веб-приложений. |
| Языки | находится в | Выберите один или несколько языков. | Это правило оценивается как true для данного экземпляра приложения, если этот экземпляр приложения установлен на устройстве, использующем один из перечисленных языков. |
| Страна/регион | находится в | Выберите один или несколько регионов или стран. | Это правило оценивается как true для данного экземпляра приложения, если экземпляр находится в любом из перечисленных регионов или стран. Код страны устройства определяется с использованием IP-адреса устройства в запросе или кода страны, определенного Firebase Analytics (если данные Analytics передаются в Firebase). |
| Аудитория(и) пользователей | Включает в себя как минимум один | Выберите одну или несколько аудиторий из списка Google Analytics , которые вы настроили для своего проекта. | Это правило требует правила идентификатора приложения для выбора приложения, связанного с вашим проектом Firebase. Примечание: Поскольку многие аудитории Analytics определяются событиями или свойствами пользователей, которые могут быть основаны на действиях пользователей приложения, может потребоваться некоторое время, чтобы правило «Пользователь в аудитории» вступило в силу для данного экземпляра приложения. |
| Собственность пользователя | Для строковых значений: содержит, не содержит, точно совпадает, содержит регулярное выражение Для числовых значений: =, ≠, >, ≥, <, ≤ Примечание: На клиенте можно задать только строковые значения для свойств пользователя. Для условий, использующих числовые операторы, Remote Config преобразует значение соответствующего свойства пользователя в целое число/число с плавающей точкой. | Выберите из списка доступных свойств пользователя Google Analytics . | Чтобы узнать, как использовать свойства пользователя для настройки приложения для определенных сегментов вашей пользовательской базы, см. Remote Config и свойства пользователя . Дополнительную информацию о свойствах пользователя можно найти в следующих руководствах: При использовании операторов регулярных выражений «точно соответствует» , «содержит» , «не содержит» или «содержит» можно выбрать несколько значений. При использовании оператора contains regex вы можете создавать регулярные выражения в формате RE2 . Ваше регулярное выражение может соответствовать всей или части целевой строки версии. Вы также можете использовать якоря ^ и $ для соответствия началу, концу или всей целевой строке. Примечание: автоматически собранные свойства пользователя недоступны при создании условий Remote Config . |
| Пользователь в случайном процентном соотношении | Slider (в консоли Firebase. REST API использует операторы <= , > и between ). | 0-100 | Используйте это поле, чтобы применить изменение к случайной выборке экземпляров приложений (с размером выборки не менее 0,0001%), используя виджет ползунка для сегментации случайно перемешанных пользователей (экземпляров приложений) в группы. Каждый экземпляр приложения постоянно сопоставляется со случайным целым или дробным числом в соответствии с начальным числом , определенным в этом проекте. Правило будет использовать ключ по умолчанию (отображается как Edit seed в консоли Firebase ), если вы не измените значение seed. Вы можете вернуть правило к использованию ключа по умолчанию, очистив поле Seed . Чтобы последовательно обращаться к тем же экземплярам приложений в заданных процентных диапазонах, используйте одно и то же начальное значение для всех условий. Или выберите новую случайно назначенную группу экземпляров приложений для заданного процентного диапазона, указав новое начальное значение. Например, чтобы создать два связанных условия, каждое из которых применяется к непересекающимся 5% пользователей приложения, вы можете настроить одно условие на соответствие проценту от 0% до 5%, а другое условие на соответствие диапазону от 5% до 10%. Чтобы разрешить некоторым пользователям случайным образом появляться в обеих группах, используйте разные начальные значения для правил в каждом условии. |
| Импортный сегмент | находится в | Выберите один или несколько импортированных сегментов. | Это правило требует настройки пользовательских импортированных сегментов . |
| Дата/Время | До, После | Указанная дата и время либо в часовом поясе устройства, либо в указанном часовом поясе, например «(GMT+11) Сиднейское время». | Сравнивает текущее время со временем выборки устройства. |
| Первый открытый | До, После | Указанная дата и время в указанном часовом поясе. | Сопоставляет пользователей, которые впервые открывают целевое приложение в указанный период времени. Требуются следующие SDK:
|
| Идентификатор установки | находится в | Укажите один или несколько идентификаторов установки (до 50) для выбора. | Это правило оценивается как true для данной установки, если идентификатор этой установки содержится в списке значений, разделенных запятыми.Чтобы узнать, как получить идентификаторы установки, см. раздел Получение идентификаторов клиентов . |
| Пользователь существует | (без оператора) | Охватывает всех пользователей всех приложений в текущем проекте. | Используйте это правило условия для сопоставления всех пользователей в проекте, независимо от приложения или платформы. |
| Пользовательский сигнал | Для строковых значений: содержит, не содержит, точно совпадает, содержит регулярное выражение Для числовых значений: =, ≠, >, ≥, <, ≤ Для значений версии: =, ≠, >, ≥, <, ≤ | Сравнения строк для этого правила чувствительны к регистру. При использовании оператора exact matches, contains, does not contain или contains regex можно выбрать несколько значений. При использовании оператора contains regex можно создавать регулярные выражения в формате RE2 . Ваше регулярное выражение может соответствовать всей целевой строке версии или ее части. Вы также можете использовать якоря ^ и $ для соответствия началу, концу или всей целевой строке. Для клиентских сред поддерживаются следующие типы данных:
Число, представляющее номер версии(ов), которой(ым) необходимо соответствовать (например, 2.1.0). | Дополнительную информацию о пользовательских условиях сигналов и условных выражениях см. в разделах Пользовательские условия сигналов и Элементы, используемые для создания условий . |
Параметры и условия поиска
Вы можете выполнить поиск ключей параметров, значений параметров и условий вашего проекта из консоли Firebase , используя поле поиска в верхней части вкладки «Параметры Remote Config .
Ограничения по параметрам и условиям
В проекте Firebase можно иметь до 2000 параметров и до 500 условий. Ключи параметров могут быть длиной до 256 символов, должны начинаться с подчеркивания или английской буквы (AZ, az) и могут также включать цифры. Общая длина строк значений параметров в проекте не может превышать 1 000 000 символов.
Просмотр изменений параметров и условий
Вы можете просмотреть последние изменения в шаблонах Remote Config из консоли Firebase . Для каждого отдельного параметра и условия вы можете:
Просмотр имени пользователя, который последним изменил параметр или условие.
Если изменение произошло в течение того же дня, просмотрите количество минут или часов, прошедших с момента публикации изменения в активном шаблоне Remote Config .
Если изменение произошло один или несколько дней назад, просмотрите дату публикации изменения в активном шаблоне Remote Config .
История изменений параметров
На странице «Параметры Remote Config в столбце «Последняя публикация» отображается последний пользователь, изменивший каждый параметр, и дата последней публикации изменения:
Чтобы просмотреть метаданные изменений для сгруппированных параметров, разверните группу параметров.
Чтобы отсортировать по дате публикации в порядке возрастания или убывания, щелкните заголовок столбца «Последняя публикация» .
История изменений для условий
На странице «Условия Remote Config вы можете увидеть последнего пользователя, который изменил условие, и дату его изменения рядом с полем «Последнее изменение» для каждого условия.
Следующие шаги
Чтобы настроить проект и приложение Firebase для использования Remote Config , см . раздел Начало работы с Firebase Remote Config .,Вы можете настроить шаблоны для случаев использования как клиента, так и сервера. Клиентские шаблоны обслуживаются любыми экземплярами приложений, которые реализуют клиентские SDK Firebase для Remote Config , включая приложения Android, Apple, Web, Unity, Flutter и C++. Параметры и значения Remote Config из шаблонов, специфичных для сервера, обслуживаются реализациями Remote Config (включая Cloud Run и Cloud Functions), которые используют следующие серверные среды:
- Firebase Admin Node.js SDK v12.1.0+
- Firebase Admin Python SDK v6.7.0+
При использовании консоли Firebase или API-интерфейсов Remote Config backend вы определяете один или несколько параметров (пар ключ-значение) и предоставляете значения по умолчанию в приложении для этих параметров. Вы можете переопределить значения по умолчанию в приложении, определив значения параметров. Ключи и значения параметров являются строками, но значения параметров могут быть преобразованы в другие типы данных, когда вы используете эти значения в своем приложении.
Используя консоль Firebase , Admin SDK или REST API Remote Config , вы можете создавать новые значения по умолчанию для своих параметров, а также условные значения, которые используются для целевых групп экземпляров приложений. Каждый раз, когда вы обновляете свою конфигурацию в консоли Firebase , Firebase создает и публикует новую версию вашего шаблона Remote Config . Предыдущая версия сохраняется, что позволяет вам извлекать или откатывать ее по мере необходимости. Эти операции доступны вам в консоли Firebase , Firebase Admin SDK и REST API и более подробно описаны в разделе Управление версиями шаблонов Remote Config .
В этом руководстве объясняются параметры, условия, правила, условные значения и то, как различные значения параметров приоритизируются на бэкэнде Remote Config и в вашем приложении. В нем также приводятся сведения о типах правил, используемых для создания условий.
Условия, правила и условные значения
Условие используется для нацеливания на группу экземпляров приложения. Условия состоят из одного или нескольких правил, которые должны все оцениваться как true , чтобы условие оценивалось как true для данного экземпляра приложения. Если значение правила не определено (например, когда нет доступных значений), это правило будет оцениваться как false .
Например, вы можете создать параметр, который определяет имя модели большой языковой модели (LLM) и строку версии, и обслуживать ответы от разных моделей на основе пользовательских правил сигнала . В этом варианте использования вы можете использовать стабильную версию модели в качестве значения по умолчанию для обслуживания большинства запросов и использовать пользовательский сигнал для использования экспериментальной модели для ответа на запросы тестовых клиентов.
Параметр может иметь несколько условных значений, которые используют разные условия, а параметры могут совместно использовать условия в рамках проекта. На вкладке Параметры консоли Firebase можно просмотреть процент выборки для условных значений каждого параметра. Эта метрика указывает процент запросов за последние 24 часа, которые получили каждое значение.
Приоритет значения параметра
Параметр может иметь несколько условных значений, связанных с ним. Следующие правила определяют, какое значение получено из шаблона Remote Config , а какое значение используется в данном экземпляре приложения в определенную момента времени:
Во -первых, условные значения применяются для любых условий, которые оцениваются в
trueдля данного запроса клиента. Если множественные условия оцениваются доtrue, первый (верхний), показанный в пользовательском интерфейсе консоли Firebase имеет приоритет, а условные значения, связанные с этим условием, предоставляются, когда приложение получает значения из бэкэнда. Вы можете изменить приоритет условий, перетаскивая и сбрасывая условия на вкладке «Условия» .Если нет условных значений с условиями, которые оценивают
true, значение по умолчанию Remote Config предоставляется, когда приложение получает значения из бэкэнда. Если параметр не существует в бэкэнде, или если значение по умолчанию установлено для использования в приложении , то для этого параметра не предусмотрено значение, когда приложение получает значения.
В вашем приложении значения параметров возвращаются методами get в соответствии со следующим списком приоритетов
- Если значение было извлечено из бэкэнда, а затем активировано, приложение использует полученное значение. Активированные значения параметров стойкие.
Если из бэкэнда не было извлечено никакое значение, или если значения, извлеченные из Remote Config , не были активированы, в приложении используется значение по умолчанию в приложении.
Для получения дополнительной информации о получении и настройке значений по умолчанию см. Загрузку Remote Config по умолчанию .
Если не было установлено значение по умолчанию в приложении, в приложении используется значение статического типа (например,
0дляintиfalseдляboolean).
В этом графике суммируется, как значения параметров приоритеты в бэкэнге Remote Config и в вашем приложении:
Значение параметра Типы данных
Remote Config позволяет выбрать тип данных для каждого параметра и проверяет все Remote Config по этому типу перед обновлением шаблона. Тип данных сохраняется и возвращается по запросу getRemoteConfig .
Поддерживаемые типы данных:
-
String -
Boolean -
Number -
JSON
В пользовательском интерфейсе Firebase Console тип данных может быть выбран из раскрывающегося списка рядом с клавиш параметров. В API REST типы могут быть установлены с использованием поля value_type в объекте параметра.
Группы параметров
Remote Config позволяет группировать параметры вместе для более организованного пользовательского интерфейса и повысить удобство использования.
Например, скажем, вам нужно включить или отключить три различных типа авторов при развертывании новой функции входа в систему. С помощью Remote Config вы можете создать три параметра, чтобы включить желаемые типы, а затем организовать их в группе с именем «Новый вход», без необходимости добавлять префиксы или специальную сортировку.
Вы можете создать группы параметров, используя консоль Firebase или API Remote Config REST. Каждая группа параметров, которую вы создаете, имеет уникальное имя в вашем Remote Config . При создании групп параметров имейте в виду:
- Параметры могут быть включены только в одну группу в любое время, а ключ параметров все еще должен быть уникальным для всех параметров.
- Имена групп параметров ограничены 256 символами.
- Если вы используете как API REST, так и консоль Firebase , убедитесь, что любая логика API REST обновляется для обработки групп параметров на публикации.
Создать или изменить группы параметров, используя консоли Firebase
Вы можете группировать параметры на вкладке «Параметры» консоли Firebase . Чтобы создать или изменить группу:
- Выберите группы управления .
- Выберите «Флакторы» для параметров, которые вы хотите добавить, и выберите «Переместить в группу» .
- Выберите существующую группу или создайте новую группу, введя имя и описание, и выбрав создать новую группу . После того, как вы сохраните группу, она будет опубликована, используя кнопку «Публикация изменений» .
Типы правил условия
Следующие типы правил поддерживаются в консоли Firebase . Эквивалентные функции доступны в API Remote Config REST, как подробно описано в справочнике условного выражения .
| Тип правила | Оператор (ы) | Ценности) | Примечание |
| Приложение | == | Выберите из списка идентификаторов приложений для приложений, связанных с вашим проектом Firebase. | Когда вы добавляете приложение в Firebase, вы вводите идентификатор пакета или имя пакета Android, которое определяет атрибут, который выявляется как идентификатор приложения в Remote Config . Используйте этот атрибут следующим образом:
|
| Версия приложения | Для строковых значений: точно совпадает, содержит, не содержит, Содержит регулярность Для числовых значений: <, <=, =,! =,>,> = | Укажите версию (ы) вашего приложения на цель. Перед использованием этого правила необходимо использовать правило идентификатора приложения для выбора приложения Android/Apple, связанного с вашим проектом Firebase. | Для платформ Apple: используйте приложение CFBundLeshortVersionString . ПРИМЕЧАНИЕ. Убедитесь, что ваше приложение Apple использует Firebase Apple Platforms SDK версию 6.24.0 или выше, так как CFBUndLeshortVersionString не отправляется в более ранних версиях (см. Примечания к выпуску ). Для Android: используйте имя версии приложения. Сравнения строк для этого правила чувствительны к случаям. При использовании точно совпадающих , содержит , не содержит или содержит оператор Regex , вы можете выбрать несколько значений. При использовании оператора Regex вы можете создавать регулярные выражения в формате RE2 . Ваше регулярное выражение может соответствовать всем или части строки целевой версии. Вы также можете использовать якоря ^ и $ , чтобы соответствовать началу, конец или целевой строке. |
| Построить номер | Для строковых значений: точно совпадает, содержит, не содержит, регулярное выражение Для числовых значений: =, ↓,>, ≥, <, ≤ | Укажите сборку (ы) вашего приложения на цель. Перед использованием этого правила вы должны использовать правило идентификатора приложения для выбора приложения Apple или Android, связанного с вашим проектом Firebase. | Этот оператор доступен только для приложений Apple и Android. Это соответствует CFBundleversion приложения для Apple и версий для Android. Сравнения строк для этого правила чувствительны к случаям. При использовании точно совпадающих , содержит , не содержит или содержит оператор Regex , вы можете выбрать несколько значений. При использовании оператора Regex вы можете создавать регулярные выражения в формате RE2 . Ваше регулярное выражение может соответствовать всем или части строки целевой версии. Вы также можете использовать якоря ^ и $ , чтобы соответствовать началу, конец или целевой строке. |
| Платформа | == | iOS андроид Веб | |
| Операционная система | == | Укажите операционную систему (ы) для цели. Перед использованием этого правила вы должны использовать правило идентификатора приложения для выбора веб -приложения, связанного с вашим проектом Firebase. | Это правило оценивается в true для данного экземпляра веб -приложения, если операционная система и ее версия соответствуют целевому значению в указанном списке. |
| Браузер | == | Укажите браузер (ы) для цели. Перед использованием этого правила вы должны использовать правило идентификатора приложения для выбора веб -приложения, связанного с вашим проектом Firebase. | Это правило оценивается в true для данного экземпляра веб -приложения, если браузер и его версия соответствуют целевому значению в указанном списке. |
| Категория устройства | это не | мобильный | Это правило оценивает, является ли устройство, доступное к вашему веб-приложению мобильным или не мобильным (настольный компьютер или консоль). Этот тип правила доступен только для веб -приложений. |
| Языки | находится в | Выберите один или несколько языков. | Это правило оценивается на true для данного экземпляра приложения, если этот экземпляр приложения установлен на устройстве, которое использует один из перечисленных языков. |
| Страна/регион | находится в | Выберите один или несколько регионов или стран. | Это правило оценивается в true для данного экземпляра приложения, если экземпляр находится в любом из перечисленных регионов или перечисленных стран. Код страны устройства определяется с использованием IP -адреса устройства в запросе или коде страны, определяемой Analytics Firebase (если данные аналитики передаются с Firebase). |
| Пользовательская аудитория (ы) | Включает хотя бы один | Выберите один или несколько из списка аудитории Google Analytics , которую вы настроили для своего проекта. | Это правило требует правила идентификатора приложения для выбора приложения, связанного с вашим проектом Firebase. ПРИМЕЧАНИЕ. Поскольку многие Analytics аудитории определяются событиями или свойствами пользователя, которые могут основываться на действиях пользователей приложений, потребуется некоторое время, чтобы пользователь в правиле аудитории вступит в силу для данного экземпляра приложения. |
| Пользовательское свойство | Для строковых значений: содержит, не содержит, точно совпадает, Содержит регулярность Для числовых значений: =, ↓,>, ≥, <, ≤ Примечание. На клиенте вы можете установить только строковые значения для свойств пользователя. Для условий, которые используют числовые операторы, Remote Config преобразует значение соответствующего свойства пользователя в целое число/float. | Выберите из списка доступных свойств пользователя Google Analytics . | Чтобы узнать, как вы можете использовать свойства пользователя для настройки вашего приложения для очень конкретных сегментов вашей пользовательской базы, см. Remote Config и свойства пользователя . Чтобы узнать больше о свойствах пользователя, см. Следующие руководства: При использовании точно совпадающих , содержится , не содержит и не содержит оператора Regex , вы можете выбрать несколько значений. При использовании оператора Regex вы можете создавать регулярные выражения в формате RE2 . Ваше регулярное выражение может соответствовать всем или части строки целевой версии. Вы также можете использовать якоря ^ и $ , чтобы соответствовать началу, конец или целевой строке. Примечание. Автоматически собранные свойства пользователя недоступны при создании Remote Config . |
| Пользователь в случайном проценте | Слайдер (в консоли Firebase. REST API использует <= , > и between операторами). | 0-100 | Используйте это поле, чтобы применить изменение к случайной выборке экземпляров приложений (с размерами выборки, такими же небольшими, как 0,0001%), используя виджет слайдера для сегментов случайно обезжиренных пользователей (экземпляры приложений) в группы. Каждый экземпляр приложения постоянно отображается со случайным целым или дробным числом, согласно семену, определенному в этом проекте. Правило будет использовать ключ по умолчанию (показанную как редактирование семян в консоли Firebase ), если вы не измените значение семян. Вы можете вернуть правило для использования клавиши по умолчанию, очистив поле начальных классов . Чтобы последовательно учитывать те же экземпляры приложений в пределах заданных процентных диапазонов, используйте одинаковое семенное значение в разных условиях. Или выберите новую случайно назначенную группу экземпляров приложений для данного процентного диапазона, указав новое семя. Например, для создания двух связанных условий, которые применяются к непересекающимся 5% пользователей приложения, вы можете настроить одно условие, чтобы соответствовать проценту от 0% до 5% и настроить другое условие, чтобы соответствовать диапазону от 5% до 10%. Чтобы позволить некоторым пользователям случайным образом появляться в обеих группах, используйте разные значения семян для правил в каждом условии. |
| Импортный сегмент | находится в | Выберите один или несколько импортированного сегмента. | Это правило требует настройки пользовательских импортных сегментов . |
| Дата/Время | Прежде, после | Указанная дата и время, либо в часовом поясе устройства, либо указанном часовом поясе, такой как «(GMT+11) Sydney Time». | Сравнивает текущее время с временем привлечения устройства. |
| Первый открытый | Прежде, после | Указанная дата и время, в указанном часовом поясе. | Соответствует пользователям, которые сначала открывают целевое приложение в пределах указанного временного диапазона. Требуется следующие SDK:
|
| Идентификатор установки | находится в | Укажите один или несколько идентификаторов установки (до 50) для цели. | Это правило оценивается в true для данной установки, если идентификатор этой установки находится в списке значений, разделенных запятыми.Чтобы узнать, как вы можете получить идентификаторы установки, см. Идентификаторы извлечения клиентов . |
| Пользователь существует | (без оператора) | Нацеливается на всех пользователей всех приложений в текущем проекте. | Используйте это правило условия, чтобы соответствовать всем пользователям в рамках проекта, независимо от приложения или платформы. |
| Пользовательский сигнал | Для строковых значений: содержит, не содержит, точно совпадает, Содержит регулярность Для числовых значений: =, ↓,>, ≥, <, ≤ Для значений версий: =, ↓,>, ≥, <, ≤ | Сравнения строк для этого правила чувствительны к случаям. При использовании точно совпадающих, содержит, не содержит или содержит оператор Regex, вы можете выбрать несколько значений. При использовании оператора Regex вы можете создавать регулярные выражения в формате RE2 . Ваше регулярное выражение может соответствовать всем или части строки целевой версии. Вы также можете использовать якоря ^ и $, чтобы соответствовать началу, конец или целевой строке. Для клиентских средств поддерживается следующие типы данных:
Цифра, которое представляет номер версии (ы), чтобы соответствовать (например, 2.1.0). | Для получения дополнительной информации об пользовательских условиях сигналов и условных выражениях для использования см. Пользовательские условия сигнала и элементы, используемые для создания условий . |
Параметры и условия поиска
Вы можете найти клавиши параметров вашего проекта, значения параметров и условия из консоли Firebase , используя поле поиска в верхней части вкладки «Параметры Remote Config .
Ограничения на параметры и условия
В рамках проекта Firebase вы можете иметь до 2000 параметров и до 500 условий. Ключи для параметров могут длиться до 256 символов, должны начинаться с подчеркивания или английского буквенного символа (AZ, AZ), а также могут включать числа. Общая длина строк значения параметра в рамках проекта не может превышать 1 000 000 символов.
Просмотреть изменения в параметрах и условиях
Вы можете просмотреть последние изменения в ваших Remote Config из консоли Firebase . Для каждого отдельного параметра и условия вы можете:
Посмотрите имя пользователя, который в последний раз изменил параметр или условие.
Если изменение произошло в тот же день, просмотрите количество минут или часов, которые прошли, поскольку изменение было опубликовано в активный Remote Config .
Если изменение произошло один или несколько дней в прошлом, просмотрите дату, когда изменение было опубликовано в активный шаблон Remote Config .
История изменений для параметров
На странице удаленных параметров Remote Config в последнем опубликованном столбце показан последний пользователь, который изменил каждый параметр и последнюю дату публикации для изменения:
Чтобы просмотреть метаданные изменения для сгруппированных параметров, разверните группу параметров.
Чтобы сортировать в порядок восхождения или убывания, опубликовать дату, нажмите на последнюю опубликованную метку столбца.
Изменить историю для условий
На странице Удаленных Условий Remote Config вы можете увидеть последнего пользователя, который изменил условие и дату, которые они изменили его рядом с последним изменением в каждом условии.