Аналитика продавца CSV

Работа с CSV-отчётами Аналитики продавца

Специализированные CSV-отчёты Аналитика продавца CSV предназначены для выгрузки больших объёмов данных за длительные периоды.

Тип отчёта вы можете выбрать в зависимости от вашей бизнес-задачи. Каждый из отчётов имеет свои особенности, глубину данных и сценарии использования.

---

Типы CSV-отчётов Аналитики продавца

---

Воронка продаж

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

• DETAIL_HISTORY_REPORT — детализированные данные по каждому артикулу
• GROUPED_HISTORY_REPORT — агрегированная статистика по предметам, брендам, ярлыкам

Об API Воронки продаж читайте в инструкции:

• Воронка продаж

---

Поисковые запросы по вашим товарам

Отчёты по Поисковым запросам по вашим товарам показывают, как покупатели находят ваши товары: по каким ключевым фразам, в каких категориях и как часто.

• SEARCH_QUERIES_PREMIUM_REPORT_PRODUCT — детализированные данные по параметрам поиска по каждому артикулу
• SEARCH_QUERIES_PREMIUM_REPORT_GROUP — агрегированная статистика по параметрам поиска по предметам, брендам, ярлыкам
• SEARCH_QUERIES_PREMIUM_REPORT_TEXT — данные по текстам поисковых запросов (семантическое ядро)

Об API Поисковых запросов по вашим товарам читайте в инструкции:

• Поисковые запросы по вашим товарам

---

История остатков

Отчёты по Истории остатков предоставляют данные о том, на каких складах WB и продавца и в каком количестве хранятся ваши товары, насколько ваши товары востребованы у покупателей и как скоро остатки товаров закончатся на складах.

• STOCK_HISTORY_REPORT_CSV — статистика остатков
• STOCK_HISTORY_DAILY_CSV — история остатков по дням

---

Получение CSV-отчётов

Чтобы получить любой CSV-отчёт, соблюдайте порядок действий:

Шаг 1. Создайте задание на генерацию

Выполните запрос метода POST /api/v2/nm-report/downloads. В теле запроса укажите:

• UUID отчёта
• тип — например, SEARCH_QUERIES_PREMIUM_REPORT_GROUP
• период
• уровень детализации
• фильтры

Шаг 2. Проверьте статус готовности

Отчёт формируется не сразу. Чтобы проверить статус генерации отчёта, используйте метод GET /api/v2/nm-report/downloads.

Когда статус сменится на SUCCESS, отчёт будет готов. Файлы хранятся 48 часов.

Шаг 3. Скачайте готовый отчёт

Готовый CSV-отчёт будет сгенерирован в ZIP-архив. Скачайте его с помощью метода GET /api/v2/nm-report/downloads/file/{downloadId}.

---

Как фильтровать данные

Методы для работы с CSV-отчётами собирают статистику по всем товарам продавца. В зависимости от задачи вы можете настроить выгрузку данных с помощью фильтров:

• currentPeriod (в отчётах по Воронке продаж — startDate и endDate) и pastPeriod (только в отчётах по Поисковым запросам по вашим товарам) — запрашиваемый период и период для сравнения. Вы можете задать произвольный интервал в пределах доступных дат.
  Как можно использовать: сравнить продажи в периоды до, во время и после рекламной кампании.
• nmIds — артикулы WB — отбор по конкретным товарам из вашего каталога.
  Как можно использовать: вы расширили ассортиментную линейку и хотите оценить влияние новинок на основной товар.
• brandNames — бренды товаров.
  Как можно использовать: сравнить сумму заказов и количество выкупов по бренду до и после вывода новой линейки. Так вы сможете оценить, как расширение ассортимента повлияло на оборачиваемость товаров.
• subjectIds — предметы по классификации Wildberries.
  Как можно использовать: сравнить конверсию в корзину в различных категориях. Так вы сможете решить, на какую категорию направить рекламный бюджет.
• tagIds — ярлыки продавца, которые можно указать в карточке товара.
  Как можно использовать: у вас есть товары с ярлыком Архив, которые вы планируете распродать. С помощью фильтра вы можете проанализировать, насколько ещё активен спрос на эти товары, и понять, стоит ли запускать по ним акции.
• skipDeletedNm — скрыть удалённые товары.

---

Полезные ссылки в справочном центре:

• Отчёт Воронка продаж
• Отчёт Поисковые запросы: ваши товары
• Отчёт История остатков
• Подписка Джем