Справка FLOWZ
Как собрать UX-тест, отправить его респондентам и разобраться в результатах.
Как начать
- Войдите по email и создайте проект.
- Добавьте в проект исследование и выберите тип.
- Соберите шаги в редакторе и проверьте тест в предпросмотре.
- Запустите тест и отправьте ссылку респондентам.
- Смотрите ответы на вкладке «Статистика».
Типы шагов
Тест собирается из шагов. Каждый шаг решает свою задачу.
Легенда и согласие
Текстовый экран: вступление, легенда или согласие на участие.
- Когда использовать
- В начале теста, чтобы объяснить задачу, или перед сменой темы.
- Что видит респондент
- Текст и кнопку перехода. Для согласия ещё и галочку.
- Что покажут результаты
- Количество прочтений.
Клик-тест
Респондент кликает по изображению туда, где ожидает найти нужное.
- Когда использовать
- Проверить, находят ли люди элемент на макете или странице.
- Что видит респондент
- Задание, затем изображение на весь экран.
- Что покажут результаты
- Долю попаданий в цель, клики по зонам, точки и тепловую карту.
Сравнение картинок
Респондент видит две картинки рядом и выбирает лучшую.
- Когда использовать
- Сравнить два варианта баннера, обложки, упаковки или экрана, когда нужен прямой выбор.
- Что видит респондент
- Вопрос и две картинки рядом. Порядок слева направо у разных респондентов случайный.
- Что покажут результаты
- Сколько человек выбрало каждую картинку, вывод о значимости разницы и поправку на позицию.
Сортировка карточек
Респондент раскладывает карточки по группам.
- Когда использовать
- Понять, как люди группируют понятия, и спроектировать навигацию.
- Что видит респондент
- Карточки и группы, готовые или созданные самим респондентом.
- Что покажут результаты
- Куда чаще всего относят карточки и какие названия групп дают.
Тестирование дерева
Респондент ищет раздел в текстовой структуре меню.
- Когда использовать
- Проверить структуру навигации до дизайна.
- Что видит респондент
- Задание и меню, которое раскрывается по уровням.
- Что покажут результаты
- Долю успеха и популярные пути.
Выбор варианта
Вопрос с одним или несколькими вариантами ответа.
- Когда использовать
- Узнать предпочтения, причины или разделить аудиторию.
- Что видит респондент
- Вопрос и список вариантов.
- Что покажут результаты
- Проценты и количество ответов по каждому варианту.
Матрица
Несколько критериев оцениваются по одной шкале.
- Когда использовать
- Сравнить разделы или свойства продукта по одним и тем же оценкам.
- Что видит респондент
- Таблицу: критерии в строках, оценки в столбцах.
- Что покажут результаты
- Тепловую таблицу с долей ответов в каждой строке.
Шкала
Оценка числом, звёздами или эмодзи.
- Когда использовать
- Измерить удобство или удовлетворённость. Шкала 0–10 показывает NPS.
- Что видит респондент
- Вопрос и шкалу с подписями по краям.
- Что покажут результаты
- Среднюю оценку, медиану и распределение. Для шкалы 0–10 ещё и NPS.
Ранжирование
Респондент расставляет варианты по порядку.
- Когда использовать
- Понять приоритеты, когда важны не все варианты сразу.
- Что видит респондент
- Список, который можно перетаскивать.
- Что покажут результаты
- Порядок по среднему месту и как часто вариант ставили первым.
Поле ввода
Свободный ответ: текст, email, число, дата или телефон.
- Когда использовать
- Собрать открытые комментарии или уточнить детали.
- Что видит респондент
- Вопрос и поле для ответа.
- Что покажут результаты
- Список ответов.
Задание с прототипом
Шаг теста с записью экрана: респондент выполняет задание на прототипе.
- Когда использовать
- Посмотреть выполнение задачи на живом прототипе. Направление пока отложено.
- Что видит респондент
- Задание и прототип в отдельной вкладке.
- Что покажут результаты
- Запись экрана.
Ссылка для респондентов
После запуска у теста появляется ссылка. Респонденту не нужны регистрация и установка: он открывает ссылку и проходит тест. Клик-тесты рассчитаны на компьютер: на телефоне респондент увидит просьбу открыть ссылку на компьютере.
Email респондента в новых тестах не собирается. Эту настройку можно включить в настройках теста.
Работа с панелями
Панель респондентов добавляет свой идентификатор в ссылку через параметр rid. Он сохраняется в результате и попадает в выгрузку Excel.
В настройках теста укажите адреса возврата для завершения и отсева. Метка {rid} заменится идентификатором респондента.
https://flowz.su/test/ID_ТЕСТА?rid=12345
https://panel.example/done?rid={rid}Результаты
На вкладке «Статистика» показаны просмотры, завершения, время и графики по каждому шагу. Клик по ответу фильтрует респондентов. Все данные можно выгрузить в Excel.
ИИ-агенты
ИИ-агент может собрать исследование по вашей гипотезе: создать черновик, проверить его и запустить. Для этого в разделе «Подключение AI (MCP)» создайте ключ и передайте его агенту. Агент работает только в ваших проектах, а его действия записываются в журнал. Подключение по MCP работает по адресу /api/mcp с тем же ключом, а клиенты с входом через браузер (OAuth) подключаются, указав только этот адрес: FLOWZ откроет страницу, где вы выберете права.
Права ключа:
- Чтение проектов и результатов
- Создание черновиков исследований
- Запуск исследований
Адреса API. Ключ передаётся в заголовке Authorization: Bearer ключ.
| POST /api/mcp | MCP-сервер (JSON-RPC по HTTP): инструменты get_catalog, list_projects, upload_image, create_study_draft, get_study, launch_study, get_results. Права проверяются по ключу в каждом инструменте. |
| GET /.well-known/oauth-authorization-server | Вход через OAuth для MCP-клиентов: метаданные, регистрация клиента (/api/oauth/register), экран согласия (/oauth/authorize) и выдача токена (/api/oauth/token). Токен — обычный ключ на 90 дней, виден и отзывается в разделе подключения. |
| GET /api/v1/catalog | Типы шагов, их поля, правила и примеры. Ключ не нужен. |
| GET /api/v1/projects | Проекты, к которым у ключа есть доступ, и роль в каждом. |
| POST /api/v1/images | Загрузить картинку (multipart, поле file, или JSON с contentType и dataBase64) и получить imageUrl для шага. До 10 МБ, не больше 40 в час на ключ. |
| POST /api/v1/studies | Создать черновик исследования с шагами. Для клик-теста обязательно поле deviceType (desktop, tablet или phone): спросите у человека, для какого устройства интерфейс. Поле language (ru или en) задаёт язык кнопок и подсказок респондента: для англоязычной аудитории ставьте en. Запускает черновик только отдельный запрос. |
| GET /api/v1/studies/{id} | Состояние исследования и список проблем, которые мешают запуску. |
| GET /api/v1/studies/{id}/results | Сводка результатов: проценты по вариантам, шкалы, попадания в клик-тестах, A/B с выводом. Без имён, email, телефонов и геоданных. Свободные ответы передаются как есть. |
| POST /api/v1/studies/{id}/launch | Запустить готовое исследование и получить ссылку для респондентов. |
Какие данные получает агент. В сводке результатов нет имён, email, телефонов, IP-адресов и геоданных респондентов, а ответы на шаги «Email» и «Телефон» не передаются совсем. Остальные ответы агент видит в обобщённом виде: проценты по вариантам, шкалы, доли попаданий в клик-тестах, итоги A/B. Исключение составляют свободные ответы: до 30 штук они передаются как есть, и респондент мог написать в них что угодно, в том числе личное. Если исследование касается чувствительных тем, не давайте ключу право на чтение.
Не больше 60 запросов в минуту на ключ. Полное описание шагов и полей агент получает по адресу /api/v1/catalog.