Частые вопросы

Плагин отвечает not_configured. Что заполнить?

В MCP → Плагины → VK Реклама для MCP заполните ID клиента API (client_id) и Секрет клиента API (client_secret). Оба значения должны быть непустыми. Их получают в кабинете ads.vk.com, в разделе Настройки → Доступ к API, после одобрения заявки.

Почему агент не видит нужного инструмента?

Проверьте разрешения выданного ему токена MCP в разделе VK Реклама. Каждый инструмент регистрирует собственное право. После изменения доступа обновите список инструментов в клиенте. Также проверьте, что установлен плагин и версия MCP соответствует требованиям.

Как подключить кабинет клиента агентства?

Внесите логин клиента в Логин клиента агентства и сохраните настройки. Для своего кабинета оставьте поле пустым. Проверяйте выбранный аккаунт через vkads_get_account. Инструмент списка клиентов требует агентского доступа VK; обычному кабинету он может быть недоступен.

Нужно ли вручную обновлять токен VK или запускать cron?

Нет. Плагин получает и обновляет токены при вызовах API, используя сохранённые ID и секрет клиента. Собственного cron нет. При смене реквизитов ранее сохранённые токены перестают использоваться. При auth_busy повторите запрос через несколько секунд, при lock_failed попросите разработчика проверить права записи в каталог, указанный в ошибке.

Почему возвращается confirm_required вместо изменения?

Это предпросмотр. Агент должен показать preview и повторить запрос с confirm=true после вашего согласия. force=true разрешает превышение процентного порога сумм и не заменяет подтверждение. Загрузка изображения — отдельное действие без confirm.

Почему бюджет или ставка не принимаются?

bad_step означает, что бюджет не кратен шагу кабинета; ближайшие значения возвращаются в ответе. change_too_large означает превышение Предела изменения бюджета и ставки, %. both_budgets означает одновременно заданные дневной и общий положительные лимиты. Для ставки требуется положительная сумма. Подробности — в статье «Изменения кабинета».

Почему изменение ставки касается всех групп кампании?

При автостратегии инструмент меняет max_price. Если бюджет задан на уровне кампании, код переносит изменение предельной цены на кампанию. Это затрагивает все её группы; область действия показана в applies_to и note предпросмотра.

Почему объявление не создаётся с ord_data_required?

Проверьте данные ОРД через vkads_get_ord_profile: может отсутствовать название рекламодателя, даже если профиль «VK для бизнеса» подтверждён. Рекламодатель должен сообщить корректное ФИО или название организации. vkads_set_ord_profile записывает название, сайт и телефон с подтверждением; ИНН не меняется. После исправления повторите создание.

Почему нет показов после создания или запуска?

Новые объекты создаются остановленными. Запуск — отдельная подтверждённая операция. Проверьте статусы кампании, группы и объявления, затем уведомления через vkads_get_notifications и модерацию через vkads_get_ads. Даже active не гарантирует показов при ограничениях VK или незавершённой модерации.

Почему статистика не включает сегодня или показывает пустые цели?

По умолчанию отчёт охватывает семь завершившихся дней. Для текущего дня используйте vkads_get_today_spend и смотрите свежесть данных. Пустые цели могут означать отсутствие пикселя, его целей или конверсий; проверьте vkads_get_pixels с with_goals=true. Показатели null нельзя автоматически считать нулями.

Почему не загружается картинка по ссылке?

Нужен прямой публичный HTTP/HTTPS-адрес JPG или PNG до 5 МБ. Плагин не следует редиректам и отклоняет внутренние адреса. Можно передать содержимое файла через image_base64 вместо ссылки. Плагин определяет размер, но не изменяет его; подготовьте нужный формат до загрузки.

Можно ли восстановить удалённую кампанию или повторить запись после ошибки связи?

Инструмента восстановления нет: удаление необратимо. Если нужно только приостановить показы, используйте blocked. После ошибки связи при записи сначала перечитайте кабинет: действие могло выполниться, даже если агент не получил результат. При массовой операции проверяйте каждую строку ответа.