Плейбук: трафик карточек Ozon по SKU

Назначение

Собирать трафик каждой вариации товара Ozon отдельно: размер и цвет не смешиваются. Например, skirt-milk-s и skirt-milk-m — разные SKU и две строки для анализа цены, рекламы и заказов.

Проверенный источник

Источник — раздел кабинета продавца Аналитика → Графики в авторизованном Chrome-профиле магазина. При открытии страницы кабинет делает запрос:

POST /api/site/seller-analytics/charts/v3/table/by_sku

Это внутренний read-only API кабинета, работающий с сессией конкретного магазина. Для запроса требуется заголовок x-o3-company-id; его нужно брать из исходного запроса страницы в текущем браузерном сеансе, а не хранить в коде.

Публичный Seller API POST /v1/analytics/data для этих метрик использовать нельзя: 23 июня 2026 он ответил deprecated metrics used на session_view_pdp и hits_view_pdp.

Метрики

В ответе items[].productInfo идентифицирует строку, а items[].metrics содержит показатели.

Поле ответа	Что сохраняем
`productInfo.sku`	SKU Ozon — ключ связи с заказами
`productInfo.article`	Артикул/offer ID — ключ связи с ценами и рекламой
`searchViews`	Показы товара в поиске и каталоге
`pdpViews`	Просмотры (переходы) в карточку товара
`totalViews`	Все просмотры по определению кабинета Ozon; не считать простой суммой первых двух метрик
`convSearchViewsToPdp`	Конверсия из показа в поиске/каталоге в карточку, %
`hitsSearchToCart`, `hitsPdpToCart`, `totalHitsToCart`	Добавления в корзину по соответствующему источнику
`orderedUnits`	Заказанные единицы

Не подменять pdpViews рекламными кликами: реклама хранится отдельно в ozon_ad_metrics_daily и описывает только атрибутированный рекламный трафик.

Подтверждённый результат: Siluetta Ozon

23 июня 2026 через авторизованный профиль Siluetta получен штатный ответ кабинета за 16–22 июня 2026.

Артикул	SKU	Показы в поиске/каталоге	Просмотры карточки	Все просмотры
`skirt-milk-s`	4225228844	8 869	4 980	102 839
`skirt-milk-m`	4225230683	20 185	2 707	58 443
`ELS04-black-M`	2064323908	10 398	723	20 864
`ELS04-black-S`	2063072337	7 237	951	16 533

Следовательно, Premium кабинета Siluetta действительно открывает нужный трафик по SKU. Доступ проверен фактическим ответом интерфейса, а не только наличием подписки в профиле.

Ежедневный сбор

Однодневный запрос за 22 июня 2026 подтверждён: кабинет вернул 19 SKU, включая skirt-milk-s с 1 497 показами в поиске/каталоге и 793 просмотрами карточки. Ночной systemd-таймер запускается в 02:10 МСК и всегда собирает предыдущий московский календарный день.

Хранится строка на (traffic_date, shop_id, sku) с полями:

search_views, pdp_views, total_views,
conv_search_views_to_pdp, hits_search_to_cart,
hits_pdp_to_cart, total_hits_to_cart, ordered_units

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

В 09:00 МСК итог ночного трафика включается в общее Telegram-сообщение со статусом утреннего снимка цен. Отдельный ночной alert не отправляется.

Подключить подтверждённый магазин:

.venv/bin/python scripts/collect_ozon_sku_traffic.py \
  --configure-profile --shop-id <ID> --status ready

Использование в исследованиях

Цена → трафик: соединить дневной трафик с ozon_buyer_price_daily по магазину, артикулу и дате. Сравнивать pdp_views и конверсии при разных ценах, включая лаги 1–3 дня.
Реклама → трафик: соединить с ozon_ad_metrics_daily по магазину, артикулу и дате. Разделять общий трафик карточки и клики, атрибутированные рекламе.
Трафик → заказы: соединить с ozon_postings и ozon_posting_items по SKU/артикулу и дате заказа; не смешивать с датой доставки или выкупа.

Корреляция не доказывает причинность: на трафик одновременно влияют остатки, акции Ozon, позиция в поиске, рекламные кампании и сезонность.