Статистика и отчёты

Выберите уровень и период

Статистика запрашивается на одном из уровней:

В ids можно передать номера нужных объектов, полученные инструментами списков. Без ids статистика запрашивается по всем объектам выбранного уровня.

В vkads_get_stats и vkads_get_goal_stats даты передаются как date_from и date_to в формате YYYY-MM-DD. По умолчанию берутся семь завершившихся дней: до вчера включительно. Если задана только конечная дата, начальная будет на шесть дней раньше неё. Понятие «сегодня» код определяет по времени сервера.

group_by=summary возвращает итог за период; group_by=day — разбивку по дням. Дневные запросы ограничены глубиной 365 дней. Инструмент конверсий по целям использует дневные запросы и при summary, поэтому ограничение глубины действует на него в обоих режимах.

Плагин автоматически разбивает запросы статистики на части до 50 номеров и до 92 дней, затем объединяет результат. Это размер внутренних запросов, а не максимальный размер отчёта.

Показатели основной статистики

При объединении плагин складывает счётчики, затем заново рассчитывает производные показатели. Складывать дневные CTR или усреднять дневные CPC без учёта объёмов нельзя. Если данных или положительного знаменателя нет, показатель может быть null.

В metrics можно запрашивать группы метрик VK. Основная группа — base; дополнительные группы выдаются в groups. У объектов, собранных из нескольких частей периода или номеров, дополнительные группы могут быть опущены с предупреждением. Для обычной сводки используйте base.

Конверсии по каждой цели

vkads_get_goal_stats показывает конверсии по целям подключённого пикселя. Параметр conversion_type:

• postclick — после клика, по умолчанию;
• postview — после просмотра.

В ответе присутствуют сведения о счётчике и цели, число конверсий и ценность, когда они доступны. CR, CPA и ROMI от VK сохраняются для объекта, если весь период получен одним запросом; при объединении частей складываются число и ценность. Общий итог goals_total также не складывает коэффициенты.

Пустой результат может означать отсутствие подключённого пикселя, целей или конверсий. Проверьте vkads_get_pixels с with_goals=true.

Расход сегодня

vkads_get_today_spend объединяет итог за текущий день с оперативными счётчиками VK. Для каждого объекта доступны today и, если VK вернул данные, last_hour. В freshness указаны время последних данных и их возраст либо сообщение, что свежих данных ещё не было.

Оперативный результат зависит от данных VK. Проверяйте свежесть; отсутствие счётчиков нельзя автоматически считать нулевым расходом. Для завершившихся дней используйте vkads_get_stats.

Лучшие и худшие объекты

vkads_get_top_objects поддерживает spent, clicks, shows, goals, ctr, cpc, cpa. order=desc сортирует от большего к меньшему, order=asc — от меньшего к большему. По умолчанию выдаются десять строк, максимум 50.

Для CTR, CPC и CPA по умолчанию требуется хотя бы 100 показов; для остальных метрик порог равен нулю. Его можно изменить параметром min_shows. Строки с отсутствующим значением выбранной метрики исключаются.

Без ids инструмент обходит до 500 активных и остановленных объектов уровня. Если их больше, результат содержит предупреждение; передайте конкретные ids, чтобы сузить выбор.

Покажи десять объявлений VK Рекламы с самым высоким CPC за последние
семь завершившихся дней. Учитывай только объявления от 100 показов.
Укажи период, расход, клики и CPC. Ничего не меняй.

На условных данных показаны лучшие и худшие объявления по CTR с числом показов и CPC.