Рекламный биддер: стратегии, бюджет и расчёт ставок

Зачем это нужно

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

Пример из работы магазина

Как начать

1. Подключите данные рекламы и агентский доступ operations.read, operations.plan, tasks.read.
2. Создайте или продолжите задачу рекламы в памяти. Согласуйте кампании, бюджет, цель и ограничения.
3. Проверьте automations.catalog и automations.credentials.requirements для advertising, затем прочитайте текущую конфигурацию.
4. Подготовьте профиль v2 сначала отключённым. После проверки отдельно включайте расчёт предложений и контролируйте историю.

Что вы получите

Решение по каждой кампании: удержать, предложить повышение/снижение ставки или защитную остановку, с причинами и ссылками на источники.

Что важно учитывать

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

Структура рекламного профиля

Один активный профиль advertising описывает набор campaign ID, стратегию и ограничения. Задача в памяти хранит цель бизнеса, профиль — её проверенную версию для расчёта, очередь — отдельные запуски, история — результаты. Создание профиля не создаёт кампанию Wildberries.

Какие данные читает биддер

Наличие поля в модели не гарантирует, что источник умеет заполнить его для каждой кампании. Если нет дневного расхода, запаса, конца атрибуции или минимума ставки, оптимизация может остаться заблокированной.

Настройки стратегии и бюджета

Как рассчитывается ставка

1. Проверяются профиль, ручная остановка, незавершённая команда и внешние изменения.
2. Проверяются рабочее окно, запас и дневной бюджет; при подтверждённых условиях может появиться защитное предложение pause.
3. Для оптимизации требуются активная подходящая кампания, свежие и полные данные, законченная пауза, достаточная выборка и созревшая атрибуция.
4. Стратегия fixed выбирает заданную целевую ставку. target_drr делит spend_rub на attributed_revenue_rub.
5. Если ДРР выше диапазона допуска — направление вниз, ниже — вверх; внутри — удержание. При нулевой выручке ДРР неопределён и ставка удерживается.
6. Желаемая ставка пересекается с шагом, минимумом платформы, коридором и экономическим потолком. Если допустимого решения нет, сохраняется причина отказа.

Учебный пример: ставка 1000 копеек, шаг 10%, целевой ДРР 0.18, допуск 0.1. При ДРР 0.25 желаемая ставка — 900 копеек. Если минимум платформы 950, допустимое предложение может стать 950. Если безопасное пересечение отсутствует, ставка не выбирается «примерно». Пример действует только при пройденных остальных проверках и не является настройкой магазина.

CTR, CPC, CPO и конверсия доступны в аналитике, но не становятся автоматически стратегиями биддера v2. Стратегии по позиции, поисковым кластерам, портфелю, прибыли и расходу без заказов требуют отдельной реализации.

Полный учебный профиль биддера

Шаблон отключён и содержит вымышленные идентификаторы, ссылки и суммы. Он показывает структуру, а не настройки вашего магазина. Замените их на согласованные условия и действительные версии памяти; выберите реальный срок действия. Не включайте пример как готовую конфигурацию.

{
  "schema_version": 1,
  "config_id": "advertising-task-bound-v2",
  "mode": "shadow",
  "interval_seconds": 60,
  "bid_unit": "kopecks",
  "decision_basis": "wb_attributed_revenue",
  "policy_confirmed": false,
  "target_ids": [],
  "guardrails": {
    "max_snapshot_age_seconds": 300,
    "max_actions_per_cycle": 5,
    "min_bid_kopecks": 100,
    "max_bid_kopecks": 250000,
    "max_step_percent": 10,
    "cooldown_seconds": 1800,
    "min_stock_cover_days": 7,
    "min_clicks": 30,
    "min_spend_rub": 100
  },
  "rules": [],
  "expected_config_sha256": "",
  "source_binding": {
    "card_id": "00000000-0000-0000-0000-000000000001",
    "card_version": 1
  },
  "bidder": {
    "version": 2,
    "enabled": false,
    "strategy": "target_drr",
    "target_drr": "0.18",
    "deadband": "0.1",
    "schedule": {
      "timezone": "Europe/Moscow",
      "windows": [
        {
          "days": [
            0,
            1,
            2,
            3,
            4,
            5,
            6
          ],
          "start_minute": 0,
          "end_minute": 1440
        }
      ]
    },
    "daily_budget_kopecks": 100000,
    "budget_reserve_kopecks": 10000,
    "require_stock": true,
    "attribution_lag_seconds": 172800,
    "economic_bid_cap_kopecks": 1000
  }
}

• Опубликованный шаблон для скачивания

Три разных понятия времени и бюджета

Дни: понедельник 0, воскресенье 6. Минуты: 0–1440. Ночное окно разделите у полуночи, например 22:00–24:00 и 00:00–06:00. IANA timezone, например Europe/Moscow, задаётся явно. Даже наличие окна не означает, что WB физически остановит рекламу: текущий результат — предложение.

Создание, проверка, обновление и отключение

{
  "domain": "advertising"
}

1. Прочитайте задачу через tasks.resume и возьмите реальную card_version.
2. Заполните профиль v2 по шаблону: кампании, цели, лимиты и source_binding. При создании expected_config_sha256 — пустая строка, при обновлении — текущая сумма.
3. Передайте весь профиль в automations.config.apply с domain=advertising. Не возвращайте служебные received_at/config_sha256 как часть пользовательского config.
4. Проверьте сохранённую версию. Отключённый профиль даёт profile_disabled. Для проверки предложений требуется осознанно включить enabled=true; это также запускает периодические расчёты.
5. Читайте jobs.get для результата конкретного запуска, runs.list для истории и сравнивайте config hash.
6. Для отключения сохраните новую версию enabled=false. Для удаления используйте lifecycle_action=delete с текущим hash и source_binding. История остаётся.

{
  "domain": "advertising",
  "idempotency_key": "guide-bidder-run-001"
}

Удаление или отключение профиля X-MP не останавливает кампанию Wildberries. Независимая аварийная остановка не снимается изменением профиля. При конфликте версии перечитайте состояние и согласуйте новую конфигурацию.

Как читать причины решения

Методы и параметры

Параметры ниже относятся к MCP arguments. Идентичность и ключ не передаются в них. Для полного объекта config следуйте руководству домена.

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "enum": [
        "advertising",
        "advertising-budget",
        "card-experiment",
        "catalog",
        "custom",
        "inventory-fbs",
        "pricing",
        "reputation",
        "supplies"
      ]
    }
  }
}

{
  "type": "object",
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "enum": [
        "advertising",
        "pricing",
        "catalog",
        "responder"
      ]
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain",
    "config",
    "idempotency_key"
  ],
  "properties": {
    "domain": {
      "enum": [
        "advertising",
        "pricing",
        "catalog",
        "responder"
      ]
    },
    "config": {
      "type": "object",
      "minProperties": 1
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain",
    "idempotency_key"
  ],
  "properties": {
    "domain": {
      "enum": [
        "advertising",
        "pricing",
        "catalog",
        "responder"
      ]
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain",
    "idempotency_key"
  ],
  "properties": {
    "domain": {
      "enum": [
        "advertising",
        "pricing",
        "catalog",
        "responder"
      ]
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{7,127}$"
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "format": "uuid"
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "enum": [
        "advertising",
        "pricing",
        "catalog",
        "responder"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "reason"
  ],
  "properties": {
    "reason": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  }
}

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "card_id"
  ],
  "properties": {
    "card_id": {
      "type": "string",
      "format": "uuid"
    }
  }
}

Связанные возможности

Рекламный биддер

Выбирать, где и как изменить рекламные расходы

Без изменения ставок. Работает анализ и подготовка предложений. Автоматическое исполнение не включено.