VK Ads: Most-used fields

The table below gives information about most-used fields that you can import from VK Ads. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
account_id	account_id	The unique identifier for an advertising account. This ID is used to retrieve data for the specific account.	dimension
account_name	account_name	The name of the advertising account as retrieved from the API.	dimension
account_status	account_status	The current operational status of the advertising account (e.g., active, blocked).	dimension
account_type	account_type	The type of the advertising account, indicating if it’s a direct advertiser or an agency account.	dimension
ad_age_restriction	ad_age_restriction	The minimum age restriction set for the advertisement.	metric
ad_all_limit	ad_all_limit	The total overall budget or lifetime limit for the advertisement.	metric
ad_category1_id	ad_category1_id	The identifier of the primary category assigned to the ad.	dimension
ad_category1_name	ad_category1_name	The name of the primary category assigned to the ad.	dimension
ad_category2_id	ad_category2_id	The identifier of the secondary category assigned to the ad.	dimension
ad_category2_name	ad_category2_name	The name of the secondary category assigned to the ad.	dimension
ad_cost_type	ad_cost_type	The billing model used for the advertisement, such as Cost Per Click (CPC), Cost Per Mille (CPM), or Cost Per Action (CPA).	dimension
ad_cpc	ad_cpc	The average cost per click for the advertisement.	dimension
ad_cpm	ad_cpm	The average cost per 1000 impressions (Mille) for the advertisement.	metric
ad_create_time	ad_create_time	The date and time when the advertisement was created.	dimension
ad_day_limit	ad_day_limit	The daily budget or limit set for the advertisement.	metric
ad_format	ad_format	The specific format of the advertisement (e.g., banner, video, text-image).	dimension
ad_id	ad_id	The unique identifier for the advertisement.	dimension
ad_impressions_limit	ad_impressions_limit	The maximum number of impressions allowed for the advertisement.	metric
ad_impressions_limited	ad_impressions_limited	Indicates whether the advertisement’s impressions are currently limited.	metric
ad_is_video	ad_is_video	A boolean indicator specifying if the advertisement is a video ad.	metric
ad_moderation_status	ad_moderation_status	The current status of the advertisement within the moderation process (e.g., pending, approved, rejected).	dimension
ad_name	ad_name	The user-defined name or title of the individual advertisement.	dimension
ad_platform	ad_platform	The platform where the advertisement is displayed (e.g., VKontakte, Odnoklassniki).	dimension
ad_start_time	ad_start_time	The date and time when the advertisement is scheduled to start running.	dimension
ad_status	ad_status	The current operational status of the advertisement (e.g., active, paused, deleted, moderated).	dimension
ad_stop_time	ad_stop_time	The date and time when the advertisement is scheduled to stop running.	dimension
ad_update_time	ad_update_time	The date and time when the advertisement was last updated.	dimension
campaign_all_limit	campaign_all_limit	The total budget or impression limit set for the entire duration of the campaign.	metric
campaign_create_time	campaign_create_time	The date and time when the advertising campaign was created.	dimension
campaign_day_limit	campaign_day_limit	The daily budget or impression limit set for the advertising campaign.	metric
campaign_id	campaign_id	The unique identifier for the advertising campaign.	dimension
campaign_name	campaign_name	The user-defined name or title of the advertising campaign.	dimension
campaign_start_time	campaign_start_time	The date and time when the advertising campaign is scheduled to start running.	dimension
campaign_status	campaign_status	The current operational status of the advertising campaign (e.g., active, paused, deleted).	dimension
campaign_stop_time	campaign_stop_time	The date and time when the advertising campaign is scheduled to stop running.	dimension
campaign_type	campaign_type	The type or goal of the advertising campaign (e.g., smart campaign, traffic, conversions).	dimension
campaign_update_time	campaign_update_time	The date and time when the advertising campaign was last updated.	dimension
clicks	clicks	The total number of clicks on the advertisement.	metric
client_all_limit	client_all_limit	The total overall budget or lifetime limit for the client’s advertising activities.	metric
client_day_limit	client_day_limit	The daily budget or limit set for the client’s advertising activities.	metric
client_id	client_id	A unique identifier for the client associated with the advertising account (relevant for agency accounts).	dimension
client_name	client_name	The name of the client associated with the advertising account.	dimension
conversion_count	conversion_count	The total number of conversions recorded for the ad.	dimension
conversion_cr	conversion_cr	The conversion rate, calculated as conversions divided by clicks or impressions.	dimension
conversion_roas	conversion_roas	The Return On Ad Spend, measuring the revenue generated per unit of ad spend.	dimension
conversion_sum	conversion_sum	The total value or sum of all recorded conversions.	dimension
ctr	ctr	The Click-Through Rate, which is the ratio of clicks to impressions.	metric
day	day	The specific date for which the statistics are reported, in YYYY-MM-DD format.	dimension
effective_cost_per_click	effective_cost_per_click	The actual cost incurred for each click on the ad.	metric
effective_cost_per_mille	effective_cost_per_mille	The actual cost incurred per 1000 impressions (Mille) of the ad.	metric
impressions	impressions	The total number of times the ad was displayed or viewed.	metric
reach	reach	The number of unique users who saw the ad.	dimension
spent	spent	The total amount of money spent on the advertisement or campaign.	metric
uniq_views_count	uniq_views_count	The number of unique users who viewed the ad.	metric
video_clicks_site	video_clicks_site	The number of clicks from video ads that directed users to the advertiser’s website.	dimension
video_plays_unique_100_percents	video_plays_unique_100_percents	The number of unique users who viewed 100% of the video ad.	dimension
video_plays_unique_25_percents	video_plays_unique_25_percents	The number of unique users who viewed at least 25% of the video ad.	dimension
video_plays_unique_3_seconds	video_plays_unique_3_seconds	The number of unique users who viewed at least 3 seconds of the video ad.	dimension
video_plays_unique_50_percents	video_plays_unique_50_percents	The number of unique users who viewed at least 50% of the video ad.	dimension
video_plays_unique_75_percents	video_plays_unique_75_percents	The number of unique users who viewed at least 75% of the video ad.	dimension
video_plays_unique_started	video_plays_unique_started	The number of unique users who initiated playback of the video ad.	dimension
video_views	video_views	The total number of video views for video ads.	dimension
video_views_full	video_views_full	The number of times the entire video ad was watched.	dimension
video_views_half	video_views_half	The number of times at least half of the video ad was watched.	dimension