VK Ads Source

Renta поддерживает экспорт данных из VK Ads в следующие пункты назначения:

  • Google BigQuery
  • Clickhouse
  • SQL Server
  • Google Spreadsheets
  • Google Analytics

Создание интеграции в хранилище данных (DWH)

  1. Перейдите в каталог интеграций;
  2. Выберите VK Ads;
  3. Добавьте аккаунт VK Ads, в котором находятся необходимые данные;
  4. Выберите добавленный аккаунт VK Ads;
  5. Укажите место назначения, в которое вы хотите импортировать данные;
  6. Перейдите на экран настроек и установите необходимую конфигурацию:

Account

Здесь вы можете выбрать ваш рекламный аккаунт VK Ads, содержащий необходимую статистику.

Source type

Тип источника — состоит из уникального набора параметров и метрик, доступных для выгрузки в DWH. Каждый тип источника соответствует одноименному методу API VK Ads. 

Name Description
ad Reutrns all ads data.
campaign Reutrns all campaigns data.
client Reutrns all clients data.
office Reutrns all offices data.

Parameters

Параметры — содержат список параметров и метрик, доступных для экспорта. Укажите необходимые для выгрузки параметры.

В результате Renta создаст таблицу, которая будет содержать данные выбранных параметров. Порядок выбранных параметров в интерфейсе будет соответствовать порядку столбцов таблицы.

Date range type

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

Чтобы выбрать необходимое время, введите в поле «From» дату, с которой вы хотите начать выгрузку данных, затем введите дату окончания в поле «To».

Если вы хотите, чтобы данные в таблице обновлялись ежедневно и дополнялись новыми днями, тогда в поле «To» укажите «Yesterday».
Подробная инструкция по работе с диапазоном дат

Integration name

Имя интеграции — при создании интеграции автоматически генерируется её имя. В этом поле вы можете переименовать название интеграции. Разрешены как кириллица, так и латиница, но не более 100 символов.

Название интеграции отображается на странице Integration List.

Table name

Имя таблицы — при создании интеграции автоматически генерируется имя таблицы, которая будет создана в DWH. В этом поле вы можете переименовать её.

Разрешена только латиница, цифры и символ «_».

Update time

Время обновления — вы можете указать любое время обновления, которое вам нужно. Рента обновляет интеграции ежедневно в интервале выбранного часа. 

Обычно наши пользователи выбирают время обновления интеграций рано утром, например, в 5 утра. В этом случае ваша интеграция будет обновляться в период с 5 утра до 6 утра. 

Обновление интеграций происходит по часовому поясу, выбранном в настройках вашего профайла. 

Overwrite period

Период перезаписи данных — это ретроспективное обновление данных за выбранный период.

Например, вы выбираете период перезаписи «Последние 7 дней» — это означает, что все данные за последние 7 дней будут удалены из таблицы и вставлены снова с обновленными данными.

Примечание: данная настройка доступна только в том случае, если был выбран параметр с типом date или dateTime. 

Создание интеграции в Google Spreadsheets

Воспользуйтесь бесплатным расширением, доступным в Google Workspace Marketplace. Для этого:

  1. Установите расширение Renta Spreadsheets Add-on.
  2. Затем зайдите в Google Sheets, и во вкладке Tools выберите Renta, после чего нажмите кнопку Run. 

После чего в правом сайдбаре откроется рабочая область с настройками интеграций. Подробная инструкция по созданию интеграции доступна по данной ссылке. Обратите внимание, что все созданные интеграции в Google Spreadsheets также доступны для управления в веб-версии Renta. 

Структура данных

Name Description Type
spent Spent funds FLOAT
impressions Impressions FLOAT
clicks Clicks INTEGER
video_views Video views (for video ads) INTEGER
video_views_half Half-video views (for video ads) FLOAT
video_views_full Full-video views (for video ads) FLOAT
video_clicks_site visits of advertiser's website from the video ad (for video ads) INTEGER
reach Reach STRING
join_rate number of joins to a group, event, subscriptions for a public page or application installation (only if the ad includes a direct link to the respective VK page) STRING
id Ad ID STRING
campaign_id Campaign ID STRING
campaign_name Campaign name STRING
ad_format Ad format STRING
cost_type Cost type STRING
cpc (if cost_type = per clicks) cost of a click, kopecks. FLOAT
cpm (if cost_type = per impressions) cost of 1000 impressions, kopecks. FLOAT
impressions_limit (if any) impressions limit per user. INTEGER
impressions_limited (if any) 1 — not more than 100 impressions per user. INTEGER
ad_platform Ad platforms. STRING
ad_platform_no_wall 1 — «Don't show on communities walls» restriction switched on. INTEGER
all_limit Total ad limit in roubles. 0 — not specified. INTEGER
category1_id Category ID. INTEGER
category2_id Additional category ID INTEGER
status Ad status STRING
ad_name Ad name STRING
approved Ad moderation status STRING
video 1 — Video ad. BIT
disclaimer_medical 1 — 'Attention: Be sure to read contra indications before use' warning is shown. INTEGER
disclaimer_specialist 1 — 'Attention: Consult a specialist before using' warning is shown. INTEGER
disclaimer_supplements 1 — 'Attention: A bioactive nutrient, is not a medicine' warning is shown. INTEGER
goal_type Type of goal. STRING
repeat_video Looping video. BIT
title Headline announcements. STRING
description Description announcements. STRING
link_url Link to advertised object. STRING
link_domain Domain of advertised site. STRING
link_title Title next to button/link. STRING
link_button Ad button id. STRING
preview_link A link by clicking on which you can view the advertisement as it looks on the site. STRING
image_src Url image ads. STRING
image_src_2x Url of double resolution image ads. STRING
icon_src Url of the ad logo. STRING
icon_src_2x Url of double resolution of the ad logo. STRING
wallId Id of wall. STRING
postId Id of post. STRING
link Url of add. STRING
utm_source It's the value of utm parameter that contains the ad URL. STRING
utm_medium It's the value of utm parameter that contains the ad URL. STRING
utm_campaign It's the value of utm parameter that contains the ad URL. STRING
utm_content It's the value of utm parameter that contains the ad URL. STRING
utm_term It's the value of utm parameter that contains the ad URL. STRING
date Date DATE
spent Spent funds FLOAT
impressions Impressions FLOAT
clicks Clicks INTEGER
video_views Video views (for video ads) INTEGER
video_views_half Half-video views (for video ads) FLOAT
video_views_full Full-video views (for video ads) FLOAT
video_clicks_site visits of advertiser's website from the video ad (for video ads) INTEGER
reach Reach STRING
join_rate number of joins to a group, event, subscriptions for a public page or application installation (only if the ad includes a direct link to the respective VK page) STRING
id Ad ID STRING
campaign_id Campaign ID STRING
campaign_name Campaign name STRING
ad_format Ad format STRING
cost_type Cost type STRING
cpc (if cost_type = per clicks) cost of a click, kopecks. FLOAT
cpm (if cost_type = per impressions) cost of 1000 impressions, kopecks. FLOAT
impressions_limit (if any) impressions limit per user. INTEGER
impressions_limited (if any) 1 — not more than 100 impressions per user. INTEGER
ad_platform Ad platforms. STRING
ad_platform_no_wall 1 — «Don't show on communities walls» restriction switched on. INTEGER
all_limit Total ad limit in roubles. 0 — not specified. INTEGER
category1_id Category ID. INTEGER
category2_id Additional category ID INTEGER
status Ad status STRING
ad_name Ad name STRING
approved Ad moderation status STRING
video 1 — Video ad. BIT
disclaimer_medical 1 — 'Attention: Be sure to read contra indications before use' warning is shown. INTEGER
disclaimer_specialist 1 — 'Attention: Consult a specialist before using' warning is shown. INTEGER
disclaimer_supplements 1 — 'Attention: A bioactive nutrient, is not a medicine' warning is shown. INTEGER
goal_type Type of goal. STRING
repeat_video Looping video. BIT
title Headline announcements. STRING
description Description announcements. STRING
link_url Link to advertised object. STRING
link_domain Domain of advertised site. STRING
link_title Title next to button/link. STRING
link_button Ad button id. STRING
preview_link A link by clicking on which you can view the advertisement as it looks on the site. STRING
image_src Url image ads. STRING
image_src_2x Url of double resolution image ads. STRING
icon_src Url of the ad logo. STRING
icon_src_2x Url of double resolution of the ad logo. STRING
wallId Id of wall. STRING
postId Id of post. STRING
link Url of add. STRING
utm_source It's the value of utm parameter that contains the ad URL. STRING
utm_medium It's the value of utm parameter that contains the ad URL. STRING
utm_campaign It's the value of utm parameter that contains the ad URL. STRING
utm_content It's the value of utm parameter that contains the ad URL. STRING
utm_term It's the value of utm parameter that contains the ad URL. STRING
month Month STRING
spent Spent funds FLOAT
impressions Impressions FLOAT
clicks Clicks INTEGER
video_views Video views (for video ads) INTEGER
video_views_half Half-video views (for video ads) FLOAT
video_views_full Full-video views (for video ads) FLOAT
video_clicks_site visits of advertiser's website from the video ad (for video ads) INTEGER
join_rate number of joins to a group, event, subscriptions for a public page or application installation (only if the ad includes a direct link to the respective VK page) STRING
day_from Start of the period of time. STRING
day_to End of the period of time. STRING
id Ad ID STRING
campaign_id Campaign ID STRING
campaign_name Campaign name STRING
ad_format Ad format STRING
cost_type Cost type STRING
cpc (if cost_type = per clicks) cost of a click, kopecks. FLOAT
cpm (if cost_type = per impressions) cost of 1000 impressions, kopecks. FLOAT
impressions_limit (if any) impressions limit per user. INTEGER
impressions_limited (if any) 1 — not more than 100 impressions per user. INTEGER
ad_platform Ad platforms. STRING
ad_platform_no_wall 1 — «Don't show on communities walls» restriction switched on. INTEGER
all_limit Total ad limit in roubles. 0 — not specified. INTEGER
category1_id Category ID. INTEGER
category2_id Additional category ID INTEGER
status Ad status STRING
ad_name Ad name STRING
approved Ad moderation status STRING
video 1 — Video ad. BIT
disclaimer_medical 1 — 'Attention: Be sure to read contra indications before use' warning is shown. INTEGER
disclaimer_specialist 1 — 'Attention: Consult a specialist before using' warning is shown. INTEGER
disclaimer_supplements 1 — 'Attention: A bioactive nutrient, is not a medicine' warning is shown. INTEGER
goal_type Type of goal. STRING
repeat_video Looping video. BIT
title Headline announcements. STRING
description Description announcements. STRING
link_url Link to advertised object. STRING
link_domain Domain of advertised site. STRING
link_title Title next to button/link. STRING
link_button Ad button id. STRING
preview_link A link by clicking on which you can view the advertisement as it looks on the site. STRING
image_src Url image ads. STRING
image_src_2x Url of double resolution image ads. STRING
icon_src Url of the ad logo. STRING
icon_src_2x Url of double resolution of the ad logo. STRING
wallId Id of wall. STRING
postId Id of post. STRING
link Url of add. STRING
utm_source It's the value of utm parameter that contains the ad URL. STRING
utm_medium It's the value of utm parameter that contains the ad URL. STRING
utm_campaign It's the value of utm parameter that contains the ad URL. STRING
utm_content It's the value of utm parameter that contains the ad URL. STRING
utm_term It's the value of utm parameter that contains the ad URL. STRING
spent Spent funds FLOAT
impressions Impressions FLOAT
clicks Clicks INTEGER
reach Reach STRING
join_rate number of joins to a group, event, subscriptions for a public page or application installation (only if the ad includes a direct link to the respective VK page) STRING
id Campaign ID INTEGER
name Campaign name STRING
status Campaign status (0 — campaign stopped, 1 — campaign started, 2 — campaign deleted) STRING
day_limit Campaign day limit, rubles (0 — no limit set) STRING
all_limit Campaign total limit, rubles (0 — no limit set) STRING
start_time Campaign start time, as unixtime (0 — time not set) STRING
stop_time campaign stop time, as unixtime (0 — time not set) STRING
date Date DATE
spent Spent funds FLOAT
impressions Impressions FLOAT
clicks Clicks INTEGER
reach Reach STRING
join_rate number of joins to a group, event, subscriptions for a public page or application installation (only if the ad includes a direct link to the respective VK page) STRING
id Campaign ID INTEGER
name Campaign name STRING
status Campaign status (0 — campaign stopped, 1 — campaign started, 2 — campaign deleted) STRING
day_limit Campaign day limit, rubles (0 — no limit set) STRING
all_limit Campaign total limit, rubles (0 — no limit set) STRING
start_time Campaign start time, as unixtime (0 — time not set) STRING
stop_time campaign stop time, as unixtime (0 — time not set) STRING
month Month STRING
spent Spent funds FLOAT
impressions Impressions FLOAT
clicks Clicks INTEGER
join_rate number of joins to a group, event, subscriptions for a public page or application installation (only if the ad includes a direct link to the respective VK page) STRING
day_from Start of the period of time. STRING
day_to End of the period of time. STRING
id Campaign ID INTEGER
name Campaign name STRING
status Campaign status (0 — campaign stopped, 1 — campaign started, 2 — campaign deleted) STRING
day_limit Campaign day limit, rubles (0 — no limit set) STRING
all_limit Campaign total limit, rubles (0 — no limit set) STRING
start_time Campaign start time, as unixtime (0 — time not set) STRING
stop_time campaign stop time, as unixtime (0 — time not set) STRING
spent Spent funds FLOAT
impressions Impressions FLOAT
clicks Clicks INTEGER
id Client ID STRING
name Client's name STRING
day_limit Client's day limit, rubles. STRING
all_limit Client's total limit, rubles. STRING
date Date DATE
spent Spent funds FLOAT
impressions Impressions FLOAT
clicks Clicks INTEGER
id Client ID STRING
name Client's name STRING
day_limit Client's day limit, rubles. STRING
all_limit Client's total limit, rubles. STRING
month Month STRING
spent Spent funds FLOAT
impressions Impressions FLOAT
clicks Clicks INTEGER
day_from Start of the period of time. STRING
day_to End of the period of time. STRING
id Client ID STRING
name Client's name STRING
day_limit Client's day limit, rubles. STRING
all_limit Client's total limit, rubles. STRING
spent Spent funds FLOAT
impressions Impressions FLOAT
clicks Clicks INTEGER
account_id Account ID INTEGER
account_type Account type STRING
account_status Account status STRING
account_name Account name STRING
access_role Access role STRING
date Date DATE
spent Spent funds FLOAT
impressions Impressions FLOAT
clicks Clicks INTEGER
account_id Account ID INTEGER
account_type Account type STRING
account_status Account status STRING
account_name Account name STRING
access_role Access role STRING
month Month STRING
spent Spent funds FLOAT
impressions Impressions FLOAT
clicks Clicks INTEGER
day_from End of the period of time. STRING
day_to End of the period of time. STRING
account_id Account ID INTEGER
account_type Account type STRING
account_status Account status STRING
account_name Account name STRING
access_role Access role STRING
 
_______________________________________________
Если у вас есть вопросы — свяжитесь с нами!