VK Ads
Manage VK Ads campaigns, ad groups, ads, and statistics via the API
vk
VK Ads is the official advertising platform of VK (VKontakte), Russia's largest social network. Its API provides programmatic access to campaign management and performance statistics for advertisers.
With the VK Ads integration in AACFlow, you can:
- Get Campaigns: Retrieve advertising campaigns in your account
- Get Ad Groups: List ad groups within campaigns
- Get Ads: Enumerate individual ads with filtering options
- Get Statistics: Retrieve performance metrics for campaigns, ad groups, or ads
This integration enables automated ad performance reporting, budget monitoring, and campaign management workflows.
Usage Instructions
Integrate VK Ads into the workflow to manage advertising data. Requires a VK Ads OAuth token. Obtain tokens via the VK OAuth flow at id.vk.com.
Tools
vk_ads_get_campaigns
Get advertising campaigns
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
oauthToken | string | Yes | VK Ads OAuth token |
limit | number | No | Maximum campaigns to return |
Output
| Parameter | Type | Description |
|---|---|---|
campaigns | array | Array of campaign objects |
total | number | Total campaigns count |
vk_ads_get_ad_groups
Get ad groups
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
oauthToken | string | Yes | VK Ads OAuth token |
campaignId | string | No | Filter by campaign ID |
limit | number | No | Maximum ad groups to return |
Output
| Parameter | Type | Description |
|---|---|---|
adGroups | array | Array of ad group objects |
vk_ads_get_ads
Get ads
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
oauthToken | string | Yes | VK Ads OAuth token |
campaignId | string | No | Filter by campaign ID |
adGroupId | string | No | Filter by ad group ID |
limit | number | No | Maximum ads to return |
Output
| Parameter | Type | Description |
|---|---|---|
ads | array | Array of ad objects |
vk_ads_get_statistics
Get performance statistics
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
oauthToken | string | Yes | VK Ads OAuth token |
objectType | string | Yes | Object type: campaign, ad_group, or ad |
objectIds | string | Yes | Comma-separated object IDs |
dateFrom | string | Yes | Start date (YYYY-MM-DD) |
dateTo | string | Yes | End date (YYYY-MM-DD) |
Output
| Parameter | Type | Description |
|---|---|---|
statistics | array | Array of statistics objects |
Links
- Official API: https://ads.vk.com/help/api
- AACFlow block source: apps/aacflow/blocks/blocks/vk_ads.ts