svalmak.ruСергей Макаров

Биддер для Яндекс Директа: какие решения можно автоматизировать и где нужны ограничения

Ручка регулировки с красным механическим ограничителем
Иллюстрация к разбору ограничений ставки.

В учебном примере для ключевой фразы стоит ставка 40 ₽. Аукционные данные указывают на 70 ₽ для нужного объёма трафика. Потолок в 80 ₽ позволяет назначить 70 ₽, но есть ещё одно правило: за цикл ставка может вырасти максимум на 20%. Поэтому биддер предложит 48 ₽. В техническом задании (ТЗ) стоит заранее описать и это решение, и то, что делать, если Директ не ответит на запрос об изменении ставки.

Биддер здесь пока существует как ТЗ версии 0.1. Для статьи локально проверили несколько правил расчёта и смоделировали тайм-аут. К API Директа не подключались, реальные ставки не читали и не меняли.

Какие кампании можно отдать биддеру

По ТЗ первая версия управляет только ключевыми фразами в кампаниях с показами на поиске и ручными ставками. Если оператор переключает кампанию на автоматическую стратегию, сервис должен прекратить запись ставок для неё. Стратегию, бюджет и объявления оператор меняет отдельно.

Потолок 80 ₽ из примера ограничивает ставку, которую сервис отправит для фразы. У кампании свой бюджет, а на ставку в торгах могут влиять корректировки Директа. Сумма, которую спишут за клик, определяется в аукционе. Объём трафика в данных аукциона — относительный показатель, связанный с кликабельностью места показа. По нему одному нельзя посчитать, сколько кликов получит объявление.

Как ставка проходит через ограничения

В учебном наборе для объёма трафика 65 нужна ставка 40 ₽, для 85 — 70 ₽, для 100 — 110 ₽. Все числа условные. Потолок ставки — 80 ₽, максимальный рост за цикл — 20%, надбавка к аукционной ставке отключена.

УсловиеЧто предложит расчётПочему
Текущая ставка 60 ₽, цель 8570 ₽Ставка для нужной точки укладывается и в потолок, и в ограничение роста.
Текущая ставка 60 ₽, цель 10070 ₽Для объёма 100 требуется 110 ₽. Под потолком доступна точка 85.
Текущая ставка 40 ₽, цель 8548 ₽Нужны 70 ₽, а за один цикл к 40 ₽ можно прибавить максимум 8 ₽.
Текущая ставка 40 ₽, данные устарелиОставить 40 ₽Для повышения нужны свежие данные.

Для предложения 48 ₽ в этом наборе нет отдельной точки аукциона. Поэтому в журнале расчёта стоит показывать выбранную точку 85 отдельно от предлагаемой ставки 48 ₽. Иначе оператор может принять цель за прогноз.

В ТЗ 0.1 для фразы действует самый строгий из применимых потолков аккаунта, кампании, группы и самой фразы с учётом предела API. Укажите, кто задаёт эти значения, как долго данные считаются свежими и какие фразы остаются под ручным управлением. В режиме расчёта без отправки оператор должен увидеть текущую ставку, предложение и причину, по которой правило ограничило повышение или пропустило фразу.

Учебный расчёт: текущая ставка 40 рублей, нужная точка 70, предложение этого цикла 48 рублей.
Учебный пример. Шаг роста ограничивает предложение этого цикла.

Что делать, если ответ об изменении не пришёл

Допустим, сервис отправил запрос на изменение ставки с 40 до 48 ₽, а соединение оборвалось. Директ мог принять запрос до обрыва. По ТЗ сначала нужно прочитать текущую ставку, а уже затем решать, можно ли повторить запрос. В учебной имитации проверили четыре возможных исхода такого чтения.

Какой результат имитировалиЧто должен сделать сервис по ТЗ
В Директе стоит 48 ₽Подтвердить, что на момент чтения стоит нужное значение.
В Директе стоит 40 ₽Допустить ограниченный повтор после новой проверки стратегии, правил, свежести данных и ставки.
В Директе стоит 55 ₽Зафиксировать конфликт, приостановить управление этой фразой и передать решение оператору.
Ставку прочитать не удалосьПометить результат как неизвестный и приостановить новые записи для этой фразы до сверки.

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

Руки проверяют показание прибора рядом с отсоединённым кабелем
При обрыве связи сначала проверяют текущую ставку. Результат проверки определяет, можно ли повторить запись.

Что согласовать до разработки

  1. Выберите одну поисковую кампанию с ручными ставками для пилота. Перечислите фразы, которыми сможет управлять сервис, и отметьте исключения.
  2. Зафиксируйте источник и срок свежести данных, потолок ставки, максимальный рост за цикл и условия, при которых запись пропускается или повторяется.
  3. Проверьте, что оператор может остановить новые записи и увидеть последние подтверждённые ставки. Остановка биддера оставляет назначенные ставки в Директе. Если нужно остановить показы, оператор делает это отдельно в кабинете.

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

Условия пилота и критерии приёмки можно записать в шаблоне ТЗ на автоматизацию. Если сначала нужно понять, по каким запросам идут показы, начните с разбора поисковых запросов в Директе. Если уже выбрали кампанию, можно обсудить условия пилота.