VK Mini Apps и Senler: ИИ теперь видит результаты из колонки «Результат»
Если в интерфейсе VK Ads у кампании есть 20 подписок в Senler, а API-агент раньше показывал ноль, причина почти всегда была в типе метрики. Мы добавили отдельную диагностику in-app событий и VK Mini Apps.
Какая была проблема
В VK Ads есть кампании с целью vk_miniapps: мини-приложения, подписки в Senler, события внутри приложения. В интерфейсе это часто выглядит просто как колонка «Результат»: 20, 12, 0.
Но в API это не обычная подписка VK. Метрика social_network.vk_subscribe означает подписку на пользователя ВК, а не подписку в Senler или событие мини-приложения. Поэтому агент мог искать не там и не видеть результат, который есть в рекламном кабинете.
Подписки в Senler нужны для рассылок. Отвечать подписчикам в личных сообщениях сообщества — другая задача, её решает ИИ-бот для группы ВК.
base.goals, base.vk.goals и goal statistics. Не через social_network.vk_subscribe.
Что добавили
| Инструмент | Что решает |
|---|---|
vk_get_mobile_apps |
Показывает подключённые приложения, доступы к статистике, url_object_id и связанные кампании. |
vk_get_inapp_events |
Находит трекеры и события: tracker.id, event.id, event.name. Это нужно для Senler и Mini Apps. |
vk_get_inapp_stats |
Показывает статистику in-app событий с totals, CPA, CR, ROMI и типом атрибуции. |
vk_get_statistics |
Теперь выводит base.goals, base.vk.goals, custom_event и events.opening_app. |
vk_get_ad_group |
Показывает package_priced_event_type и priced_goal, чтобы понять, по какому событию оптимизируется группа. |
В локальной документации VK Ads для Mini Apps важный маркер такой: priced_event_type=43. Это in-app события VK Mini Apps. Для оптимизации по событию priced_goal обычно собирается как source_id = tracker.id и name = event.name.
Пример 1: сверить Senler с интерфейсом VK Ads
Когда пользователь говорит: «в кабинете результат 20, а агент не показывает», теперь можно просить ИИ прямо так:
Агент последовательно проверит:
vk_get_ad_groupилиvk_get_ad_groups, чтобы увидеть пакет,priced_event_type=43иpriced_goal.vk_get_inapp_events, чтобы найти приложение, трекер и event name.vk_get_inapp_statsсconversion_type: "postclick,postview,total".vk_get_statisticsсmetrics: "base,custom_event".vk_get_goal_statistics, если VK отдал результат как цель.
Пример 2: найти событие мини-приложения
Раньше агенту было сложно понять, как называется событие в приложении и какой tracker ID использовать. Теперь это отдельный сценарий.
Для этого используются vk_get_mobile_apps и vk_get_inapp_events. В ответе будет видно, есть ли у аккаунта доступ к приложению и какие события доступны для статистики и оптимизации.
Пример 3: проверить, правильно ли настроена оптимизация
Для кампаний Mini Apps важно, чтобы группа оптимизировалась не просто на клики, а на нужное событие приложения.
Если package_priced_event_type равен 43, агент будет искать событие в vk_get_inapp_events. Если priced_goal пустой или ссылается не на тот event name, это уже причина для проверки настроек кампании.
Какие боли закрыли
- «В интерфейсе есть результат, в API нет». Теперь агент проверяет несколько мест, где VK может хранить результат: in-app, custom_event, base goals и goals.
- «Подписка в Senler не равна vk_subscribe». В подсказках инструментов это разделено явно, чтобы ИИ не путал метрики.
- «Не понимаю, какое событие привязано к кампании».
vk_get_inapp_eventsпоказывает app, tracker и event name. - «Нужно сверить totals с UI».
vk_get_inapp_statsвыводит общие totals и totals по объекту, а не только строки по дням. - «Сложно создать или проверить Mini Apps оптимизацию». В инструментах кампаний и групп теперь описан путь через
priced_event_type=43иpriced_goal.
conversion_type. Для сверки с UI часто полезно запросить postclick,postview,total сразу.
Короткий чек-лист для клиента
Этого достаточно, чтобы ИИ-клиент не гадал по названию цели, а прошёл весь путь через реальные API-ресурсы VK Ads.
Документация обновлена
Список VK Ads инструментов и новый Mini Apps сценарий доступны в документации LidFly.
Подключение VK Ads к Claude и ChatGPT