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. 

NameDescription
adReutrns all ads data.
campaignReutrns all campaigns data.
clientReutrns all clients data.
officeReutrns 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. 

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

NameDescriptionType
spentSpent fundsFLOAT
impressionsImpressionsFLOAT
clicksClicksINTEGER
video_viewsVideo views (for video ads)INTEGER
video_views_halfHalf-video views (for video ads)FLOAT
video_views_fullFull-video views (for video ads)FLOAT
video_clicks_sitevisits of advertiser's website from the video ad (for video ads)INTEGER
reachReachSTRING
join_ratenumber 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
idAd IDSTRING
campaign_idCampaign IDSTRING
campaign_nameCampaign nameSTRING
ad_formatAd formatSTRING
cost_typeCost typeSTRING
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_platformAd platforms.STRING
ad_platform_no_wall1 — «Don't show on communities walls» restriction switched on.INTEGER
all_limitTotal ad limit in roubles. 0 — not specified.INTEGER
category1_idCategory ID.INTEGER
category2_idAdditional category IDINTEGER
statusAd statusSTRING
ad_nameAd nameSTRING
approvedAd moderation statusSTRING
video1 — Video ad.BIT
disclaimer_medical1 — 'Attention: Be sure to read contra indications before use' warning is shown.INTEGER
disclaimer_specialist1 — 'Attention: Consult a specialist before using' warning is shown.INTEGER
disclaimer_supplements1 — 'Attention: A bioactive nutrient, is not a medicine' warning is shown.INTEGER
goal_typeType of goal.STRING
repeat_videoLooping video.BIT
titleHeadline announcements.STRING
descriptionDescription announcements.STRING
link_urlLink to advertised object.STRING
link_domainDomain of advertised site.STRING
link_titleTitle next to button/link.STRING
link_buttonAd button id.STRING
preview_linkA link by clicking on which you can view the advertisement as it looks on the site.STRING
image_srcUrl image ads.STRING
image_src_2xUrl of double resolution image ads.STRING
icon_srcUrl of the ad logo.STRING
icon_src_2xUrl of double resolution of the ad logo.STRING
wallIdId of wall.STRING
postIdId of post.STRING
linkUrl of add.STRING
utm_sourceIt's the value of utm parameter that contains the ad URL.STRING
utm_mediumIt's the value of utm parameter that contains the ad URL.STRING
utm_campaignIt's the value of utm parameter that contains the ad URL.STRING
utm_contentIt's the value of utm parameter that contains the ad URL.STRING
utm_termIt's the value of utm parameter that contains the ad URL.STRING
dateDateDATE
spentSpent fundsFLOAT
impressionsImpressionsFLOAT
clicksClicksINTEGER
video_viewsVideo views (for video ads)INTEGER
video_views_halfHalf-video views (for video ads)FLOAT
video_views_fullFull-video views (for video ads)FLOAT
video_clicks_sitevisits of advertiser's website from the video ad (for video ads)INTEGER
reachReachSTRING
join_ratenumber 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
idAd IDSTRING
campaign_idCampaign IDSTRING
campaign_nameCampaign nameSTRING
ad_formatAd formatSTRING
cost_typeCost typeSTRING
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_platformAd platforms.STRING
ad_platform_no_wall1 — «Don't show on communities walls» restriction switched on.INTEGER
all_limitTotal ad limit in roubles. 0 — not specified.INTEGER
category1_idCategory ID.INTEGER
category2_idAdditional category IDINTEGER
statusAd statusSTRING
ad_nameAd nameSTRING
approvedAd moderation statusSTRING
video1 — Video ad.BIT
disclaimer_medical1 — 'Attention: Be sure to read contra indications before use' warning is shown.INTEGER
disclaimer_specialist1 — 'Attention: Consult a specialist before using' warning is shown.INTEGER
disclaimer_supplements1 — 'Attention: A bioactive nutrient, is not a medicine' warning is shown.INTEGER
goal_typeType of goal.STRING
repeat_videoLooping video.BIT
titleHeadline announcements.STRING
descriptionDescription announcements.STRING
link_urlLink to advertised object.STRING
link_domainDomain of advertised site.STRING
link_titleTitle next to button/link.STRING
link_buttonAd button id.STRING
preview_linkA link by clicking on which you can view the advertisement as it looks on the site.STRING
image_srcUrl image ads.STRING
image_src_2xUrl of double resolution image ads.STRING
icon_srcUrl of the ad logo.STRING
icon_src_2xUrl of double resolution of the ad logo.STRING
wallIdId of wall.STRING
postIdId of post.STRING
linkUrl of add.STRING
utm_sourceIt's the value of utm parameter that contains the ad URL.STRING
utm_mediumIt's the value of utm parameter that contains the ad URL.STRING
utm_campaignIt's the value of utm parameter that contains the ad URL.STRING
utm_contentIt's the value of utm parameter that contains the ad URL.STRING
utm_termIt's the value of utm parameter that contains the ad URL.STRING
monthMonthSTRING
spentSpent fundsFLOAT
impressionsImpressionsFLOAT
clicksClicksINTEGER
video_viewsVideo views (for video ads)INTEGER
video_views_halfHalf-video views (for video ads)FLOAT
video_views_fullFull-video views (for video ads)FLOAT
video_clicks_sitevisits of advertiser's website from the video ad (for video ads)INTEGER
join_ratenumber 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_fromStart of the period of time.STRING
day_toEnd of the period of time.STRING
idAd IDSTRING
campaign_idCampaign IDSTRING
campaign_nameCampaign nameSTRING
ad_formatAd formatSTRING
cost_typeCost typeSTRING
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_platformAd platforms.STRING
ad_platform_no_wall1 — «Don't show on communities walls» restriction switched on.INTEGER
all_limitTotal ad limit in roubles. 0 — not specified.INTEGER
category1_idCategory ID.INTEGER
category2_idAdditional category IDINTEGER
statusAd statusSTRING
ad_nameAd nameSTRING
approvedAd moderation statusSTRING
video1 — Video ad.BIT
disclaimer_medical1 — 'Attention: Be sure to read contra indications before use' warning is shown.INTEGER
disclaimer_specialist1 — 'Attention: Consult a specialist before using' warning is shown.INTEGER
disclaimer_supplements1 — 'Attention: A bioactive nutrient, is not a medicine' warning is shown.INTEGER
goal_typeType of goal.STRING
repeat_videoLooping video.BIT
titleHeadline announcements.STRING
descriptionDescription announcements.STRING
link_urlLink to advertised object.STRING
link_domainDomain of advertised site.STRING
link_titleTitle next to button/link.STRING
link_buttonAd button id.STRING
preview_linkA link by clicking on which you can view the advertisement as it looks on the site.STRING
image_srcUrl image ads.STRING
image_src_2xUrl of double resolution image ads.STRING
icon_srcUrl of the ad logo.STRING
icon_src_2xUrl of double resolution of the ad logo.STRING
wallIdId of wall.STRING
postIdId of post.STRING
linkUrl of add.STRING
utm_sourceIt's the value of utm parameter that contains the ad URL.STRING
utm_mediumIt's the value of utm parameter that contains the ad URL.STRING
utm_campaignIt's the value of utm parameter that contains the ad URL.STRING
utm_contentIt's the value of utm parameter that contains the ad URL.STRING
utm_termIt's the value of utm parameter that contains the ad URL.STRING
spentSpent fundsFLOAT
impressionsImpressionsFLOAT
clicksClicksINTEGER
reachReachSTRING
join_ratenumber 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
idCampaign IDINTEGER
nameCampaign nameSTRING
statusCampaign status (0 — campaign stopped, 1 — campaign started, 2 — campaign deleted)STRING
day_limitCampaign day limit, rubles (0 — no limit set)STRING
all_limitCampaign total limit, rubles (0 — no limit set)STRING
start_timeCampaign start time, as unixtime (0 — time not set)STRING
stop_timecampaign stop time, as unixtime (0 — time not set)STRING
dateDateDATE
spentSpent fundsFLOAT
impressionsImpressionsFLOAT
clicksClicksINTEGER
reachReachSTRING
join_ratenumber 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
idCampaign IDINTEGER
nameCampaign nameSTRING
statusCampaign status (0 — campaign stopped, 1 — campaign started, 2 — campaign deleted)STRING
day_limitCampaign day limit, rubles (0 — no limit set)STRING
all_limitCampaign total limit, rubles (0 — no limit set)STRING
start_timeCampaign start time, as unixtime (0 — time not set)STRING
stop_timecampaign stop time, as unixtime (0 — time not set)STRING
monthMonthSTRING
spentSpent fundsFLOAT
impressionsImpressionsFLOAT
clicksClicksINTEGER
join_ratenumber 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_fromStart of the period of time.STRING
day_toEnd of the period of time.STRING
idCampaign IDINTEGER
nameCampaign nameSTRING
statusCampaign status (0 — campaign stopped, 1 — campaign started, 2 — campaign deleted)STRING
day_limitCampaign day limit, rubles (0 — no limit set)STRING
all_limitCampaign total limit, rubles (0 — no limit set)STRING
start_timeCampaign start time, as unixtime (0 — time not set)STRING
stop_timecampaign stop time, as unixtime (0 — time not set)STRING
spentSpent fundsFLOAT
impressionsImpressionsFLOAT
clicksClicksINTEGER
idClient IDSTRING
nameClient's nameSTRING
day_limitClient's day limit, rubles.STRING
all_limitClient's total limit, rubles.STRING
dateDateDATE
spentSpent fundsFLOAT
impressionsImpressionsFLOAT
clicksClicksINTEGER
idClient IDSTRING
nameClient's nameSTRING
day_limitClient's day limit, rubles.STRING
all_limitClient's total limit, rubles.STRING
monthMonthSTRING
spentSpent fundsFLOAT
impressionsImpressionsFLOAT
clicksClicksINTEGER
day_fromStart of the period of time.STRING
day_toEnd of the period of time.STRING
idClient IDSTRING
nameClient's nameSTRING
day_limitClient's day limit, rubles.STRING
all_limitClient's total limit, rubles.STRING
spentSpent fundsFLOAT
impressionsImpressionsFLOAT
clicksClicksINTEGER
account_idAccount IDINTEGER
account_typeAccount typeSTRING
account_statusAccount statusSTRING
account_nameAccount nameSTRING
access_roleAccess roleSTRING
dateDateDATE
spentSpent fundsFLOAT
impressionsImpressionsFLOAT
clicksClicksINTEGER
account_idAccount IDINTEGER
account_typeAccount typeSTRING
account_statusAccount statusSTRING
account_nameAccount nameSTRING
access_roleAccess roleSTRING
monthMonthSTRING
spentSpent fundsFLOAT
impressionsImpressionsFLOAT
clicksClicksINTEGER
day_fromEnd of the period of time.STRING
day_toEnd of the period of time.STRING
account_idAccount IDINTEGER
account_typeAccount typeSTRING
account_statusAccount statusSTRING
account_nameAccount nameSTRING
access_roleAccess roleSTRING
 
_______________________________________________
Если у вас есть вопросы — свяжитесь с нами!