Перейти в кабинет

VK Реклама: описание выгружаемых полей

Скачать .md

В этой статье собраны все поля, которые коннектор VK Реклама выгружает в хранилище ROMI center. О периодичности выгрузки и лид-формах — в статье VK Реклама: как работает коннектор.

Как читать таблицу:

  • Название — подпись поля в визарде подключения.
  • Колонка в БД — имя колонки в таблице хранилища. У метрик оно составное: <группа>_<метрика>, например base_shows.
  • Поле API — путь к значению в ответе VK Рекламы. Метрики лежат в блоке total строки статистики, то есть base.shows в таблице ниже — это total.base.shows в ответе.
  • Тип поля — смысловой тип.

Каталог содержит 115 полей: 8 общих, 7 идентификаторов рекламной структуры и 100 метрик, разложенных по десяти группам.

Общие поля

НазваниеКолонка в БДТип поля
Дата статистикиstats_dayДата
Метка utm_sourceutm_sourceСтрока
Метка utm_mediumutm_mediumСтрока
Campaign ID в Google Analytics 4 (utm_id)utm_idСтрока
Метка utm_campaignutm_campaignСтрока
Метка utm_termutm_termСтрока
Метка utm_contentutm_contentСтрока
Расходы (с учётом настроек)costДробное число

Примечание

cost — списание из VK Рекламы, умноженное на ставку НДС из настроек. Валюта — валюта кабинета VK; пересчёта в рубли нет, для другой валюты нужна настройка конвертации.

Идентификация рекламной структуры

НазваниеКолонка в БДПоле APIТип поля
Идентификатор кампанииad_plan_idad_plan_idЦелое число
Наименование кампанииad_plan_namead_plan_nameСтрока
Идентификатор рекламной группыad_group_idad_group_idЦелое число
Название группыad_group_namead_group_nameСтрока
Идентификатор объявленияbanner_idbanner_idЦелое число
Название баннераbanner_namebanner_nameСтрока
Идентификатор лид-формыlead_form_idlead_form_idЦелое число

Примечание

Идентификатор лид-формы заполняется только у объявлений, ведущих на лид-форму, — у остальных он пустой.

Базовые метрики (base)

НазваниеКолонка в БДПоле APIТип поля
Количество показовbase_showsbase.showsЦелое число
Количество кликовbase_clicksbase.clicksЦелое число
Количество достижений целейbase_goalsbase.goalsЦелое число
Среднее списание за 1000 просмотровbase_cpmbase.cpmДробное число
Среднее списание за 1 кликbase_cpcbase.cpcДробное число
Среднее списание за достижение 1 целиbase_cpabase.cpaДробное число
CTR — отношение кликов к показамbase_ctrbase.ctrДробное число
CR — отношение достижений целей к кликамbase_crbase.crДробное число

События соцсетей (events)

НазваниеКолонка в БДПоле APIТип поля
Открытия рекламируемого приложенияevents_opening_appevents.opening_appЦелое число
Открытия рекламируемого сообщения в лентеevents_opening_postevents.opening_postЦелое число
Переходы на страницу группы из сообщенияevents_moving_into_groupevents.moving_into_groupЦелое число
Клики по внешней ссылке в сообщенииevents_clicks_on_external_urlevents.clicks_on_external_urlЦелое число
Запуски видео в сообщенииevents_launching_videoevents.launching_videoЦелое число
Нажатия «Комментировать»events_commentsevents.commentsЦелое число
Присоединения к группе через сообщениеevents_joiningsevents.joiningsЦелое число
Лайки рекламируемого сообщенияevents_likesevents.likesЦелое число
Действия «Поделиться»events_sharesevents.sharesЦелое число
Действия голосованияevents_votingsevents.votingsЦелое число
Отправка формы (по данным пикселя)events_sending_formevents.sending_formЦелое число

Уникальные пользователи (uniques)

НазваниеКолонка в БДПоле APIТип поля
Уникальные пользователи (всего от старта кампании)uniques_totaluniques.totalЦелое число
Прирост уникальных пользователей за периодuniques_incrementuniques.incrementЦелое число
Суточная частота показаuniques_frequencyuniques.frequencyДробное число
Уникальные пользователи на начало периодаuniques_frequency_totaluniques.frequency_totalДробное число

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

НазваниеКолонка в БДПоле APIТип поля
Уникальные старты воспроизведенияuniques_video_starteduniques_video.startedЦелое число
Уникальные просмотры первых 10 секундuniques_video_viewed_10_secondsuniques_video.viewed_10_secondsЦелое число
Уникальные просмотры 25% длительностиuniques_video_viewed_25_percentuniques_video.viewed_25_percentЦелое число
Уникальные просмотры 50% длительностиuniques_video_viewed_50_percentuniques_video.viewed_50_percentЦелое число
Уникальные просмотры 75% длительностиuniques_video_viewed_75_percentuniques_video.viewed_75_percentЦелое число
Уникальные просмотры 100% длительностиuniques_video_viewed_100_percentuniques_video.viewed_100_percentЦелое число
Процент уникальных просмотров 10 секuniques_video_viewed_10_seconds_rateuniques_video.viewed_10_seconds_rateДробное число
Процент уникальных просмотров 25%uniques_video_viewed_25_percent_rateuniques_video.viewed_25_percent_rateДробное число
Процент уникальных просмотров 50%uniques_video_viewed_50_percent_rateuniques_video.viewed_50_percent_rateДробное число
Процент уникальных просмотров 75%uniques_video_viewed_75_percent_rateuniques_video.viewed_75_percent_rateДробное число
Процент уникальных просмотров 100%uniques_video_viewed_100_percent_rateuniques_video.viewed_100_percent_rateДробное число
Средняя глубина уникальных просмотров, %uniques_video_depth_of_viewuniques_video.depth_of_viewДробное число

Видео (video)

НазваниеКолонка в БДПоле APIТип поля
Старты воспроизведения видеоvideo_startedvideo.startedЦелое число
Паузы воспроизведенияvideo_pausedvideo.pausedЦелое число
Воспроизведения после паузыvideo_resumed_after_pausevideo.resumed_after_pauseЦелое число
Включения полноэкранного режимаvideo_fullscreen_onvideo.fullscreen_onЦелое число
Выключения полноэкранного режимаvideo_fullscreen_offvideo.fullscreen_offЦелое число
Выключения звукаvideo_sound_turned_offvideo.sound_turned_offЦелое число
Включения звукаvideo_sound_turned_onvideo.sound_turned_onЦелое число
Просмотры первых 10 секундvideo_viewed_10_secondsvideo.viewed_10_secondsЦелое число
Просмотры 25% длительностиvideo_viewed_25_percentvideo.viewed_25_percentЦелое число
Просмотры 50% длительностиvideo_viewed_50_percentvideo.viewed_50_percentЦелое число
Просмотры 75% длительностиvideo_viewed_75_percentvideo.viewed_75_percentЦелое число
Просмотры 100% длительностиvideo_viewed_100_percentvideo.viewed_100_percentЦелое число
Процент просмотров 10 секvideo_viewed_10_seconds_ratevideo.viewed_10_seconds_rateДробное число
Процент просмотров 25%video_viewed_25_percent_ratevideo.viewed_25_percent_rateДробное число
Процент просмотров 50%video_viewed_50_percent_ratevideo.viewed_50_percent_rateДробное число
Процент просмотров 75%video_viewed_75_percent_ratevideo.viewed_75_percent_rateДробное число
Процент просмотров 100%video_viewed_100_percent_ratevideo.viewed_100_percent_rateДробное число
Средняя глубина просмотра, %video_depth_of_viewvideo.depth_of_viewДробное число
Стоимость старта просмотраvideo_started_costvideo.started_costДробное число
Средняя стоимость просмотра 10 секvideo_viewed_10_seconds_costvideo.viewed_10_seconds_costДробное число
Средняя стоимость просмотра 25%video_viewed_25_percent_costvideo.viewed_25_percent_costДробное число
Средняя стоимость просмотра 50%video_viewed_50_percent_costvideo.viewed_50_percent_costДробное число
Средняя стоимость просмотра 75%video_viewed_75_percent_costvideo.viewed_75_percent_costДробное число
Средняя стоимость просмотра 100%video_viewed_100_percent_costvideo.viewed_100_percent_costДробное число

Примечание

Для каждого из шести слайдов — три метрики. Ниже показаны первые три слайда; слайды 4–6 устроены так же (carousel_slide_4_clicks, carousel_slide_5_shows, carousel_slide_6_ctr и т. д.).

НазваниеКолонка в БДПоле APIТип поля
Клики по слайду 1carousel_slide_1_clickscarousel.slide_1_clicksЦелое число
Показы слайда 1carousel_slide_1_showscarousel.slide_1_showsЦелое число
CTR слайда 1carousel_slide_1_ctrcarousel.slide_1_ctrДробное число
Клики по слайду 2carousel_slide_2_clickscarousel.slide_2_clicksЦелое число
Показы слайда 2carousel_slide_2_showscarousel.slide_2_showsЦелое число
CTR слайда 2carousel_slide_2_ctrcarousel.slide_2_ctrДробное число
Клики по слайду 3carousel_slide_3_clickscarousel.slide_3_clicksЦелое число
Показы слайда 3carousel_slide_3_showscarousel.slide_3_showsЦелое число
CTR слайда 3carousel_slide_3_ctrcarousel.slide_3_ctrДробное число

Playable (playable)

НазваниеКолонка в БДПоле APIТип поля
Открытие игрыplayable_playable_game_openplayable.playable_game_openЦелое число
Закрытие игрыplayable_playable_game_closeplayable.playable_game_closeЦелое число
Клики Call-to-action в игреplayable_playable_call_to_actionplayable.playable_call_to_actionЦелое число

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

НазваниеКолонка в БДПоле APIТип поля
Списания за сервис Moattps_tpstps.tpsДробное число
Списания за сторонние данные (DMP)tps_tpdtps.tpdДробное число

Видимость Moat (moat)

НазваниеКолонка в БДПоле APIТип поля
Показы в сервисе Moatmoat_impressionsmoat.impressionsЦелое число
Просмотры в сервисе Moatmoat_in_viewmoat.in_viewЦелое число
Никогда не было в фокусеmoat_never_focusedmoat.never_focusedЦелое число
Никогда не было видимоmoat_never_visiblemoat.never_visibleЦелое число
Менее 50% объявления было видноmoat_never_50_perc_visiblemoat.never_50_perc_visibleЦелое число
Отображалось менее 1 секундыmoat_never_1_sec_visiblemoat.never_1_sec_visibleЦелое число
Реальные показыmoat_human_impressionsmoat.human_impressionsЦелое число
Проанализированные показыmoat_impressions_analyzedmoat.impressions_analyzedЦелое число
Доля видимых показовmoat_in_view_percentmoat.in_view_percentДробное число
Доля реальных и видимых показовmoat_human_and_viewable_percmoat.human_and_viewable_percДробное число
Доля «никогда не было в фокусе»moat_never_focused_percentmoat.never_focused_percentДробное число
Доля «никогда не было видно»moat_never_visible_percentmoat.never_visible_percentДробное число
Доля показов с видимостью менее 50%moat_never_50_perc_visible_percentmoat.never_50_perc_visible_percentДробное число
Доля «отображалось менее 1 секунды»moat_never_1_sec_visible_percentmoat.never_1_sec_visible_percentДробное число
Расхождение с другой системой измеренияmoat_in_view_diff_percentmoat.in_view_diff_percentДробное число

ROMI (romi)

НазваниеКолонка в БДПоле APIТип поля
Заданная ценность событияromi_valueromi.valueДробное число
Показатель возврата инвестицийromi_romiromi.romiДробное число
Доля возврата инвестицийromi_adv_cost_shareromi.adv_cost_shareДробное число

Покажем, из чего собирается ваша аналитика

За 30 минут разберём ваши источники и соберём схему: что подключается, что считается само, где цифры разойдутся.

  • Что у вас уже собирается и чего не хватает, чтобы увидеть выручку по каналам
  • Порядок подключения: что заработает за день, а что придётся настроить руками
  • Готовые отчёты на живых данных — расход и выручка рядом, когорты, RFM
Записаться на демо
Дашборд ROMI center со сквозной аналитикой