Как читать результаты
Обновлено
Частотность и похожие запросы
Частотность показывает число показов запросов в поиске, а не людей, переходов или заказов. В плагине используется широкое соответствие: учитываются слова фразы в разных порядках и словоформах.
phrases содержит запросы со словами исходной фразы. associations — близкие по смыслу запросы, в которых этих слов может не быть. Эти списки следует показывать отдельно.
Сама исходная фраза удаляется из phrases, потому что её частотность уже есть в total_count. Складывать count похожих запросов нельзя: запросы могут быть вложены друг в друга.
В сравнении sum_count — арифметическая сумма частотностей выбранных фраз. Она не означает общий спрос на тему, поскольку фразы пересекаются.
Операторы
Плагин отклоняет фразы с !, +, двойными и типографскими кавычками, квадратными и круглыми скобками, вертикальной чертой. Минус-слово — дефис перед словом в начале строки или после пробела — тоже приводит к operators_not_supported.
Дефис внутри слова, например интернет-магазин, допускается. Кавычки в тексте вашей просьбы могут выделять фразу, но в аргумент phrase или элементы phrases агент должен передать сам текст без них.
Доли и индексы
| Поле | Как понимать |
|---|---|
share в сравнении |
Доля частотности фразы в sum_count |
share в динамике |
Доля запроса среди всех запросов за ту же точку ряда |
share в географии |
Доля региона, возвращённая API |
affinity_index |
Индекс регионального интереса: 100 — как в среднем по стране, 200 — вдвое выше обычного |
index в сезонности |
Отношение месячной частотности к среднему за весь полученный период, умноженное на 100 |
share передаётся дробью от единицы: 0.0132 — это 1,32 %. Индексы не являются долей рынка: значение 200 у affinity_index не означает 200 % всех запросов.
В географии территории разных уровней могут включать друг друга: город входит в область или округ. Поэтому суммировать count и share по строкам нельзя даже при выбранном region_type.
Границы динамики
Плагин использует только завершённые периоды:
- месяцы — с первого по последнее число;
- недели — с понедельника по воскресенье;
- дни — не позже вчерашнего дня.
Начало месячного периода приводится к первому числу месяца, недельного — к понедельнику. Конец приводится к концу полного периода; текущий неполный период отбрасывается. Поэтому получившийся диапазон может отличаться от указанного в просьбе.
Для дневного шага начало не может быть раньше «сегодня минус 59 дней»: API ограничивает окно 60 днями, считая сегодняшний. Без дат диапазон идёт от этой границы до вчерашнего дня. Для более глубокой истории используйте недели или месяцы.
Неразбираемые даты и даты раньше 2018-01-01 отклоняются. Будущая дата сама по себе не вызывает отказ: конец ограничивается завершённым периодом. Если после выравнивания начало оказалось позже конца, начало переносится к началу периода, в котором лежит конец; при дневном шаге — к самому концу. Если весь дневной диапазон старше доступного окна, плагин заменяет его последним доступным дневным окном. Такие изменения нужно учитывать при чтении ответа.
Если присутствует period_adjusted, агент должен назвать фактические date_from и date_to. Без явно переданных дат это поле не добавляется.
Проверка сезонности
Среднее вычисляется по всем полученным месячным точкам. Индекс месяца — его частотность, делённая на это общее среднее, с умножением на 100 и округлением.
Для повторяемости плагин ищет тот же календарный месяц в другом году. Пик считается устойчивым, если его индекс выше 100 в обоих наблюдениях; минимум — если ниже 100 в обоих. Сравнение идёт с общим средним за полученный период, отдельное среднее каждого года не рассчитывается.
При одном наблюдении календарного месяца проверки устойчивости нет. Значения индекса пика от 120 или минимума до 80 включительно используются для текстового вывода о выраженной сезонности; это отдельное правило, не критерий повторяемости.
Если ряд пуст или все месячные частотности нулевые, инструмент сезонности возвращает no_data. Это не основание обещать результат при немедленном повторе: проверьте написание или выберите более общую фразу.