# Поисковые запросы

Модуль `search_analytics` дополняет штатный модуль `search` аналитикой спроса.
Он показывает, что посетители искали, какие фразы давали пустую выдачу и какие
темы требуют нового контента или расширения ассортимента.

## Сбор данных

После формирования выдачи `search` вызывает hook `search.results.resolved`.
Модуль записывает нормализованную фразу, область поиска и число найденных
результатов. IP, сессия и персональные данные посетителя не сохраняются.

Для каждой пары «фраза + область» ведутся:

- общее число поисков;
- число поисков без результатов;
- последнее известное число результатов;
- первый и последний поиск;
- дневная статистика для фильтрации по периоду.

Если ранее пустой запрос начал возвращать результаты, он автоматически получает
состояние «Решено».

## Работа с нулевой выдачей

В разделе **Модули -> Поисковые запросы** можно отфильтровать только пустые
запросы, выбрать область поиска и период. Для каждой фразы доступны состояния:

- **Разобрать** - требуется решение;
- **Решено** - контент или товар уже добавлен;
- **Игнорировать** - фраза не относится к сайту.

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

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

## Зависимость и права

Модуль требует установленный и включённый `search`.

- `view_search_analytics` - просмотр отчёта;
- `manage_search_analytics` - статусы, заметки, настройки и очистка истории.

При деинсталляции обе таблицы аналитики и настройки удаляются.