/yandex-direct

Управление бюджетами в Директе

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

• Что предложить перед запуском
• Как начать с небольшого бюджета
• Недельный бюджет кабинета
• Команды и поля бюджета кампании

Перед запуском новых кампаний

При каждом новом запуске предлагай проверить недельный лимит всего кабинета и установить его, если ограничения нет. Это защита от резкого нецелевого расхода: спрос может неожиданно измениться, а подбор запросов — охватить лишнюю аудиторию. Если лимит уже есть, оцени его вместе с расходами действующих и новых кампаний; заново включать или автоматически повышать его не нужно.

Объясни пользователю, какую сумму он готов допустить до обнаружения проблемы. Общий лимит относится ко всем кампаниям кабинета: его достижение может прервать и полезную рекламу. Поэтому сумму согласуют с учётом обычных расходов, месячного плана и допустимого риска. Остаток денег на счёте сам по себе не заменяет выбранное ограничение расходов.

Брендовая реклама может быть исключением, если пользователю важнее непрерывность показов. Но название бренда не гарантирует чистоту запросов. Предложи сначала подходящий общий лимит; вариант без него обсуждай как осознанный выбор с объяснением последствий. Уже известный отказ или согласованное исключение не нужно заново согласовывать при каждом запуске, пока условия не изменились.

Для новой кампании также задавай согласованный бюджет её стратегии. Если она входит в пакет, явно покажи, что сумма общая для нескольких кампаний. Предложение установить общий лимит не разрешает записать произвольное значение: используй поручение пользователя и известную сумму, иначе подготовь предложение. Правила записи и сравнения до/после — в CHANGES.md.

Какие ограничения за что отвечают

Бюджеты кампаний не складываются автоматически в лимит кабинета и не делятся между ними при его установке. Если общее ограничение мешает прибыльной рекламе, обсуди его изменение; не снимай его попутно с увеличением одной кампании.

От проверки трафика к рабочему бюджету

1. Согласуй небольшую сумму для первого этапа. Оцени ожидаемый объём по истории, прогнозу, региону и опыту пользователя. Пример расчёта: бюджет проверки ≈ ожидаемые клики × ожидаемый CPC. Это оценка для планирования, а не обещание числа кликов или строгого равномерного расхода.
2. Заранее договорись о первой проверке. Выбери срок или объём расходов, после которого нужно посмотреть результат; при быстром расходе проверь раньше. Маленький лимит должен позволять собрать полезные данные и соответствовать минимумам выбранной стратегии. Если подходящая сумма выше допустимого риска, обсуди другой вариант запуска, не повышай её молча.
3. Проверь качество трафика и расход. Посмотри реальные поисковые запросы, площадки, географию, устройства, CPC и темп расходов. Проверь, нет ли постороннего спроса и мусорных переходов. Эффективность оцени по выбранным пользователем ценным целям; малое число конверсий и задержка их появления ограничивают выводы. Команды и формулы — в REPORTS.md.
4. Увеличивай бюджет после понятного результата. Объясни, что показал первый этап, какую новую сумму предлагаешь и когда проверишь её эффект. При мусорном трафике сначала исправь подбор запросов или другие причины. Универсального процента увеличения нет; допустимый шаг зависит от экономики, спроса и риска.

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

Бюджет кампании от прибыльной траты

После проверки качества и эффективности трафика бюджет выбирают по тому, сколько реклама может прибыльно тратить. При оплате за конверсии ориентир рабочей недельной суммы — стоимость примерно 10–30 ценных конверсий: недельный бюджет ≈ целевая цена конверсии × плановое число конверсий. Этот ориентир не задаёт обязательный размер первого пробного запуска.

Число выбирается с пользователем по спросу и экономике. Не подставляйте ни бюджет, ни число 10–30 без объяснения применимости.

Недельный бюджет кабинета

На кабинете недельный лимит служит предохранителем от аномального расхода и выбирается относительно месячного бюджета. Пример исходной практики: при 220 000 ₽ в месяц — 50 000 ₽ в неделю на кабинет. Это пример, а не универсальный коэффициент; календарные месяцы и недели не совпадают.

Бюджеты кампаний при этом рассчитываются самостоятельно, от прибыльной траты. Их не подгоняют автоматически под предохранитель кабинета: сработает то ограничение, которое достигнуто первым. Недельный лимит общего счёта относится ко всем кампаниям одного логина; остаток денег на счёте — отдельное значение.

Как задать или изменить лимит:

python3 scripts/account_budget.py get --account example
python3 scripts/account_budget.py set --account example --weekly 49000
python3 scripts/account_budget.py clear --account example

get читает текущий лимит, set задаёт сумму за неделю, clear снимает ограничение. Без --apply изменение остаётся планом: команда показывает кабинет, счёт, валюту, «было — станет» и ссылку. Добавь --apply, если пользователь поручил выполнить эту правку. Команда проверяет, не изменилось ли исходное состояние, сохраняет его в журнал, записывает и перечитывает результат. Неудачную запись автоматически не повторяет. В --json поля before, planned и after содержат прежнее, запланированное и перечитанное значения; status сообщает результат проверки, accepted — подтверждён ли приём запроса API.

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

Путь и отображение текущей суммы описаны в гиде по интерфейсу.

Как недельная сумма связана с API:

Команда использует AccountManagement версии Live 4. Формула чтения: недельный лимит = AccountDayBudget.Amount × 7; для записи — AccountDayBudget.Amount = недельный лимит / 7. Сумма передаётся в валюте счёта, не в микроединицах. Ноль снимает ограничение; при чтении выключенного лимита API может вернуть null.

Связь проверена 11.09.2026 в рублёвом тестовом кабинете: запись Amount = 7000 дала 49 000 ₽ в неделю в интерфейсе, снятие вернуло null в API. Справка API пока называет это поле дневным и не описывает пересчёт. Это результат проверки одного кабинета, а не документированное обещание для всех аккаунтов. Если значение в интерфейсе расходится с расчётом, сначала выясни причину, затем продолжай изменения.

Повторная проверка — раз в три календарных месяца. Порядок, результаты и следующая дата ведутся в issue №170. На разрешённом тестовом кабинете сравни исходный AccountDayBudget.Amount именно с недельной суммой интерфейса: вывод команды get уже содержит наш пересчёт и сам по себе его не подтверждает. После опыта восстанови исходное состояние и проверь возврат, учитывая лимит числа изменений. Публично фиксируй дату, валюту, суммы и вывод; реальные логины, ID кабинетов и счетов, ссылки с ними, исходные журналы и необезличенные снимки экрана не публикуй.

Чтобы не превысить запрошенную сумму, команда округляет результат деления на семь вниз до двух знаков после запятой. Это выбранная точность команды, а не заявленное ограничение API. Например, запрос 50 000 ₽ даёт Amount = 7142.85 и итоговый лимит 49 999,95 ₽. Если суммы различаются, в плане показаны обе.

Что учесть до изменения:

• Для рублей минимум — 7000 ₽ в неделю. Команда получает MinimumAccountDailyBudget из справочника валют, переводит из микроединиц в валюту счёта и умножает на семь: минимум за неделю = MinimumAccountDailyBudget / 1 000 000 × 7.
• Расчёт идёт по московскому времени. Расписание кампании в другом часовом поясе может привести к перерасходу.
• В обычный день доступно до 35% недельного лимита общего счёта. В день изменения расход может быть выше. Правила расхода отдельной кампании в зависимости от её расписания описаны ниже.
• Уменьшение применяется со следующего дня; установка, увеличение и снятие — после активации настройки.
• При изменении суммы прежние траты не учитываются, новая сумма распределяется пропорционально оставшимся дням. Это не команда «оставить на этой неделе только N рублей». Например, 140 000 ₽, заданные в среду, дают в среднем 140 000 / 7 × 5 = 100 000 ₽ на оставшиеся дни, дополнительно к прежним тратам.
• API разрешает менять этот бюджет не более трёх раз в сутки. План без --apply лимит изменений не расходует.

Механика и актуальные ограничения: общий счёт. Поэтому недельное ограничение не заменяет контроль фактического расхода за календарный месяц.

Команды и поля бюджета кампании

Перед правкой прочитай кампанию и её стратегию: собственная она или пакетная, общий ли бюджет поиска и сетей, недельный ли он или на период. Сохраняй остальные настройки и цели. Поля по типам кампаний — в API_OBJECTS.md, варианты выбора стратегии — в PLAYBOOK.md.

python3 scripts/campaigns.py --account example
python3 scripts/campaign_write.py strategy --account example --campaign 123 --weekly-budget 3000

Вторая команда показывает план; для выполнения уже порученной правки добавь --apply. Это пример суммы, а не значение по умолчанию. При создании кампании тот же --weekly-budget передаётся в campaign_write.py create вместе с остальными настройками.

Флаг задаёт WeeklySpendLimit всем частям стратегии, у которых есть это поле. Если поиск и сети имеют отдельные бюджеты, одинаковая сумма попадёт в каждую часть, а не разделится между ними. Перед записью проверь итоговый план. У пакетной кампании бюджет меняется у стратегии и затрагивает все связанные кампании. Готовая команда пакетные стратегии не меняет: подготовь изменение через интерфейс по MANUAL_SETUP.md. Отвязывать кампанию ради этого не нужно.

Бюджет на период доступен не всем типам кампаний и стратегий. Не подставляй недельную сумму в поле периода и не передавай оба варианта бюджета одновременно. Для CustomPeriodBudget проверь автопродление: оно позволяет продолжить показы после конечной даты, пока сумма не израсходована. Если нужное поле не поддержано готовой командой, подготовь его изменение через интерфейс по MANUAL_SETUP.md, сохранив выбранную стратегию. Поддержка API сама по себе не означает поддержку команды --weekly-budget.

Как Директ распределяет бюджет кампании

При оплате за клики возможен перенос неиспользованного остатка прошлой недели, но не более 30% установленного недельного бюджета: расход отдельной недели может достигать 130% заданной суммы. Доля расхода за день зависит от расписания кампании: при одном дне показов возможен расход до 100%, при двух — до 50%, при трёх и более — до 35% суммы с переносом. Поэтому недельный бюджет кампании не равен ежедневному пределу бюджет / 7. К лимиту общего счёта перенос остатка не применяется. Недельный бюджет.

Для бюджета на период суточный ориентир динамический: оставшаяся сумма / оставшиеся дни показов; он может быть превышен на 30%. Даты, автопродление и текущие ограничения проверяй перед настройкой. Бюджет на период.

Недельный бюджет вместо DailyBudget

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