Октябрьская авария показала неприятную вещь: когда веб-кабинет Директа недоступен, рекламодатель остаётся без всего. Он не видит расход, не может остановить кампанию, не может пополнить счёт. При этом реклама продолжает тратить деньги.
У этой проблемы есть частичное решение, о котором мало кто думает заранее. Веб-интерфейс и API это разные входы в одну систему, и падают они не всегда вместе.
Что такое API Директа простыми словами
Веб-кабинет это сайт, который вы открываете в браузере. Он сам обращается к серверам Яндекса, получает данные и рисует таблицы. API это тот же доступ к данным, только без картинки: запрос отправляет программа, в ответ приходят цифры.
Когда сайт кабинета не открывается, причина может быть в самом интерфейсе, а не в данных. Тогда запрос к API проходит.
Так было в октябре. У нас в дни недоступности кабинета часть операций через API отвечала, когда интерфейс не открывался вовсе. Работало неровно, с ошибками и таймаутами, но отчёты удавалось забирать.
Что можно делать через API, когда кабинет лежит
Смотреть расход. Отчёты по кампаниям, дням, площадкам, устройствам. Это главное: вы хотя бы знаете, сколько тратится.
Останавливать кампании. Операция остановки через API отдельная от интерфейса.
Менять ставки и дневные лимиты. Чтобы ограничить расход, не останавливая рекламу полностью.
Добавлять минус-слова и запрещённые площадки. То есть экономить бюджет прямо во время сбоя.
Забирать структуру кампаний. Фразы, объявления, настройки. Это нужно, если вы собираетесь поднимать резервную кампанию на другой площадке.
Важная оговорка: если повреждена инфраструктура, которая отвечает за данные, API тоже будет возвращать ошибки. Это не волшебный обходной путь, а второй вход, который иногда открыт, когда первый закрыт.
Что сейчас работает, а что нет
На момент публикации статьи:
| Сервис | Состояние |
|---|---|
| API Яндекс Директа | Работает штатно |
| Веб-кабинет Директа | Работает, отдельные ограничения сохранялись после аварии |
| API Вордстата | Недоступен: адрес не отвечает |
| Отчёты Вордстата в старом API Директа | Сняты |
То есть ровно наоборот тому, что было в начале месяца: управление рекламой через API доступно, а автоматический сбор частотности запросов сейчас невозможен. Частотность смотрят руками в интерфейсе Вордстата.
Мы проверяем доступность на каждом запросе, и как только адрес Вордстата оживёт, сбор частотности вернётся сам.
Как получить доступ к API
Путей два.
Свой доступ. Нужно зарегистрировать OAuth-приложение, подать заявку на доступ к API в интерфейсе Директа, дождаться одобрения и написать код. Подробно порядок описан в статье про доступ к API Яндекс Директа. Вариант для тех, у кого есть разработчик.
Через готовый сервис. Коннектор AdCab подключает Директ к Claude или ChatGPT: вы входите через Яндекс и спрашиваете обычными словами. Заявку на API подавать не нужно, код писать тоже. Один рекламный аккаунт бесплатно.
Второй путь имеет смысл настроить заранее, а не в день аварии: чтобы вход через Яндекс сработал, кабинет должен быть доступен хотя бы в момент подключения.
Что спросить у ИИ во время сбоя
Короткий список команд, которые закрывают первую необходимость:
- «Покажи расход по всем кампаниям за сегодня и вчера по часам». Это показывает скорость траты.
- «Поставь дневной лимит 1000 рублей на все активные кампании». Так ограничивается ущерб.
- «Останови кампании, у которых за три дня нет конверсий». Точечная остановка вместо полной.
- «Выгрузи фразы и объявления кампании N». Структура понадобится для резервной площадки.
- «Какие площадки РСЯ потратили больше 500 рублей за сутки без заявок». Срезать слив, пока управление доступно.
Каждое изменение в коннекторе сначала становится черновиком с таблицей «было и станет», а в Директ уходит только после подтверждения. В нервной ситуации это скорее плюс: случайная формулировка не превратится в массовую правку.
Чего API не умеет
Ограничения, о которых стоит знать заранее.
Не обходит падение данных. Если лежит хранилище статистики, отчёт не построится ни в интерфейсе, ни через API.
Не отменяет списания. Остановить показы можно, вернуть потраченное нельзя. Это только через поддержку.
Не заменяет Мастер кампаний. Часть настроек автоматических кампаний через API недоступна. Подробности в разборе чего нельзя сделать через API Директа.
Тратит баллы. У каждого аккаунта суточный лимит операций, и тяжёлые отчёты расходуют его быстро.
Что сделать до следующего сбоя
Три действия, каждое занимает меньше часа.
Проверьте, есть ли у вас доступ к API сейчас. Не в теории, а практически: запросите список кампаний. Если доступа нет, настройте его сегодня, пока кабинет открыт.
Сохраните структуру кампаний в файл. Фразы, объявления, минус-слова, запрещённые площадки. Это и резервная копия, и заготовка для переноса на другую площадку.
Пропишите порядок действий на случай недоступности. Кто смотрит расход, по какому порогу ставим лимиты, в какой момент поднимаем резервную кампанию. В момент аварии думать об этом поздно.
Коротко
- Веб-кабинет и API это разные входы, и они падают не одновременно.
- Через API доступны отчёты, остановка кампаний, лимиты, минус-слова и выгрузка структуры.
- Сейчас API Директа работает, а API Вордстата недоступен: семантику собирают руками.
- Доступ нужно настроить заранее: в день аварии подключиться будет не к чему.