API аналитики поиска обновлён: фильтрация и отчётность стали гибче. Раньше разработчикам приходилось выгружать сырые события и агрегировать их на своей стороне, теперь большинство срезов доступно прямо в запросе. Новые возможности позволяют точнее находить проблемы поиска, быстрее проверять гипотезы и строить отчёты без дополнительного ETL-слоя. Ниже — что именно изменилось и как этим пользоваться.
Новые операторы фильтрации
Фильтры перестали быть набором фиксированных параметров. Теперь условия комбинируются, вкладываются друг в друга и применяются к любому измерению отчёта — от типа устройства до конкретного идентификатора запроса. Логика условий задаётся в теле запроса, а не в URL, поэтому сложные выборки не упираются в длину строки.
- Диапазоны и относительные периоды. Поддерживаются интервалы по дате и времени, а также относительные окна вида «последние 7 дней» с привязкой к часовому поясу проекта.
- Вложенные условия AND / OR / NOT. Можно строить деревья условий произвольной глубины: например, показы с нулевым результатом ИЛИ клики с позиции ниже пятой, исключая ботов.
- Фильтры по метаданным. Доступны произвольные пары «ключ — значение» из пользовательских атрибутов событий: эксперимент, тариф, версия приложения.
- Текстовые фильтры по запросам. Поиск по подстроке, точному совпадению и регулярному выражению, с опцией нормализации регистра и опечаток.
- Сегменты пользователей. Новые, вернувшиеся, подписчики, участники A/B-теста — сегмент задаётся один раз и переиспользуется во всех отчётах.
Расширенная отчётность: метрики и измерения
Отчётность получила набор метрик, которых раньше не хватало для диагностики качества поиска. Появились измерения по позиции клика, времени до первого клика и доле запросов без результата. Все метрики считаются на стороне API и возвращаются уже агрегированными.
- Нулевые результаты. Доля запросов без выдачи, разбитая по запросам, категориям и регионам.
- CTR и позиция клика. Распределение кликов по позициям и средняя позиция клика в разрезе сегментов.
- Конверсии после поиска. Связка поискового запроса с целевым действием в рамках заданного окна атрибуции.
- Срезы. Устройство, платформа, язык, регион, версия приложения и произвольные пользовательские атрибуты.
- Сравнение периодов. Отчёт может сразу вернуть динамику к предыдущему периоду или к контрольной группе.
Сценарии использования
Новые фильтры удобно применять точечно, не перестраивая всю схему аналитики. Типичные сценарии: поиск запросов, которые дают пустую выдачу в конкретном регионе; проверка, не ухудшился ли CTR после изменения ранжирования; сравнение поведения новых и вернувшихся пользователей; контроль эксперимента по версии приложения.
- Диагностика: отчёт по нулевым результатам с фильтром по категории и устройству.
- Мониторинг: ежедневная выборка CTR с исключением ботов и внутреннего трафика.
- Эксперименты: сравнение метрик между группами через фильтр по атрибуту эксперимента.
Производительность и обратная совместимость
Тяжёлые выборки теперь выполняются асинхронно: API возвращает идентификатор задачи, а результат забирается отдельным запросом. Это снимает ограничение на таймаут для отчётов с большим числом измерений.
- Асинхронный режим для отчётов свыше порога по объёму данных.
- Постраничная выдача и курсорная пагинация для больших выборок.
- Кэширование повторяющихся запросов с настраиваемым TTL.
- Прежние параметры запросов продолжают работать, новые поля опциональны.
Чтобы перейти на новый формат, достаточно обновить версию в заголовке запроса и заменить устаревшие параметры фильтрации на дерево условий. Рекомендуется начать с одного отчёта, сверить цифры со старой выгрузкой и только затем переносить остальные сценарии.
🔗 Читать оригинал →
Обсудим вашу задачу
Оставьте телефон — перезвоним в рабочее время, назовём стоимость и срок.
Или позвоните сами: 8 903 572 1011, Пн–Пт с 10:00 до 18:00 по Москве.