Skip to main content

Работа с условиями в Remote Config

Для чего нужны условия?

  • Условия определяют, как именно обновится приложение.

Например, «версия Android старше 11-й версии и русский язык на устройстве». Условие можно назвать «таргетингом» или «сегментом». Само по себе создание условия ни на что не влияет, его нужно применить к раскатываемому параметру.

  • Условия нужны, чтобы применять параметры на определённый сегмент пользователей. Весь список находится в разделе Conditions. Условия также видны в выпадающем списке при настройке параметра.
caution

Не редактируйте условия без необходимости и уверенности, что это не повлияет на пользователей. Особенно, если на условия раздаются параметры. Это может помешать стабильной работе приложения.

Создание нового условия​

  1. Откройте Remote Config.

  2. Выберите Условия в меню слева.

img
  1. Нажмите Добавить условие.
img
  1. Заполните необходимые поля.
  • В поле Название укажите название события.
  • В поле Описание укажите поясняющий комментарий.
  • Выберите Атомарные условия. Что такое атомарное условие?
  1. Нажмите Создать.
note

При создании, изменении или удалении условия оно переходит в статус Pending, то есть переходит в режим ожидания подтверждения.

Атомарные условия​

Атомарные условия могут быть текстовыми и числовыми. Текстовое поле заполняется без кавычек.

Для текстовых доступны следующие операторы:

  • Exactly matches. Требует точного соответствия.

Пример. Условию OS Version exactly matches 9.0.0 будет соответствовать запрос от приложения с os-version=9.0.0, но не с os-version=9.0.

  • Contains — содержит подстроку.
  • Does not contain — не содержит подстроку элементов.
  • Regexp — соответствует регулярному выражению.
caution

При использовании регулярных выражений для Golang нужно проверять работу условия по ссылке и при тестировании.

  • Presented in file — соответствует элементам из списка в файле, максимальный размер файла: 5 Мбайт.
  • Not presented in file — под условие попадают все пользователи, которые не указаны в загруженном файле.

Для числовых доступны следующие операторы:

  • =;
  • != (не равно);
  • >;
  • >=;
  • <;
  • <=.
info

Все атомарные условия объединяются по логическому «И». Чтобы пользователь попал в созданное условие, он должен попасть под действие всех атомарных условий.

img

При создании условия рядом с названием появляется индикатор New. Такое условие можно удалять без подтверждения, так как оно является черновиком.

Список атомарных условий​

Atomic ConditionОписаниеТипПримеры использования и комментарии

OS Version

Версия ОС

Текстовый + Числовой

Версия OS ≤ 9.9

OS Version matches regex

"^[1-8](.d+)*$|^9(.d(.d+)*)*$"

Device Model

Модель устройства

Текстовый

Устройства Samsung:
Device Model Contains samsung

Language

Язык на устройстве

Текстовый

Русский язык на устройстве
Language matches regex ^ru

Account

Аккаунт,

Текстовый

Account exactly matches mrg.test@mail.ru
В данном случае, если хотя бы одна из подключенных учётных записей является mrg.test@mail.ru, то условие выполнится.

App Version

Версия приложения

Текстовый

App Version exactly matches 1.5.3

App Environment

Альфа, Бета или Релизная версия

Возможные значения: Alpha, Beta, Release.

Значение данного поля задается при инициализации SDK RuStore Remote Config.

App Build Id

Номер сборки приложения

Числовой

Пользователи на сборках не младше 22563
App Build Id >= 22563

DeviceID Percentile

Персентиль от DeviceId

Числовой

Используется для публикации параметров на % пользователей.
Персентиль — число от 0.00 до 99.99.
Число определяется функцией от значения device-id. Каждому device-id RuStore Remote Config вернёт какое-то число.
Есть дополнительное поле: Salt — его нужно использовать, когда необходимо применить параметр на разные не пересекающиеся группы пользователей.

Account Percentile

То же, но от учётной записи

Числовой

DeviceID Interval Percentile

Вычисляется по DeviceID

Числовой

Позволяет публиковать фичу интервалами.
Пример. Вы взяли 10% пользователей, указали Salt и интервал в 7 дней. Пользователи, которые увидят обновления, распределятся по всему интервалу: 1/7 пользователей из выбранных 10% будет получать конфиг каждый 7-й день.

Account Interval Percentile

Вычисляется по Account

Числовой

Аналогично DeviceID Interval Percentile.

Random Percent

Каждый раз новый процент

Show Time

Время отдачи конфига

Указывается начало и/или конец отдачи и часовой пояс. Использовать, например, если нужно в пятницу настроить запуск чего-то на понедельник, или отключить какую-то фичу в определенный день.

Подтверждение создания условий​

Если условие создает не владелец приложения или пользователь с правами на подтверждение, то понадобится подтверждение от пользователя с такими правами или владельца приложения. Роли пользователей.

  1. Откройте Remote Config.

  2. Выберите Условия в меню слева.

  3. Выберите условие и нажмите Подтвердить.

Изменение условия​

img

Вы можете сравнить старое условие с новым, а также отменить изменения, удалив черновик. Любые параметры будут работать с исходной версией, а не черновиком. При подтверждении все изменения вступают в силу, и пользователь будет получать все связанные параметры уже по новому условию.

Удаление условия​

  1. Откройте Remote Config.

  2. Выберите Условия в меню слева.

  3. Выберите условие и нажмите Удалить.

img

При удалении условия рядом с названием появляется индикатор Will be deleted. Подтвердите операцию, если хотите полностью удалить условие из системы.

Отклонение изменений​

Вы можете отклонить изменения и скорректировать условие, если допустили ошибку.

  1. Откройте Remote Config.

  2. Выберите Условия в меню слева.

  3. Выберите условие и нажмите Отклонить.

img