Перейти к содержанию

Feature flags

Feature flag (флаг функции) — это переключатель «вкл/выкл» для функции в вашем приложении или на сайте. Вы переключаете его в Control Panel, без нового релиза.

Для каждого флага вы выбираете, кто получит функцию: пользователи сегмента, процент всех пользователей или и то, и другое. Например, сначала покажите новый экран 10% пользователей, а затем увеличьте процент. Если что-то пойдёт не так, вы можете отключить функцию для всех кнопкой Выключить для всех. Флаг также может передавать свойства, например цвет кнопки или лимит скидки, которые вы задаёте для каждой аудитории.

Перед началом

Anchor link to
  • Лимит: в каждом приложении может быть один неархивный флаг. Чтобы одновременно использовать больше флагов, свяжитесь с вашим аккаунт-менеджером.

  • Доступ: Фича-флаги отображается в каждом приложении, которое вам доступно. Чтобы создавать и изменять флаги, нужно разрешение Изменение приложений или такое же разрешение для этого приложения в его разрешениях для конкретного приложения.

  • Настройка разработчиками: флаг влияет на пользователей только после того, как ваши разработчики прочитают его в коде приложения или сайта по ключу. Передайте им:

    • Ключ флага.
    • Пример кода. В приложении, где ещё нет флагов, страница Фича-флаги показывает готовые примеры кода для Web, Android и iOS.
    • Руководство по SDK: Web SDK, Android SDK или iOS SDK.

    Вашему приложению или сайту нужен Web SDK 3.94.1 или новее, Android SDK 6.16.0 или новее либо iOS SDK 7.2.10 или новее.

Как флаг решает, что получит каждый пользователь

Anchor link to

У каждого флага есть список правил. Каждое правило содержит сегмент, процент пользователей, для которых флаг включён (Раскатка, %), и необязательные значения свойств. Для каждого устройства Pushwoosh проверяет правила сверху вниз:

  1. Решает первое правило, сегменту которого соответствует устройство. Правило без сегмента подходит любому устройству.
  2. Значение Раскатка, % правила определяет, включится ли флаг для этого пользователя. При 20% флаг получают двое пользователей из десяти.
  3. Пользователь, для которого флаг включён, получает значения свойств, заданные в этом правиле. Пользователь, для которого флаг выключен, получает значения свойств по умолчанию.

Как только устройство подошло под правило, следующие правила пропускаются, даже если это правило выключает для него флаг. Устройство, не подошедшее ни под одно правило, получает флаг выключенным.

  • Пользователь получает один и тот же результат при каждом посещении.
  • Pushwoosh определяет пользователя по User ID, а если User ID не задан — по ID устройства. Устройства, на которых выполнен вход с одним и тем же User ID, получают одинаковый результат, если подходят под одно и то же правило, потому что Pushwoosh проверяет сегменты для каждого устройства.
  • Когда вы увеличиваете процент, пользователи, у которых флаг уже включён, сохраняют его, а к ним добавляются новые.

Создание флага

Anchor link to
  1. Перейдите в Аудитория → Фича-флаги.

  2. Нажмите Создать фича-флаг.

    Страница feature flags приложения с выделенной кнопкой Create feature flag и блоком SDK support, в котором перечислены Web, Android и iOS
  3. Введите Ключ, например new_checkout. Ключ — любое выбранное вами имя, но разработчики читают флаг в коде именно по этому ключу с учётом регистра. Согласуйте его с ними до сохранения флага.

  4. Введите Название и, при желании, Описание, чтобы команда понимала, чем управляет флаг.

Ключ подчиняется следующим правилам:

  • Латинские буквы, цифры, _, . и -, до 58 символов.
  • Изменить ключ позже нельзя.
  • Нельзя повторно использовать ключ, который уже есть у другого флага приложения, даже архивного, или ключ, отличающийся от него только регистром, например New_Checkout и new_checkout.

Добавление свойств

Anchor link to

Свойства — это значения, которые приложение или сайт читает из флага, например текст баннера или количество товаров в блоке рекомендаций. Пропустите этот шаг, если флаг только включает и выключает функцию.

  1. В разделе Свойства нажмите Добавить свойство.
  2. Введите Ключ свойства, например button_color. Используйте латинские буквы, цифры и _, до 64 символов. Ключ свойства — любое выбранное вами имя, но разработчики читают значение в коде именно по этому ключу с учётом регистра. Согласуйте его с ними до сохранения флага.
  3. Выберите тип: Строка, Число, Логический или JSON. После сохранения флага изменить тип нельзя.
  4. Введите Значение по умолчанию. Это значение получают пользователи, для которых флаг выключен.

У флага может быть до 50 свойств.

Форма feature flag с ключом, названием, описанием и двумя свойствами: button_color типа String и show_apple_pay типа Boolean

Добавление правил

Anchor link to
  1. В разделе Правила нажмите Добавить правило.
  2. Введите Название правила, например Paying customers.
  3. В поле Сегмент выберите, к кому применяется правило. Оставьте поле пустым, чтобы применить правило ко всем пользователям.
  4. В поле Раскатка, % введите процент сегмента, для которого флаг включается, от 0 до 100, до двух знаков после запятой.
  5. В блоке Значения для пользователей, которым правило включает флаг измените свойства, которые для этих пользователей должны отличаться от значений по умолчанию. Свойства, которые вы не меняете, сохраняют значения по умолчанию.
  6. Чтобы добавить ещё одну аудиторию, повторите шаги 1–5.
  7. Добавив правила, меняйте их порядок кнопками Выше и Ниже, потому что решает первое подходящее правило.

У флага может быть до 10 правил.

Под полем Раскатка, % каждое правило показывает, примерно скольким устройствам оно включает флаг, например ≈ 1 200 устройств. Pushwoosh рассчитывает это так:

  • Умножает размер сегмента правила на процент. Например, сегмент из 1 500 устройств при 80% даёт ≈ 1 200 устройств.
  • Для правила без сегмента берёт все устройства приложения.

Считайте это число максимумом, которого может достичь правило: устройство, подошедшее под одно из предыдущих правил, на нём и останавливается.

Rule 1 у feature flag: Paying customers для сегмента Purchased something на 100%, button_color — green, show_apple_pay — true

Например, чтобы дать новый процесс оформления заказа всем платящим клиентам и 20% остальных пользователей, создайте два правила:

ПравилоСегментРаскатка, %Значения для пользователей, которым правило включает флаг
Paying customersPurchased something100button_color = green, show_apple_pay = true
Everyone else—20button_color = orange

Сохранение флага

Anchor link to

Нажмите Сохранить. Флаг создаётся в статусе Активен, и устройства получают его при следующей проверке флагов.

Управление флагами

Anchor link to

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

Чтобы узнать, сколько устройств пока не могут получать флаги, посмотрите на блок Поддержка в SDK в верхней части списка и каждого флага. Он показывает долю устройств приложения со старой версией SDK, если эти устройства передают версию SDK. Такие устройства не получают флаги, пока пользователи не обновят приложение.

У флага один из трёх статусов:

СтатусЧто получают пользователиДействия
АктивенФлаг работает по своим правилам.Перемешать, Выключить для всех, В архив
ВыключенФлаг выключен для всех пользователей, со значениями свойств по умолчанию. Правила и свойства сохраняются.Включить обратно, В архив
В архивеУстройства больше не получают флаг, поэтому код использует значения, которые в нём задали разработчики.Восстановить

Изменение флага

Anchor link to

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

  1. Откройте флаг.
  2. Измените название, описание, свойства или правила.
  3. Нажмите Сохранить.
  4. Если вы изменили правила или значения свойств по умолчанию, диалог Проверьте изменения покажет, что произойдёт с устройствами. Проверьте его и нажмите Сохранить.

Перед тем как нажать Сохранить, проверьте каждую строку диалога. На каждое изменение приходится одна строка:

  • Раскатка правила: примерно сколько устройств дополнительно получат флаг или сколько его потеряют.
  • Значения правила: примерно сколько устройств получат новые значения, а также старое и новое значение каждого свойства.
  • Новое или удалённое правило, другой сегмент или новый порядок правил: куда перейдут устройства. Например, устройства удалённого правила переходят к следующему подходящему им правилу.
  • Значения по умолчанию: старые и новые значения, которые получают устройства с выключенным флагом.

Изменение только названия или описания сохраняется без диалога.

Чтобы выкатывать функцию постепенно, поэтапно увеличивайте значение Раскатка, % правила.

Если кто-то другой сохранил флаг, пока вы его редактировали, Control Panel не перезаписывает чужие изменения и просит перезагрузить флаг. Нажмите Обновить и внесите изменения заново.

Отключение флага для всех

Anchor link to

Используйте Выключить для всех, когда функция вызывает проблемы и её нужно остановить для всех:

  1. Откройте флаг и нажмите Выключить для всех.

    Верхняя часть страницы активного feature flag с кнопками Reshuffle, Kill switch и Archive
  2. Подтвердите действие. Каждое устройство получит флаг выключенным со значениями свойств по умолчанию при следующей проверке флагов.

Пока сайт или приложение открыты, устройства получают изменение в течение часа. См., как проверяют флаги Web SDK, Android SDK и iOS SDK.

Чтобы снова включить флаг с прежними правилами, нажмите Включить обратно.

Выбор другой выборки пользователей

Anchor link to

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

  1. Откройте активный флаг и нажмите Перемешать.
  2. Подтвердите действие. Часть пользователей, у которых флаг был включён, потеряют его, а другие получат при следующей проверке флагов их устройствами, при этом проценты останутся прежними.

Архивирование и восстановление флага

Anchor link to

Архивируйте флаг, когда функция полностью выпущена или удалена из кода. Архивный флаг не учитывается в лимите флагов на приложение, а его ключ остаётся зарезервированным.

  1. Откройте флаг и нажмите В архив.
  2. Подтвердите действие.

Архивный флаг нельзя редактировать. Чтобы вернуть его:

  1. В списке включите Показать архивные.
  2. Откройте флаг и нажмите Восстановить. Флаг возвращается в статусе Выключен, поэтому сам по себе до пользователей не доходит.
  3. Когда будете готовы, нажмите Включить обратно.

Кто изменил флаг

Anchor link to

История изменений показывает каждую сохранённую версию флага: что изменилось, кто это изменил и когда. Историю видит любой, кто может открыть флаг.

История записывается для изменений начиная с 13 октября 2026 года. Флаг без записанных изменений показывает Изменений пока нет. У флага, созданного до этой даты, самая старая запись не содержит списка изменений, потому что сравнивать её не с чем — более ранней версии нет.

  1. Откройте флаг.
  2. Нажмите История.

Панель История изменений показывает версии флага, начиная с новых. В каждой записи указаны:

  • Действие, например Изменён.
  • Кто внёс изменение: email пользователя или API-токен, через который пришло изменение, например API-токен «Release pipeline», или API-токен для токена без названия.
  • Дата и время.
  • Номер версии, например v4.
Панель истории изменений feature flag, сначала новые: действие, email пользователя или API-токен, дата и время, версия

Чтобы загрузить более ранние записи, нажмите Показать ещё.

ДействиеЧто произошло
СозданФлаг создан.
ИзменёнКто-то сохранил изменения флага.
Изменён процентРаскатка одного правила изменена через API или MCP-сервер. В Control Panel изменение раскатки сохраняется как Изменён.
Выключен (kill)Кто-то нажал Выключить для всех.
Снова включёнКто-то нажал Включить обратно.
В архивеФлаг перенесён в архив.
ВосстановленФлаг восстановлен из архива.
Пользователи перемешаныКто-то нажал Перемешать.

Под каждой записью панель показывает, что изменилось, в виде значений до и после. Она может показывать такие изменения:

  • Название
  • Описание
  • Статус
  • Свойства
  • Порядок правил
  • Каждое добавленное, удалённое или изменённое правило

Для изменённого правила панель показывает только отличающиеся поля: название, Сегмент, Раскатка или Значения. Правило без сегмента показывается как Все пользователи.

Сегментация пользователей по флагу

Anchor link to

Условие по feature flag в сегменте находит устройства, которые получили флаг включённым или выключенным, подошли под одно из его правил или дошли до той части приложения, которой управляет флаг. Используйте его, чтобы отправить сообщение пользователям, которые видят новую функцию, например попросить отзыв, или чтобы построить вокруг них Journey.

  1. Откройте конструктор сегментов, как описано в разделе Как создавать сегменты.
  2. Нажмите Фиче-флаг в списке условий.
  3. В поле Выберите фиче-флаг… выберите флаг. Архивных флагов в списке нет.
  4. Выберите состояние:
    • включён: устройства, которые получили флаг включённым.
    • выключен: устройства, которые получили флаг выключенным.
    • в правиле: устройства, которые подошли под сегмент правила, независимо от того, включило ли им флаг значение Раскатка, % этого правила. Выберите правило в поле Выберите правило….
    • видел фичу (30 дней): устройства, которые отправили хотя бы один показ флага за последние 30 дней, то есть приложение вызвало logImpression для ключа этого флага. См. Как найти пользователей, которые дошли до функции.

В сегментах High Speed Delivery, которые могут содержать только условия по тегам, условие Фиче-флаг использовать нельзя.

Какие устройства попадают в каждое состояние

Anchor link to

Состояние устройства определяется флагами, которые оно получило последними, и текущим статусом флага:

  • Устройство, которое ни разу не запрашивало флаг, например потому что его SDK не читает флаги, не попадает ни в одно из состояний.
  • После изменения правил или значения Раскатка, % правила устройство переходит в другое состояние только тогда, когда снова запросит флаги.
  • Когда вы выключаете флаг для всех или архивируете его, включён и в правиле становятся пустыми примерно за 10 секунд, не дожидаясь, пока устройства снова запросят флаги. выключен после этого содержит все устройства, которые когда-либо получали флаг.

Как найти пользователей, которые дошли до функции

Anchor link to

Чтобы найти пользователей, которые видели включённую функцию, например чтобы попросить у них отзыв, объедините два условия в одном сегменте:

  1. Добавьте видел фичу (30 дней) для флага.
  2. Добавьте включён для того же флага и объедините два условия через И. Пользователь должен соответствовать обоим.

Эти два условия находят разных пользователей:

  • видел фичу (30 дней): пользователи, которые дошли до экрана или кода, которым управляет флаг, независимо от того, был ли флаг для них включён или выключен.
  • включён: пользователи, которые получили флаг включённым. Поэтому его и нужно добавить: так остаются только пользователи, получившие новую версию.

Результат близкий, но не точный. включён отражает флаг, который устройство получило последним, а показ на этом устройстве мог прийти из более раннего посещения, когда флаг был выключен.

Сегмент остаётся пустым, если приложение не логирует показы. Как их логировать, см. в разделе Log impressions руководства по Web SDK, Android SDK или iOS SDK.

Выключение флага для всех или архивирование не очищает это состояние. Устройство выходит из него через 30 дней после последнего показа.

Сегменты по флагам в Journey

Anchor link to

Сегмент с условием по feature flag работает во Входе на основе аудитории и в Разделении по условию. Например, разделите пользователей, которые получили новый процесс оформления заказа, и тех, кто его не получил, и отправьте каждой группе своё сообщение.

Ограничения

Anchor link to

Control Panel и API применяют эти ограничения при сохранении флага:

ОграничениеЗначение
Правил на флаг10
Свойств на флаг50
Размер свойств одного флага (ключи, типы и значения по умолчанию)10 000 байт
Глубина вложенности значения JSON5 уровней
Флагов на приложение1, больше — по запросу к вашему аккаунт-менеджеру. Архивные флаги не учитываются.
Данные, которые одно устройство получает по всем флагам приложения64 КБ

Управление флагами через API

Anchor link to

Разработчики могут создавать и изменять флаги из своих систем с помощью Feature Flags API, а AI-ассистенты, подключённые через MCP-сервер Pushwoosh, могут управлять флагами теми же операциями.