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

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

Проверьте установку плагина и разрешения подключения в MCP → API токены. Если используется роль, проверьте её права в MCP → Роли. У каждого инструмента отдельное разрешение в группе «Яндекс.Директ». После изменения доступа заново запросите список инструментов в клиенте.

Что означает ошибка отсутствующего или неверного токена?

При незаполненном поле «OAuth-токен Яндекса» API-клиент не создаётся. token_invalid означает, что Яндекс отклонил сохранённый токен: он мог быть отозван или скопирован не полностью. Получите действующий токен и сохраните его в настройках плагина.

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

Проверьте, от имени какого представителя выдан OAuth-токен. Для агентства заполните «Логин рекламодателя» логином клиента; прямому рекламодателю поле нужно оставить пустым. Сверьте account.login в ответе direct_get_account. Разрешение инструмента в MCP не даёт владельцу токена новых прав в Яндексе.

Что делать с api_access_pending? Поможет ли песочница?

Для OAuth-приложения ещё не одобрена заявка на доступ к API Директа. Дождитесь одобрения Яндексом. Переключение «Песочница» этот отказ не устраняет.

Почему отчёт отвечает report_pending?

Директ формирует его в очереди. Повторите вызов с теми же аргументами после времени, указанного в retry_in. Повтор подхватит уже начатый отчёт. Для поисковых запросов используйте период в пределах последних 180 дней.

Почему в отчёте нет конверсий или расход не совпадает?

Для конверсий передайте номера целей в goals и проверьте модель attribution. Для расхода сравните период, кампании, настройку «НДС в суммах отчётов» и полноту страниц. totals считается по полученным строкам, поэтому ограниченная выдача не равна итогу по всему аккаунту. Автотаргетинг — отдельное условие показа; сумма только обычных ключевых фраз может не включать его расход.

Что делать с units_exhausted и network_error?

units_exhausted означает исчерпание суточных баллов API; сообщение плагина указывает обновление лимита в полночь по московскому времени. Дождитесь обновления и сократите ненужные вызовы. При network_error разработчику нужно проверить исходящий HTTPS с сервера Webasyst к API Директа. Для песочницы используется отдельный домен api-sandbox.direct.yandex.com.

Почему инструмент требует confirm_required?

Изменяющий вызов не получил confirm: true. Плагин не применил изменение. Сначала согласуйте с агентом объекты и новые значения, затем разрешите повтор с подтверждением. Параметр является проверкой вызова, а не встроенным окном согласования с человеком.

Почему ставка не изменилась или дневной бюджет выглядит иначе?

Проверьте стратегию кампании и strategy.manual_bids: при автоматической стратегии ручная ставка может быть отклонена или не применена Директом. Проверьте результат конкретного объекта и перечитайте данные. У кампаний с ручными ставками Директ может пересчитывать дневной бюджет в недельный по расписанию — инструмент предупреждает об этом в ответе.

Почему правка заголовка возвращает would_lose_variants?

У комбинаторного объявления несколько вариантов заголовков или текстов. Короткая запись уничтожила бы часть набора, и плагин её отклонил. Прочитайте объявление, подготовьте полный желаемый список titles или texts и согласуйте замену. Непереданные поля объявления не меняются.

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

direct_add_ads создаёт объявления без отправки на модерацию. Для первоначального запуска проверьте кампанию, оплату и модерацию в интерфейсе Директа. resume служит для возобновления показов и не заменяет эти шаги. Также проверьте, не включена ли «Песочница».

Можно ли отменить удаление или считать ok: true успехом всех правок?

Удаление через direct_delete_objects необратимо. Для временного прекращения показов используйте остановку или архив, где он поддерживается. У пакетных изменений и удалений часть объектов может получить отказ: читайте результаты каждого элемента, errors и warnings, затем проверяйте фактические данные инструментами чтения.