Считайте расход и CTR кампаний VK Рекламы без выгрузок

Агент ходит в API кабинета на ads.vk.ru и читает три уровня структуры: кампании в /api/v2/ad_plans.json, группы в /api/v2/ad_groups.json и объявления в /api/v2/banners.json, а цифры снимает из дневной статистики /api/v2/statistics по каждому из этих уровней и по аудитории. Из этого он считает показы, клики, CTR, цену клика и расход за период и сравнивает объявления внутри кампании между собой.

У ВКонтакте два разных рекламных API, и это главная путаница: старый кабинет на api.vk.com с методами вида ads.getStatistics на ads.vk.ru просто не существует — хост отвечает HTML-страницей с ошибкой 404. Агент это знает и не подбирает соседние пути вслепую, а сразу говорит, что нужны ключи именно из VK Рекламы. Статистика здесь дневная, поэтому сегодняшний день до его закрытия остаётся неполным, и агент называет период, за который взял цифры.

По умолчанию кабинет используется на чтение: агент собирает и разбирает статистику, не трогая настройки кампаний, ставки и бюджеты — рекламные деньги откручиваются в реальном времени, и молчаливая правка ставки обходится дороже любой ошибки в отчёте. Вместо этого он предупреждает заранее: показывает остаток на счёте и темп открутки и говорит, что реклама встанет раньше, чем закончится неделя, оставляя решение вам.

Access-токен агент получает по client_credentials и обновляет сам: истёкший он меняет между запросами, не теряя начатую выгрузку. Статистику он снимает окнами по датам и по уровням, поэтому отчёт за квартал собирается несколькими вызовами и сводится уже на нашей стороне. Частоту агент держит в пределах пяти запросов в секунду и о нехватке данных или прав говорит прямо, а не показывает пустую таблицу.