Синхронизация рекламных данных

Модуль ТЗ: 5.4 · Автобиддер

Что это

«Оптима» загружает из Wildberries ваши рекламные кампании, текущие ставки по товарам и статистику: показы, клики, заказы, расход и выручку с рекламы. На этих данных работают движок ставок, контроль бюджета, «Аналитика рекламы» и раздел «РНП».

Данные обновляются двумя путями:

• автоматически — раз в 5 минут по всем подключённым кабинетам;
• вручную — кнопкой «Синхронизировать с WB», когда свежие данные нужны сразу (например, сразу после подключения кабинета или после создания кампании в WB).

Где найти

Боковое меню → «Реклама» → «Автобиддер», кнопка «Синхронизировать с WB» в панели действий вверху страницы (/app/wb/<кабинет>/autobidder).

Как пользоваться

1. Выберите период в фильтре (7 или 30 дней). Ручная синхронизация загрузит статистику за столько же дней.
2. Нажмите «Синхронизировать с WB». Загрузка идёт в фоне, страницу можно не держать открытой. На кнопке виден этап: «Ставим в очередь…», «В очереди…», «Синхронизация…». Под кнопкой показывается пояснение: например, что задача ждёт окна лимита WB.
3. По окончании появится итог: «Синхронизация завершена: кампаний N, строк статистики M». Данные на странице обновятся.
4. Итог (успех или ошибка) придёт и в уведомления приложения тому, кто запустил синхронизацию: «Синхронизация рекламных кампаний».

Если по кабинету синхронизация уже идёт, повторное нажатие не запускает вторую. Вы увидите сообщение «Синхронизация этого кабинета уже выполняется. Ждём ту же задачу.» Если прошлая синхронизация завершилась ошибкой, кнопка запустит её заново.

Как обновляются данные

Как	Когда	Глубина статистики
Автоматически	раз в 5 минут, по всем подключённым кабинетам	1 последний день
Вручную	по кнопке	7 или 30 дней — по выбранному периоду (API допускает 1–31 день)

Что загружается за один прогон:

1. Список всех кампаний кабинета и их детали: название, статус, текущие ставки по артикулам.
2. Статистика по дням и артикулам для активных, приостановленных и завершённых кампаний.

Повторная загрузка не создаёт дублей: записи обновляются по кампании, дню и артикулу.

Ограничения

• Скорость задаёт Wildberries. Детальную статистику рекламы WB отдаёт не чаще одного запроса в 20 секунд. Кабинет с сотнями кампаний синхронизируется несколько минут.
• Повторы при перегрузке WB. Если WB отвечает «слишком много запросов» или временно недоступен, ручная синхронизация повторяется сама: до 5 попыток с паузами от 1 до 8 минут. Пока идёт ручная синхронизация, плановые загрузки этого кабинета ждут.
• Ошибки ключа не повторяются. Если API-ключ отозван или у него нет доступа к разделу «Продвижение», синхронизация сразу завершится с ошибкой. Обновите ключ в «Кабинетах Wildberries».
• Новые кампании приходят с выключенным автобиддером. Включите его в строке кампании — см. «Автобиддер».

Связанные страницы

• Автобиддер — обзор
• Аналитика рекламы
• Сбор рекламных данных для РНП — тот же автоматический сбор раз в 5 минут.
• Уведомления

Для интеграторов

• POST /autobidder/sync — тело { wbAccountId, days? } (1–31, по умолчанию 7). Ответ 202 с jobId и признаком alreadyRunning.
• GET /autobidder/sync/status/{jobId} — состояние pending / active / completed / failed, счётчики (summary), причина ошибки (error) и прогресс (progress).
• Очереди: autobidder-sync (ручной запуск), rnp-ads-sync (плановый, 5 минут).
• Справочник API, ADR-0025, ADR-0057.