Как ИИ управляет Яндекс.Директом через API: настройка кампаний из чата

Задача: перестать управлять рекламой руками

Клиент из онлайн-образования вёл контекстную рекламу в Яндекс.Директе классически: заходишь в интерфейс, смотришь статистику, где-то поднимаешь ставку, где-то добавляешь минус-слово, раз в неделю чистишь неэффективные ключи. Работает, но медленно — между «увидел проблему в отчёте» и «внёс правку в кампанию» проходят часы, а иногда дни, потому что руки до интерфейса доходят не сразу.

Я решил эту связку разорвать: вместо того чтобы кликать в интерфейсе Директа самому, я описываю задачу нейросети в чате — «отключи вот эти неэффективные группы», «подними ставку на автотаргетинг до минимума», «добавь эти минус-слова в такую-то кампанию» — а дальше скрипт с доступом на запись к API Директа применяет изменения напрямую к кампаниям. Никакого интерфейса между решением и результатом.

Как устроен пульт

Технически это Python-скрипт — я называю его «пульт» — с ключом доступа к API Яндекс.Директа. Он умеет читать и писать: получать статистику по кампаниям, группам и ключевым словам, менять ставки, добавлять и удалять минус-слова, включать и выключать группы объявлений. Я формулирую задачу на человеческом языке, нейросеть переводит её в конкретный набор изменений — какие ключи трогать, какие ставки ставить, — а скрипт исполняет эти изменения через API.

Разница с ручным управлением не в том, что стало «умнее», а в том, что исчезло звено интерфейса. Не нужно открывать Директ, искать нужную кампанию, кликать по вкладкам — решение сразу становится действием. Это особенно важно для рутинных, но частых операций: почистить список минус-слов, скорректировать ставки под сегодняшний CPA, отключить группу, которая слила бюджет за ночь.

Находки по ROMI: куда сливался бюджет

Первое, что дал такой режим работы — не скорость, а обзор. Когда у тебя есть скрипт, который может выгрузить статистику по всем ключам и группам разом, а не смотреть их по одной вкладке в интерфейсе, сразу видно закономерности, которые в интерфейсе Директа размазаны по десяткам экранов.

Анализ окупаемости (ROMI) по кампаниям клиента показал типичную картину: часть ключевых слов и групп объявлений стабильно давала клики и расход, но почти не давала окупаемых заявок. Деньги туда уходили по инерции — потому что кампания когда-то была настроена так, и никто её не пересматривал. Эти группы либо отключили полностью, либо урезали ставки почти до нуля, а освободившийся бюджет перераспределили на ключи и группы, которые реально окупались.

Само по себе это не новость для контекстной рекламы — «отключи то, что не окупается» звучит банально. Разница в том, что этот анализ и последующее действие занимают минуты, а не отдельный день ручной работы с выгрузками и вкладками Директа.

Три правила, на которых Директ ловит невнимательных

Работа через API заставляет формализовать логику, которую при ручном управлении держишь «на глаз». В процессе всплыли три конкретных правила — каждое стоило бы денег клиента, если бы его не учесть.

1. Автотаргетинг не трогать в ноль — задать ему 1 ₽. Автотаргетинг в Директе нельзя удалить полностью — это встроенный механизм, который система держит независимо от того, нравится он рекламодателю или нет. Бороться с этим бесполезно: попытка «выключить» автотаргетинг через API либо не пройдёт, либо вернётся с непонятным поведением кампании. Рабочая тактика — оставить его в структуре, но выставить минимальную ставку 1 ₽. Так автотаргетинг формально присутствует и не ломает кампанию, но не забирает показы и бюджет у управляемых ключевых слов.
2. Не дробить бренд на общие слова без проверки через Вордстат. Соблазн большой: взять брендовый запрос и «расширить» его до набора общих ключей, чтобы захватить больше трафика. Проблема в том, что бренд клиента пишется не одним способом — есть кириллица, есть транслит, есть варианты написания вподряд и через пробел. Если разбить брендовый запрос на общие слова, не проверив все варианты написания через Вордстат, часть тёплого и дешёвого брендового трафика уходит в общий, гораздо более дорогой аукцион. Итог — тот же самый пользователь, который искал бренд напрямую, обходится в разы дороже просто потому, что его запрос попал не в ту кампанию.
3. Минусовать «чужой» интент, не задевая общий. У клиента под одним брендом несколько направлений — условно, школа, колледж и вуз. По брендовым запросам они начинают конкурировать друг с другом в аукционе: показ по бренду забирает не то направление, которое искал пользователь. Решение — минус-слова, которые отсекают чужой интент («колледж» в кампании школы и наоборот), но при этом ни в коем случае не глушат общие уточнения вроде [поступить], [заочное], [после 9 класса] — эти слова нужны всем направлениям одинаково, и минусование по ним обрубает трафик себе же.

Результат и урок

Итог связки «нейросеть плюс API рекламной системы» — управление кампаниями клиента стало быстрее и точнее ручного: решение о ставке или минус-слове принимается и применяется сразу, без промежуточного захода в интерфейс. Бюджет, который раньше утекал на неокупаемые ключи и группы, теперь виден в анализе ROMI и перераспределяется в течение минут, а не недель.

Но главный урок не в скорости, а в том, что API не прощает поверхностных решений так же, как не прощает их и ручное управление — просто ошибки в коде масштабируются быстрее, чем ошибки одного клика. Автотаргетинг, который нельзя выключить, бренд, который пишется тремя способами, и несколько продуктов под одним именем, конкурирующих друг с другом — это не исключения, а типовые ловушки Директа, в которые попадает почти любой аккаунт с историей.

Автоматизация через API не отменяет знание платформы — она делает цену незнания выше и одновременно снижает цену исправления, если знание есть.

Практический вывод для любого, кто планирует управлять Директом через API, а не только руками в интерфейсе: прежде чем писать логику изменений, формализуйте именно такие правила — что нельзя убрать (автотаргетинг), что нельзя резать без проверки (варианты написания бренда через Вордстат) и что нельзя минусовать вслепую (общие уточнения при конкуренции направлений внутри бренда). Без этого API просто быстрее повторяет те же ошибки, что раньше делались руками.