В учебном примере для ключевой фразы стоит ставка 40 ₽. Аукционные данные указывают на 70 ₽ для нужного объёма трафика. Потолок в 80 ₽ позволяет назначить 70 ₽, но есть ещё одно правило: за цикл ставка может вырасти максимум на 20%. Поэтому биддер предложит 48 ₽. В техническом задании (ТЗ) стоит заранее описать и это решение, и то, что делать, если Директ не ответит на запрос об изменении ставки.
Биддер здесь пока существует как ТЗ версии 0.1. Для статьи локально проверили несколько правил расчёта и смоделировали тайм-аут. К API Директа не подключались, реальные ставки не читали и не меняли.
Какие кампании можно отдать биддеру
По ТЗ первая версия управляет только ключевыми фразами в кампаниях с показами на поиске и ручными ставками. Если оператор переключает кампанию на автоматическую стратегию, сервис должен прекратить запись ставок для неё. Стратегию, бюджет и объявления оператор меняет отдельно.
Потолок 80 ₽ из примера ограничивает ставку, которую сервис отправит для фразы. У кампании свой бюджет, а на ставку в торгах могут влиять корректировки Директа. Сумма, которую спишут за клик, определяется в аукционе. Объём трафика в данных аукциона — относительный показатель, связанный с кликабельностью места показа. По нему одному нельзя посчитать, сколько кликов получит объявление.
Как ставка проходит через ограничения
В учебном наборе для объёма трафика 65 нужна ставка 40 ₽, для 85 — 70 ₽, для 100 — 110 ₽. Все числа условные. Потолок ставки — 80 ₽, максимальный рост за цикл — 20%, надбавка к аукционной ставке отключена.
| Условие | Что предложит расчёт | Почему |
|---|---|---|
| Текущая ставка 60 ₽, цель 85 | 70 ₽ | Ставка для нужной точки укладывается и в потолок, и в ограничение роста. |
| Текущая ставка 60 ₽, цель 100 | 70 ₽ | Для объёма 100 требуется 110 ₽. Под потолком доступна точка 85. |
| Текущая ставка 40 ₽, цель 85 | 48 ₽ | Нужны 70 ₽, а за один цикл к 40 ₽ можно прибавить максимум 8 ₽. |
| Текущая ставка 40 ₽, данные устарели | Оставить 40 ₽ | Для повышения нужны свежие данные. |
Для предложения 48 ₽ в этом наборе нет отдельной точки аукциона. Поэтому в журнале расчёта стоит показывать выбранную точку 85 отдельно от предлагаемой ставки 48 ₽. Иначе оператор может принять цель за прогноз.
В ТЗ 0.1 для фразы действует самый строгий из применимых потолков аккаунта, кампании, группы и самой фразы с учётом предела API. Укажите, кто задаёт эти значения, как долго данные считаются свежими и какие фразы остаются под ручным управлением. В режиме расчёта без отправки оператор должен увидеть текущую ставку, предложение и причину, по которой правило ограничило повышение или пропустило фразу.
Что делать, если ответ об изменении не пришёл
Допустим, сервис отправил запрос на изменение ставки с 40 до 48 ₽, а соединение оборвалось. Директ мог принять запрос до обрыва. По ТЗ сначала нужно прочитать текущую ставку, а уже затем решать, можно ли повторить запрос. В учебной имитации проверили четыре возможных исхода такого чтения.
| Какой результат имитировали | Что должен сделать сервис по ТЗ |
|---|---|
| В Директе стоит 48 ₽ | Подтвердить, что на момент чтения стоит нужное значение. |
| В Директе стоит 40 ₽ | Допустить ограниченный повтор после новой проверки стратегии, правил, свежести данных и ставки. |
| В Директе стоит 55 ₽ | Зафиксировать конфликт, приостановить управление этой фразой и передать решение оператору. |
| Ставку прочитать не удалось | Пометить результат как неизвестный и приостановить новые записи для этой фразы до сверки. |
При записи в Директ сервис должен сохранить в журнале фразу, прежнюю и предлагаемую ставки и причину изменения до отправки запроса. После отправки нужно разобрать ответ API по каждой фразе и сверить ставки повторным чтением. Даже после проверки перед записью оператор может успеть поменять ставку. Назначьте для пилота один основной инструмент записи и человека, который решит, когда возобновлять управление после конфликта.

Что согласовать до разработки
- Выберите одну поисковую кампанию с ручными ставками для пилота. Перечислите фразы, которыми сможет управлять сервис, и отметьте исключения.
- Зафиксируйте источник и срок свежести данных, потолок ставки, максимальный рост за цикл и условия, при которых запись пропускается или повторяется.
- Проверьте, что оператор может остановить новые записи и увидеть последние подтверждённые ставки. Остановка биддера оставляет назначенные ставки в Директе. Если нужно остановить показы, оператор делает это отдельно в кабинете.
Начните приёмку с расчёта без отправки. Попросите показать обычное повышение, срабатывание потолка и пропуск повышения на устаревших данных. Для тайм-аута проверьте, что имитация совпадения, расхождения или недоступного чтения даёт нужное решение из таблицы. Результат записи в Директе проверяют отдельно в пилоте. Изменение стоимости заявки оценивают по данным рекламы.
Условия пилота и критерии приёмки можно записать в шаблоне ТЗ на автоматизацию. Если сначала нужно понять, по каким запросам идут показы, начните с разбора поисковых запросов в Директе. Если уже выбрали кампанию, можно обсудить условия пилота.
