VK Ads
VK Ads отдаёт статистику на уровне отдель ных объявлений: одна строка на объявление за день. Отчёт вы собираете сами из измерений и метрик: расход и клики, события вовлечения, просмотры видео, статистика по слайдам карусели, viewability и UTM-метки из настроек группы объявлений.
Renta выгружает этот отчёт в ваше хранилище данных и добавляет атрибуты объектов за каждой строкой: названия кампаний и групп объявлений, package id и статус модерации объявления.
Аутентификация
Renta использует OAuth для аутентификации в VK Ads. Вы будете перенаправлены в VK Ads, чтобы предоставить Renta ограниченный доступ к рекламному аккаунту.
Подключение источника VK Ads
Выполните эти шаги, чтобы добавить VK Ads как источник в Renta через OAuth-аутентификацию.
- Перейдите в раздел Connections > Catalog в левом меню.
- Откройте категорию Advertising и нажмите карточку VK Ads.
Нажмите Log in to your VK Ads account. Вы будете перенаправлены в VK Ads для предоставления доступа.
VK Ads показывает запрос на доступ для приложения Renta и спрашивает, к какому аккаунту его предоставить. Оставьте выбранным свой аккаунт и нажмите Разрешить доступ. После этого вы вернётесь в Renta.
Завершите настройку:
- Source name.
Укажите название источника данных. Оно используется только в интерфейсе Renta. - Access granted.
Убедитесь, что аккаунт подключён успешно.
Нажмите Save, чтобы завершить.
Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна
После подключения источника создайте пайплайн, чтобы синхронизировать данные VK Ads с вашим назначением.
Создание пайплайна VK Ads
Свяжите источник VK Ads с назначением и настройте пайплайн.
В левом меню нажмите New pipeline. На шаге Source выберите VK Ads в списке Already connected и нажмите Next step.
Выберите созданное ранее подключение VK Ads и нажмите Next step.
На шаге Destination выберите ваше назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение назначения, в которое нужно загружать данные, и нажмите Next step.
Настройка пайплайна
На финальном шаге выберите, какие данные VK Ads выгружать и как Renta будет их загружать.
Настройка отчёта
Укажите рекламный аккаунт, из которого нужны данные.
- Ad accounts.
Выберите аккаунт VK Ads, из которого выгружать данные. Каждый пайплайн выгружает статистику одного аккаунта. Для агентского подключения список показывает клиентские аккаунты агентства. - Report Types.
VK Ads предоставляет один тип отчёта,Custom report: статистику на уровне объявлений, которую вы собираете из измерений и метрик.
Параметры
Выберите поля VK Ads, которые попадут в таблицу назначения. Выбранные здесь параметры определяют схему таблицы.
На вкладке Dimensions отметьте поля, описывающие объявление за каждой строкой: Date, название и идентификатор кампании, название и идентификатор группы объявлений, package id, идентификатор и название объявления, а также Ad moderation status. Используйте поиск по названию или нажмите Select All.
На вкладке Metrics отметьте показатели для выгрузки: показы, клики, расход, цели и стоимостные метрики, события вовлечения, охват и частоту по уникальным пользователям, просмотры видео по глубине досмотра, клики и показы по слайдам карусели, viewability, события playable-объявлений и офферов, а также ROMI. Вкладка Selected показывает всё выбранное, а список Selected Parameters под пикером позволяет убрать параметр.
В отчёт входят объявления и группы объявлений в любом статусе. Статистику Renta запрашивает с атрибуцией по конверсии.
Пять UTM-измерений (utm_source, utm_medium, utm_campaign, utm_content, utm_term) возвращают значения из настроек UTM группы объявлений. Renta подставляет реальные значения вместо динамических плейсхолдеров, поэтому в таблице назначения оказываются итоговые идентификаторы, а не текст плейсхолдеров.
| Плейсхолдер | Чем заменяется |
|---|---|
{ad_id} | Идентификатор объявления в строке. |
{campaign_id} | Идентификатор кампании объявления. |
{campaign_name} | Название кампании объявления. |
{client_id} | Идентификатор выгружаемого рекламного аккаунта. |
Измерение UTM schema возвращает исходную строку параметров, как она задана в VK Ads.
Название таблицы
Назовите пайплайн и таблицу назначения.
- Integration name.
Название пайплайна. Используется только в интерфейсе Renta. - Table name.
Название таблицы назначения. Можно оставить автоматически сгенерированное название или задать своё.
Диапазон дат
Задайте исторический период загрузки.
- Date start.
Первая дата периода выгрузки. - Date end.
Последняя дата периода выгрузки. Оставьте Today, чтобы собирать новые данные при каждом запуске.
VK Ads отдаёт статистику по одному дню за раз и ограничивает частоту запросов, поэтому широкий исторический диапазон загружается заметно дольше, чем несколько дней. Renta распределяет запросы так, чтобы не выходить за квоты.
Период перезаписи
Период перезаписи определяет, сколько последних дней Renta перезагружает при каждом запуске.
При каждом запуске Renta заново запрашивает отчёт начиная с даты последнего успешного запуска минус период перезаписи. Затронутые дни удаляются из та блицы назначения и вставляются заново, более старые данные не меняются. Варианты: от Without overwrite data до Overwrite all data. По умолчанию выбран Last 1 day.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в день в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точн ое время запуска), затем нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и название таблицы назначения.
Стратегия синхронизации
Стратегия синхронизации зависит от того, включено ли в отчёт измерение Date.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Инкрементальное обновление | Custom report (с выбранным измерением Date) | Каждая строка соответствует одному дню, таблица назначения партиционируется по колонке date. При каждом запуске Renta перезагружает окно от последнего успешного запуска минус период перезаписи до конца диапазона дат: эти дневные партиции удаляются и вставляются заново, более старые партиции не меняются. |
| Полная перезагрузка | Custom report (без измерения Date) | В таблице нет колонки даты для партиционирования, поэтому Renta запрашивает весь настроенный диапазон дат и заменяет данные при каждом запуске. |
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.