Разбор · Опубликовали 08.10.2026
API Яндекс Директа выгружает расходы в базу компании, а агенты сверяют даты и рекламные кабинеты
Что заказать для загрузки расходов Директа в свою базу: кабинеты, валюты, даты, повтор без дублей и сигнал об остановке.
Текст подготовлен машиной агентов под надзором Евгения Шилова · факты проверены 8 октября 2026
Расходы нескольких кабинетов Яндекс Директа можно загружать в базу компании по API, но пропущенный кабинет или день сделает общий итог неверным.
При заказе такого загрузчика задайте правила сверки и приёмки: ниже они разобраны по документации Яндекса, клиентского кейса этой интеграции у нас нет.
Не хотите разбираться сами? Внедряем ИИ в ваш бизнес: задачи без лимита, одна цена в месяц, отмена в любой момент.
1. Расходы привязывают к кабинету и дате до подсчёта общего итога.
API заменяет ручную выгрузку. Сервис Reports отдаёт статистику таблицей. В примере Яндекса расход Cost связан с датой Date и номером кампании CampaignId.
Для запросов агентства Яндекс требует Client-Login, логин клиента. Загрузчик сохраняет, чей ответ получил: без этого расходы разных кабинетов смешаются.
Строка в базе показывает, чьи расходы и за какой день. Общий итог не выявит пропущенный кабинет. Пополнение баланса не заменяет расход Cost.
В базе остаются данные для сверки, а не только итоговая сумма.
пример Яндекса «Клики и стоимость», HTTP-заголовки API и денежные значения, проверены 08.10.2026. Состав записи в базе предложен редакцией для приёмки загрузчика.
2. Валюту, НДС и единицы суммы согласуют до первой сверки.
Основа суммы должна совпадать. Яндекс возвращает расход в валюте пользователя. Параметр IncludeVAT определяет, включён ли НДС.
Без returnMoneyInMicros: false денежное значение умножено на 1 000 000. С этим заголовком приходит сумма в валюте с двумя знаками после запятой.
Период и настройки сверки должны совпадать. Округление меняет сумму подробных строк; для общего итога Яндекс рекомендует отчёт без дополнительных группировок.
Сверка начинается с основы суммы.
Яндекс, «Вывод денежных значений» и «HTTP-заголовки» Reports, 08.10.2026. Допуск сверки определяют для конкретного отчёта, универсальный процент здесь не задан.
3. Вчерашний расход обновляют, когда Яндекс уточняет статистику.
Загрузить вчера и забыть недостаточно. У Яндекса стандартный период стабилизации составляет до трёх дней, но корректировки бывают и за более ранние даты.
Для ежедневной загрузки Яндекс предлагает AUTO: предыдущие три дня либо более ранний период при корректировке вчера. Границы отчёта сохраняют с результатом.
Повтор обновляет данные периода без дублей. Добавлять те же строки заново значит удвоить расход; менять только вчера значит пропустить старую корректировку.
Период отчёта определяет, какие данные обновить.
Яндекс, «Период отчёта» и «Как получить актуальную статистику», 08.10.2026. Последние два варианта описаны как альтернативные способы поддерживать данные в базе.
4. Неудачная выгрузка оставляет ошибку, а не нулевой расход.
Отчёт может быть ещё не готов. Ответ 201 означает очередь, 202 при повторном запросе означает продолжение формирования. Данные приходят с ответом 200.
Загрузчик повторяет тот же запрос через интервал retryIn из ответа. Ошибка доступа или обрыв ответа оставляют прежние данные с отметкой о неудаче.
Ноль принимают после успешной проверки отчёта за нужный кабинет и период. Отсутствие ответа или ожидаемых строк сначала разбирают как возможную ошибку.
Статус запроса определяет действие загрузчика.
Яндекс, «Онлайн- и офлайн-отчёт» и заголовки Reports, 08.10.2026. Проверка полноты и сохранение прежних данных предложены редакцией.
5. Агенты пишут загрузчик и проверки, инженер принимает результат.
ИИ-агенты нужны на этапе разработки. Они пишут загрузчик и тесты. По расписанию работает готовая программа, без ежедневного пересчёта расходов языковой моделью.
Начните с постановки задачи агенту: кабинеты, база и условия «готово». Инженер выбирает устройство загрузчика и сверяет результат с контрольным отчётом.
Наш опыт даёт машина на vibecoding.ru, а не внедрение Директа у клиента. Две её поломки показали, почему отсутствие данных нельзя принимать за ноль.
Две поломки машины дали правила для загрузчика.
23.07
Лента новостей молчала с 21 июля, а отметка прогресса двигалась при ошибках. Правило после: при неудаче прогресс не сдвигается, ошибка завершает запуск; отдельная проверка следит за публикацией.
02.09
Страница вакансий оборвалась при чтении, сборщик принял промах разбора за ноль. Правило после: перечитать источник, затем записать ошибку; проверка не выпускает резкое обнуление сигнала.
записи журналов машины от 23.07, 25.07 и 02.09.2026, сверены 08.10.2026. Это истории новостной ленты и замера рынка, не рекламной интеграции.
Название задачи не ограничивает права. OAuth-токен разрешает действия пользователя, в том числе управление рекламой. Чтение задают в коде и доступах.
В правилах для ИИ-агентов разрешите чтение и запретите менять ставки или кампании. Проверка запросов должна поймать команду изменения.
Урок «Руль, окно и сторож» в курсе по агентной разработке описывает это устройство: правило, видимый результат и проверку, которая зовёт при остановке.
Что и как мы проверяли
| Факт | Что известно | Проверено |
|---|---|---|
| API Директа | прочитаны официальные документы о Reports, суммах, датах, очереди и OAuth. Запросов к рекламным кабинетам не делали. | 2026-10-08 |
| Наш опыт | первичные записи двух поломок и описание урока проверены по датам. Клиентского кейса загрузчика Директа у нас нет. | 2026-10-08 |
| Цена | тариф «Один проект» сверён на живой странице /services 08.10.2026; это оплата месяца, не смета интеграции. | 2026-10-08 |
| Приёмка | таблицы описывают предлагаемые условия заказа. Это не результаты испытаний готового загрузчика. | 2026-10-08 |
6. Загрузчик принимают по сверке, повторному запуску и сигналу об остановке.
Одна выгрузка не закрывает задачу. Выберите кабинеты и контрольный период. Итог согласуйте с сотрудником, который сейчас готовит отчёт вручную.
Покажите сбой доступа: пропущенный кабинет виден, прежние расходы в базе. Так ответственность за ошибки ИИ связывается с проверкой результата программы.
Сигнал проверяет успешную запись в базу. Запущенный процесс ещё не доказывает получение данных. У предупреждения есть получатель и порядок восстановления.
Приёмка проверяет данные и отказ программы.
условия приёмки предложены редакцией на основе документов Яндекса и двух поломок нашей машины; 08.10.2026. До заказа согласуйте срок, после которого загрузка считается просроченной.
7. Подписка оплачивает поток разработки, а не одну выгрузку.
«Один проект» стоит 250 000 ₽ в месяц. Цена сверена на странице агентной разработки 8 октября 2026. Одна задача в работе, пауза в любой месяц.
Инженер ведёт машину агентов в вашем репозитории: чтение статистики и запись расходов с проверкой кабинетов, валют и дат. Задача не включает сквозную аналитику.
Для разовой выгрузки сравните экспорт и отдельную смету с месяцем разработки. Лицензии и комиссии сервисов считайте отдельно. Ставки и кампании загрузчик не меняет.
Перед оплатой согласуют результат и границы задачи.
условия /services на 08.10.2026; применение подписки к загрузчику и границы задачи заданы брифом статьи. Срок и стоимость одной интеграции не измерены.
Начать обсуждение можно со следующего шага для руководителя: этот адрес теперь ведёт на /services, где можно записаться на звонок.
8. Частые вопросы
Как получить API Яндекс Директа?+
Зарегистрировать приложение, подать заявку на доступ и получить OAuth-токен пользователя. Токен не доказывает доступ ко всем кабинетам: их проверяют отдельно.
Можно ли выгрузить расходы нескольких рекламных кабинетов?+
Да, если пользователь имеет доступ к ним. Для агентства запрос содержит Client-Login клиента. В базе расход связан с кабинетом и его валютой.
Агент каждый день получает расходы из Директа?+
В этой схеме агент пишет программу и проверки. Готовый загрузчик работает по расписанию; инженер участвует при изменениях и неисправностях.
Выгрузка расходов уже показывает прибыль от рекламы?+
Нет. Нужны данные о заказах и правила их связи с рекламой. Эта задача ограничена расходами Директа; сквозную аналитику согласуют отдельно.
Есть ли у вас готовый клиентский кейс такой интеграции?+
Нет. Здесь документы Яндекса и правила, проверенные на машине vibecoding.ru. Таблица приёмки задаёт условия будущего загрузчика, не результат внедрения.
Можно ли назвать цену и срок загрузчика до разговора?+
Нужны кабинеты, доступы, база, период истории и условия приёмки. 250 000 ₽ в месяц относится к тарифу разработки; смету этой интеграции согласуют отдельно.
Источники
- Яндекс, пример «Клики и стоимость», проверено 08.10.2026 — документация API
- Яндекс, заголовки API и Client-Login, проверено 08.10.2026 — документация API
- Яндекс, вывод денежных значений, проверено 08.10.2026 — документация API
- Яндекс, заголовки Reports, проверено 08.10.2026 — документация API
- Яндекс, период отчёта, проверено 08.10.2026 — документация API
- Яндекс, актуальная статистика, проверено 08.10.2026 — документация API
- Яндекс, онлайн- и офлайн-отчёт, проверено 08.10.2026 — документация API
- Яндекс, авторизационные токены, проверено 08.10.2026 — документация API
- Яндекс, начало работы с API, проверено 08.10.2026 — официальный курс
- Машина vibecoding.ru; истории 23.07 и 02.09 сверены по первичным записям 08.10.2026 — наш опыт
- Агентная разработка для бизнеса: условия подписки, проверено 08.10.2026 — наш сервис
- Курс «Агентная разработка», описание урока «Руль, окно и сторож», сверено 08.10.2026 — наш курс
Запомнить
- Принимайте расходы вместе с кабинетом, датой, валютой и настройкой НДС.
- Повторная загрузка должна обновлять период без удвоения сумм.
- Ошибка выгрузки сохраняет прежние данные с отметкой о неудаче.
- Проверяйте последнее успешное сохранение и доставку сигнала ответственному.
- Заказывайте загрузчик с условиями приёмки; месяц подписки не является ценой одной интеграции.