← К справке Документация VK

Поля API VK Рекламы

Подневная статистика рекламных кампаний

GET /api/v2/statistics/ad_plans/day.json?metrics=all

Пути метрик указаны относительно строки items[].rows[]. Состав ответа зависит от кампании и настроенных событий. Каталог отражает поля, известные UnderscoreStat.

Записей в справочнике — 167

Структура ответа

ПолеОписание
itemsМассив статистики по запрошенным кампаниям.
items[].idЧисловой ID кампании.
items[].rowsМассив дневных строк кампании.
items[].rows[].dateДата дневной строки в формате ГГГГ-ММ-ДД.
items[].totalСводные метрики кампании за запрошенный период.
totalСводные метрики по запрошенным кампаниям за период.

Основные показатели

ПолеОписание
base.showsПоказы
base.clicksКлики
base.goalsДостижения целей
base.spentРасход из API (без множителя НДС)
base.not_ad_spentДополнительные расходы
base.cpmСредняя стоимость 1000 показов.
base.cpcСредняя стоимость клика.
base.cpaСредняя стоимость достижения цели.
base.ctrДоля кликов от показов, в процентах.
base.crКонверсия, %
base.vk.goalsДостижения целей VK
base.vk.cpaCPA VK
base.vk.crКонверсия VK, %
base.vk.resultРезультаты VK
base.vk.cprСтоимость результата VK

Действия и заявки

ПолеОписание
events.opening_appОткрытия приложения
events.opening_postОткрытия рекламной записи
events.moving_into_groupПереходы в сообщество
events.clicks_on_external_urlКлики по внешней ссылке
events.launching_videoЗапуски видео из записи
events.commentsКомментарии
events.joiningsВступления в сообщество
events.likesЛайки
events.sharesРепосты
events.votingsГолосования
events.sending_formОтправки лид-форм

Охват и частота

ПолеОписание
uniques.reachУстаревший показатель охвата. По документации VK возвращает 0.
uniques.totalИтоговый
uniques.initial_totalОхват на начало периода
uniques.incrementПрирост
uniques.frequencyЧастота

Видео

ПолеОписание
video.startedЗапуски видео
video.first_secondПросмотры первой секунды
video.pausedПаузы
video.resumed_after_pauseПродолжения после паузы
video.fullscreen_onВключения полного экрана
video.fullscreen_offВыключения полного экрана
video.sound_turned_offВыключения звука
video.sound_turned_onВключения звука
video.viewed_3_secondsПросмотры 3 секунд
video.viewed_5_secondsПросмотры 5 секунд
video.viewed_10_secondsПросмотры 10 секунд
video.viewed_25_percentПросмотры 25% видео
video.viewed_50_percentПросмотры 50% видео
video.viewed_75_percentПросмотры 75% видео
video.viewed_100_percentПросмотры 100% видео
video.viewed_100_percent_by_clickПросмотры 100% видео после клика
video.viewed_3_seconds_rateДоля: просмотры 3 секунд, %
video.viewed_5_seconds_rateДоля: просмотры 5 секунд, %
video.viewed_10_seconds_rateДоля: просмотры 10 секунд, %
video.viewed_25_percent_rateДоля: просмотры 25% видео, %
video.viewed_50_percent_rateДоля: просмотры 50% видео, %
video.viewed_75_percent_rateДоля: просмотры 75% видео, %
video.viewed_100_percent_rateДоля: просмотры 100% видео, %
video.viewed_range_rateДоли просмотров по диапазонам
video.depth_of_viewСредняя глубина просмотра, %
video.started_costСтоимость запуска видео
video.viewed_3_seconds_costСтоимость: просмотры 3 секунд
video.viewed_5_seconds_costСтоимость: просмотры 5 секунд
video.viewed_10_seconds_costСтоимость: просмотры 10 секунд
video.viewed_25_percent_costСтоимость: просмотры 25% видео
video.viewed_50_percent_costСтоимость: просмотры 50% видео
video.viewed_75_percent_costСтоимость: просмотры 75% видео
video.viewed_100_percent_costСтоимость: просмотры 100% видео

Уникальные просмотры видео

ПолеОписание
uniques_video.startedЗапуски видео
uniques_video.viewed_3_secondsПросмотры 3 секунд
uniques_video.viewed_5_secondsПросмотры 5 секунд
uniques_video.viewed_10_secondsПросмотры 10 секунд
uniques_video.viewed_25_percentПросмотры 25% видео
uniques_video.viewed_50_percentПросмотры 50% видео
uniques_video.viewed_75_percentПросмотры 75% видео
uniques_video.viewed_100_percentПросмотры 100% видео
uniques_video.viewed_100_percent_by_clickПросмотры 100% видео после клика
uniques_video.viewed_3_seconds_rateДоля: просмотры 3 секунд, %
uniques_video.viewed_5_seconds_rateДоля: просмотры 5 секунд, %
uniques_video.viewed_10_seconds_rateДоля: просмотры 10 секунд, %
uniques_video.viewed_25_percent_rateДоля: просмотры 25% видео, %
uniques_video.viewed_50_percent_rateДоля: просмотры 50% видео, %
uniques_video.viewed_75_percent_rateДоля: просмотры 75% видео, %
uniques_video.viewed_100_percent_rateДоля: просмотры 100% видео, %
uniques_video.viewed_range_rateДоли просмотров по диапазонам
uniques_video.depth_of_viewСредняя глубина просмотра, %

Социальные сети

ПолеОписание
social_network.vk_subscribeПодписки · VK
social_network.ok_subscribeПодписки · Одноклассники
social_network.vk_joinВступления · VK
social_network.ok_joinВступления · Одноклассники
social_network.dzen_joinВступления · Дзен
social_network.result_joinВступления · итоговый показатель
social_network.vk_messageСообщения · VK
social_network.ok_messageСообщения · Одноклассники
social_network.result_messageСообщения · итоговый показатель
social_network.vk_likeЛайки · VK
social_network.ok_likeЛайки · Одноклассники
social_network.dzen_likeЛайки · Дзен
social_network.result_likeЛайки · итоговый показатель
social_network.vk_shareРепосты · VK
social_network.ok_shareРепосты · Одноклассники
social_network.result_shareРепосты · итоговый показатель
social_network.ok_commentКомментарии · Одноклассники
social_network.dzen_commentКомментарии · Дзен
social_network.result_commentКомментарии · итоговый показатель

ROMI

ПолеОписание
romi.valueЦенность событий
romi.romiROMI
romi.adv_cost_shareДоля рекламных расходов

Дополнительные списания

ПолеОписание
tps.tpsСписания за MOAT
tps.tpdСписания за сторонние данные

Playable Ads

ПолеОписание
playable.playable_game_openPlayable game open
playable.playable_game_closePlayable game close
playable.playable_call_to_actionPlayable call to action

Видимость рекламы

ПолеОписание
moat.impressionsImpressions
moat.in_viewIn view
moat.never_focusedNever focused
moat.never_visibleNever visible
moat.never_50_perc_visibleNever 50 perc visible
moat.never_1_sec_visibleNever 1 sec visible
moat.human_impressionsHuman impressions
moat.impressions_analyzedImpressions analyzed
moat.in_view_percentIn view percent
moat.human_and_viewable_percHuman and viewable perc
moat.never_focused_percentNever focused percent
moat.never_visible_percentNever visible percent
moat.never_50_perc_visible_percentNever 50 perc visible percent
moat.never_1_sec_visible_percentNever 1 sec visible percent
moat.in_view_diff_percentIn view diff percent
moat.active_in_view_timeActive in view time
moat.attention_qualityAttention quality

Оферы

ПолеОписание
ad_offers.offer_postponedOffer postponed
ad_offers.upload_receiptUpload receipt
ad_offers.earn_offer_rewardsEarn offer rewards

MAX

ПолеОписание
max.subscribeПодписки MAX

Пользовательские события

ПолеОписание
custom_eventОбъект с метриками пользовательских событий. Точные ключи зависят от настроек кабинета, например custom_event.custom_event_42.count.

Столбцы UnderscoreStat

ПолеОписание
dayДата из items[].rows[].date.
ad_plan_idID кампании из items[].id.
ad_plan_nameНазвание кампании из поля items[].name отдельного метода GET /api/v2/ad_plans.json.
spent_with_ndsРасход base.spent, умноженный на коэффициент НДС из настроек подключения.
showsПоказы из base.shows.
clicksКлики из base.clicks.
statistics_jsonJSON с группами метрик дневной строки. Дата выгружается отдельным столбцом.

Параметры запроса

ПолеОписание
idСписок ID кампаний, например 123,456.
date_fromНачальная дата периода в формате ГГГГ-ММ-ДД.
date_toКонечная дата периода включительно в формате ГГГГ-ММ-ДД.
metricsНабор метрик. По умолчанию base, для расширенного ответа all.
attributionРежим атрибуции. conversion — по времени события, impression — по времени показа.