В этой статье вы узнаете, как коннектор VK Реклама выгружает данные в хранилище ROMI center: с какой периодичностью, что даёт сбор лид-форм и откуда берутся UTM-метки. Полный список полей — в статье VK Реклама: описание выгружаемых полей.
Периодичность
Выгрузка идёт раз в сутки. Окно по умолчанию — от «сегодня минус 7 дней» до вчера включительно, по одному заданию на день (плюс ещё 7 заданий, если включены лид-формы). Текущий день не выгружается.
Примечание
Параллельность выше, чем у других рекламных коннекторов: очередь VK Рекламы разделена по клиентам — выгрузки разных проектов идут одновременно, внутри одного клиента — строго по очереди.
Кампании, завершившиеся раньше выгружаемого дня, из обработки исключаются. Гранулярность данных: строка = объявление × день. Уровни кампании и группы попадают в ту же строку идентификаторами и названиями.
Как сохраняет данные
- Куда: хранилище ROMI center на движке ClickHouse.
- Имя таблицы:
vk_ads_<идентификатор кабинета>_<id подключения>. - Структура таблицы: движок
MergeTree, сортировка поstats_day, разбиение на партиции по дню статистики. - Порядок колонок: общие поля (
stats_day,utm_*,cost) → колонки конвертации валют → выбранные идентификаторы → выбранные метрики → служебныеrc_import_id,rc_created_at. - Структура догоняется, а не пересоздаётся. Недостающие колонки добавляются при очередной выгрузке, существующие не удаляются. Снятая галочка поля таблицу не меняет — колонка остаётся со старыми значениями.
Перезапись за 7 дней
VK Реклама уточняет статистику задним числом, поэтому каждую ночь перезагружаются последние 7 завершённых дней. Каждый день — отдельное задание: если строк нет, день пропускается и прежние данные сохраняются; если строки есть, весь день удаляется и записывается заново.
Ручная перезагрузка за произвольный период доступна в кабинете и ставит такие же посуточные задания. Если включены лид-формы, для них ставится отдельный комплект заданий на тот же период. При включённой опции «удалить данные» таблица сносится целиком и создаётся заново первой же выгрузкой.
Дополнительные настройки
| Настройка | Что делает |
|---|---|
| Кабинет и клиент агентства | Кабинет — авторизованный аккаунт VK Рекламы; для агентств и менеджеров дополнительно выбирается клиент, статистика которого выгружается. Идентификатор кабинета входит в имя таблицы. |
| Выбор полей | Задаёт набор колонок таблицы. Показы и клики выгружаются всегда. |
| Лид-формы | Отдельный тумблер. При включении подключение начинает собирать вторую таблицу — vk_ads_leads_<кабинет>_<id>, строка на заявку: дата, идентификатор лида, форма, кампания, группа, объявление и время получения лида. Ответов на вопросы формы и расходов в этой таблице нет. Ключ для связи с таблицей расходов — form_id ↔ lead_form_id. |
| НДС | Расходы приходят из VK Рекламы без НДС; при включённой настройке ROMI center добавляет его по указанной ставке. |
| Конвертация валют | На каждую выбранную валюту добавляется колонка cost_converted_<валюта> — расход, пересчитанный по курсу на дату строки. Исходная валюта — валюта кабинета VK. |
| UTM-метки для всех кампаний | Подменяет utm_source, utm_medium, utm_campaign заданными значениями во всех строках. |
| UTM-метки для выбранных кампаний | То же, но покампанийно; индивидуальное значение приоритетнее общего. |
| Пауза коннектора | Останавливает создание новых заданий. |
Примечание
Настройка «Фильтр кампаний» осталась от старого интерфейса: новый визард её не задаёт и при каждом сохранении обнуляет. В отличие от Facebook и TikTok, у VK Рекламы фильтр поддерживает два режима — «только выбранные» и «все, кроме выбранных».
Отозванный доступ к кабинету или к клиенту агентства переводит подключение в состояние ошибки; до починки выгрузка не идёт.
Откуда берутся UTM-метки
Порядок источников для одной строки:
- Автоматическая разметка группы объявлений. Если в группе включена авторазметка VK, берётся её шаблон; при пустом шаблоне применяется стандартный
utm_medium=cpc&utm_source=vk_ads&utm_campaign={{campaign_id}}&utm_content={{banner_id}}. - Ссылка объявления. Если авторазметки нет, метки читаются из адреса перехода. У объявлений, ведущих на лид-форму, ссылки с метками нет — метки останутся значениями по умолчанию.
- Значения по умолчанию, если разметка не нашлась:
rc-vk_ads(utm_source),rc-cpc(utm_medium); дляutm_campaignиutm_idитог зависит от того, была ли разметка вообще, но метки в ней не было (тогдаutm_campaign— название группы объявлений,utm_id— идентификатор кампании), или разметки не было совсем (тогда оба поля —rc-vk_ads). - Пользовательские метки из настроек подключения — общие или покампанийные.
- Подстановка макросов VK в получившихся значениях:
{{advertiser_id}}— идентификатор кабинета,{{campaign_id}}и{{campaign_name}}— идентификатор и название группы объявлений (так устроена разметка VK),{{ad_plan_id}}— идентификатор кампании,{{banner_id}}— идентификатор объявления,{{lead_form_id}}— идентификатор лид-формы.
Важно
Признак «метки собрались не полностью» у VK Рекламы ненадёжен. Он пересчитывается заново на каждом объявлении и снимается только тогда, когда в разметке есть сразу все четыре метки. Из-за этого в результатах выгрузки остаётся состояние последнего обработанного объявления, а не вывод по всем строкам. Ориентироваться лучше на сами данные в таблице.
Технические поля
| Поле | Тип | Что означает |
|---|---|---|
rc_import_id | Целое число | Идентификатор прогона выгрузки, которым записана строка. |
rc_created_at | Дата и время | Момент записи строки в хранилище (не время события). При перезаписи дня обновляется у всех строк дня. |
В таблицах VK Рекламы нет rc_updated_at и rc_datasource — строки не обновляются точечно, а у каждого подключения своя таблица.
