VK Ads
Управление кампаниями VK Ads, группами объявлений, рекламными объявлениями и статистикой через API
vk
VK Ads — это the official advertising platform of VK (VKontakte), Russia's largest social network. Its API предоставляет programmatic access to campaign management и performance statistics для advertisers.
С помощью VK Ads интеграции в AACFlow можно:
- Получить Campaigns: Получитьdvertising campaigns in your account
- Получить Ad Groups: Список ad groups within campaigns
- Получить Ads: Enumerate individual ads с фильтрация options
- Получить Statistics: Получить performance metrics для campaigns, ad groups, или ads
Эта интеграция позволяет automated ad performance reporting, budget monitoring, и можетmpaign management workflows.
Инструкции по использованию
Интегрируйте VK Ads в рабочий процесс для управления рекламными данными. Требуется a VK Ads OAuth token. Obtain tokens via the VK OAuth flow at id.vk.com.
Инструменты
vk_ads_get_campaigns
Получить advertising campaigns
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
oauthToken | string | Да | VK Ads OAuth token |
limit | number | Нет | Maximum campaigns to return |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
campaigns | array | Массив campaign objects |
total | number | Total campaigns count |
vk_ads_get_ad_groups
Получить ad groups
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
oauthToken | string | Да | VK Ads OAuth token |
campaignId | string | Нет | Filter by campaign ID |
limit | number | Нет | Maximum ad groups to return |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
adGroups | array | Массив ad group objects |
vk_ads_get_ads
Получить ads
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
oauthToken | string | Да | VK Ads OAuth token |
campaignId | string | Нет | Filter by campaign ID |
adGroupId | string | Нет | Filter by ad group ID |
limit | number | Нет | Maximum ads to return |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ads | array | Массив ad objects |
vk_ads_get_statistics
Получить performance statistics
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
oauthToken | string | Да | VK Ads OAuth token |
objectType | string | Да | Object type: campaign, ad_group, or ad |
objectIds | string | Да | Comma-separated object IDs |
dateFrom | string | Да | Start date (YYYY-MM-DD) |
dateTo | string | Да | End date (YYYY-MM-DD) |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
statistics | array | Массив statistics objects |
Ссылки
- Official API: https://ads.vk.com/help/api
- AACFlow block source: apps/aacflow/blocks/blocks/vk_ads.ts