Обновление

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 / VK Mini Apps нужно проверять через in-app события, custom events, 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 Ads по кампании 123456 за 1-28 апреля в колонке «Результат» вижу 20 подписок Senler. Проверь через API, где лежит эта метрика: in-app stats, base.goals, custom_event или goal statistics. Покажи цифры и объясни расхождение.

Агент последовательно проверит:

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 Ads события Senler или подписки в мини-приложениях. Покажи приложение, url_object_id, tracker.id, event.id, event.name и связанные кампании.

Для этого используются vk_get_mobile_apps и vk_get_inapp_events. В ответе будет видно, есть ли у аккаунта доступ к приложению и какие события доступны для статистики и оптимизации.

Пример 3: проверить, правильно ли настроена оптимизация

Для кампаний Mini Apps важно, чтобы группа оптимизировалась не просто на клики, а на нужное событие приложения.

Промпт

Проверь группу 987654: это Mini Apps пакет или нет? Если да, покажи package_priced_event_type, priced_goal и сравни priced_goal с событиями из vk_get_inapp_events.

Если 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 сразу.

Короткий чек-лист для клиента

Промпт

Проверь Mini Apps / Senler статистику по кампании 123456 за апрель. Сначала найди группы и priced_goal, потом события приложения, затем сравни in-app stats, base/custom_event и goal statistics. В конце дай вывод: совпадает ли с колонкой «Результат» в VK Ads и где именно лежит метрика.

Этого достаточно, чтобы ИИ-клиент не гадал по названию цели, а прошёл весь путь через реальные API-ресурсы VK Ads.

Документация обновлена

Список VK Ads инструментов и новый Mini Apps сценарий доступны в документации LidFly.

Открыть VK Ads docs