Track VK Ads campaign spend and CTR without report exports
Connect VK Ads to the AI agent: campaigns, ad groups, ads and account statistics. The agent totals spend, clicks and CTR and shows how long the account budget lasts.
How the agent works with VK Реклама
The agent calls the account API at ads.vk.ru and reads three levels of the structure: campaigns from /api/v2/ad_plans.json, ad groups from /api/v2/ad_groups.json and ads from /api/v2/banners.json, taking the figures from the daily statistics at /api/v2/statistics for each of those levels and for the audience. Out of that it calculates impressions, clicks, CTR, cost per click and spend for a period, and compares the ads inside a campaign against each other.
VKontakte has two different advertising APIs, and that is the main source of confusion: the old account on api.vk.com with methods like ads.getStatistics simply does not exist on ads.vk.ru — the host replies with an HTML page and a 404. The agent knows this and does not blindly try neighbouring paths; it says straight away that keys from VK Ads itself are required. Statistics here are daily, so the current day stays incomplete until it closes, and the agent names the period the figures were taken for.
By default the account is used read-only: the agent collects and analyses statistics without touching campaign settings, bids or budgets — ad money is spent in real time, and a silent bid edit costs more than any error in a report. Instead it warns in advance: it shows the balance left on the account and the pace of spend and says that ads will stop before the week is out, leaving the decision to you.
The agent obtains the access token itself via client_credentials and refreshes it with no manual renewal: an expired one is swapped between calls without losing the export in progress. Statistics are taken in windows by date and by level, so a quarterly report is assembled from several calls and joined on our side. The agent holds the rate within five requests per second and states any shortage of data or permissions directly instead of showing an empty table.
Integration scenarios
Spend and CTR by campaign
The agent totals campaign and ad statistics — impressions, clicks, CTR and spend — for the period you need, with no manual report exports from the account.
Account budget left
The agent shows the balance left on the account and the pace of spend, and warns you when ads will stop before the week is out.
Ads compared against each other
The agent lines up the ads inside a campaign by cost per click and CTR and shows which creatives are dragging results down.
Daily account summary
The agent sends yesterday in chat for your VK Ads campaigns: spend, clicks and any notable swings away from the usual numbers.
The audience that clicks
The agent pulls the daily audience statistics and shows which segments bring clicks cheaper and which ones are burning the spend for nothing.
Ad groups inside a campaign
The agent breaks a campaign down into ad groups, puts their targeting settings next to the spend and shows which group is eating the budget.
VK Реклама examples
На счёте 74 300 ₽, при текущем темпе хватит до четверга.
Откручиваете 18,6 тыс ₽ в день, две трети съедает кампания «Ретаргет — корзина». Пополнить стоит до среды, иначе реклама встанет посреди недели.
How to connect
Before you connect
- The new VK Ads cabinet — old VKontakte keys will not work here
- Cabinet access for the employee the request is issued to
- Cabinet permissions bound the campaigns and statistics available
- 1
Sign in to the account at ads.vk.ru
This is the new VK Ads account with its own API. The legacy VKontakte ads account with ads.* methods on api.vk.com will not work here.
- 2
In Settings open API access
In the account settings find “API access” and fill in the details of the employee the access is issued to: no support request needed.
- 3
Copy the client_id under API access
Once access is granted the client_id is shown in the same section and stays available — you can copy it at any time.
FAQ
With a client_id and client_secret pair: in the account at ads.vk.ru open Settings, then API access, and request access. The client_secret is shown only behind a button and only for 10 minutes, so copy it right away. The service obtains and refreshes the access token itself.
The account campaigns, ad groups and ads, their settings and statistics on impressions, clicks and spend — within the permissions of the account whose keys are connected.
No. The old ad account on api.vk.com is a different API with different methods, and its token does not work here. You need keys from the VK Ads account at ads.vk.ru.
By default VK Ads is used read-only: the agent collects and analyses statistics without touching campaign settings, bids or budgets.