Интеграция Roistat с Wildberries¶
Закрытое бета-тестирование
Новая интеграция Wildberries проходит закрытое бета-тестирование и доступна ограниченному числу проектов. Эта инструкция предназначена для клиентов, которых уже подключили к тестированию. Если вы хотите принять участие, обратитесь к персональному менеджеру или в службу поддержки.
Интеграция Roistat с Wildberries позволит:
- Соединить данные по расходам и конверсиям из рекламных систем с данными по покупкам внутри маркетплейса.
- Анализировать эффективность привлечения внешнего трафика в магазин Wildberries.
Интеграция автоматически получает через API данные о внешнем трафике Wildberries. Загружать отчеты WB в Roistat вручную не нужно.
Как работает интеграция¶
- Команда Roistat заранее включает проект в закрытое бета-тестирование.
- В проекте Roistat вы добавляете интеграцию Wildberries и указываете ID поставщика.
- Вы создаете токен WB и сохраняете его в настройках интеграции в Roistat.
- Вы сопоставляете подменные артикулы Wildberries (WW-коды) с товарами и метками рекламных размещений.
- Roistat получает данные о внешнем трафике и показывает их в отчете «Аналитика внешнего трафика на маркетплейсах», в котором рассчитываются показатели эффективности продвижения магазина Wildberries на внешних платформах.
Также предусмотрена загрузка продаж, возвратов и сумм из WB. Во время бета-тестирования мы отдельно проверяем корректность связи финансовых показателей с подменными артикулами. Расходы используются из уже имеющихся данных Roistat.
Что подготовить¶
Перед подключением подготовьте:
- номер проекта Roistat и рекламный канал Wildberries;
- если рекламного канала WB еще нет — ID поставщика для его создания;
- доступ владельца к кабинету продавца Wildberries для создания токена;
- несколько WW-кодов, по которым уже есть внешний трафик, и соответствия кодов товарам и рекламным размещениям;
- отчет WB за выбранный период для сверки результатов во время бета-тестирования.
Подключение и настройка интеграции¶
-
В проекте Roistat откройте раздел Интеграции.

-
Нажмите «Добавить интеграцию», выберите Wildberries и нажмите «Добавить».

-
Укажите ID магазина Wildberries — это ID поставщика.

-
Создайте токен Wildberries.
В кабинете продавца WB откройте «Интеграции по API» → «Создать токен» → «Для интеграции вручную» → «Базовый токен».
Выберите категорию «Аналитика». Для загрузки финансовых показателей выберите также «Финансы». Уровень доступа — «Только чтение». При необходимости укажите название токена, например
Roistat.Подробная инструкция: как создать токен WB API.
Wildberries показывает токен только при создании. Скопируйте его и сохраните: если вы не сохранили токен, создайте новый.
-
В настройках рекламного канала Wildberries в Roistat вставьте токен в поле «Токен доступа Wildberries» и нажмите «Сохранить токен».
Roistat автоматически проверит подключение. Сохраненный токен не отображается в интерфейсе.
Не отправляйте токен менеджеру или в службу поддержки и не добавляйте его в CSV-файл.
Доступность данных зависит от подключенных услуг в кабинете Wildberries.

-
Сопоставьте WW-коды с товарами и размещениями.
Для каждого WW-кода укажите:
Столбец Что указать ww_codeПодменный артикул из раздела «Подменные артикулы» в кабинете WB. Если WW-кода еще нет, сначала создайте его в WB. nm_idЧисловой артикул товара WB, которому соответствует WW-код. Это не артикул продавца и не штрихкод. markerЗначение метки Roistat, соответствующее рекламному размещению. Одна строка сопоставления — один WW-код.
Для рекламы в Яндекс.Директе укажите значение метки Roistat, используемое в ссылке объявления.
Формат зависит от рекламного канала и типа кампании; см. раздел «Ручная разметка ссылок объявлений» в инструкции по Яндекс.Директу.
Для рекламы у блогера можно использовать ручную метку, например
blogger_ivanov.Если ссылка на размещение содержит
/?rs=blogger_ivanov, в столбецmarkerукажитеblogger_ivanov.Подробнее о метках Roistat — в статье «Разметка ссылок».
Добавление сопоставлений в интерфейсе¶
В блоке «Источники внешнего трафика» нажмите «Добавить источник». Для каждого WW-кода заполните поля ww_code, nm_id и marker. Добавьте отдельную строку для каждого WW-кода и нажмите «Сохранить источники».
Загрузка сопоставлений через CSV¶
Скачайте пустой CSV-шаблон сопоставлений. Не изменяйте заголовки столбцов.
Сохраните заполненный файл в формате CSV UTF-8 с разделителем-запятой.
В блоке «Источники внешнего трафика» нажмите «Загрузить из CSV» и подтвердите замену списка сопоставлений.
Загрузка CSV заменяет текущий список
После подтверждения загрузки CSV текущие сопоставления будут заменены списком из файла. Перед загрузкой проверьте, что в нем есть все нужные строки.
Возможности отчета «Аналитика внешнего трафика»¶
После подключения Wildberries или Ozon в разделе Аналитика → Отчеты → Стандартные отчеты доступен отчет «Аналитика внешнего трафика на маркетплейсах».

Можно использовать стандартный вариант отчета или создать отчет с собственными настройками. В правом верхнем углу доступны действия:
- — отредактировать отчет;
— клонировать отчет;
- — скачать отчет в Excel.
В отчете можно выбрать показатели и группировки. Доступны следующие группы показателей:
-
Показатели Roistat и рекламных площадок
- Визиты — количество посещений сайта с уникальным рекламным источником.
- Клики — количество переходов по объявлениям, которое автоматически передается из подключенного рекламного кабинета.
- Показы — количество показов рекламных объявлений.
- Расходы — маркетинговые расходы.
-
Показатели Wildberries
Показатели уточняются в рамках бета-тестирования
Состав и значения показателей Wildberries проверяются на реальных данных.
- Открытия карточек товаров — количество открытий карточек товаров.
- Заказано товаров в рамках сессии — количество товаров, заказанных после перехода по ссылке.
- Суммарная стоимость товаров, заказанных в рамках сессии — стоимость заказанных товаров с учетом скидок.
-
Расчетные показатели
Показатели уточняются в рамках бета-тестирования
Формулы и значения расчетных показателей проверяются на реальных данных.
- CTR — показатель кликабельности объявлений.
- CPC — средняя стоимость клика.
- Абсолютная конверсия в рамках сессии — доля заказанных товаров от общего числа визитов.
- Средняя стоимость заказанного товара — рассчитывается по формуле:
Расходы / Заказано товаров в рамках сессии. - ROMI — коэффициент возврата маркетинговых инвестиций, рассчитывается по формуле:
(Суммарная стоимость товаров в рамках сессии - Расходы) / Расходы * 100%.
Как пройдет закрытое бета-тестирование
После настройки мы запустим первый импорт. Вместе с вами сверим данные WB и Roistat за одинаковый период: WW-коды, открытия карточек, заказы, даты, продажи и возвраты.
Если заметите расхождения, сообщите нам период, WW-код и соответствующие данные из WB. Во время тестирования согласовывайте с нами изменения сопоставлений: ранее загруженная история автоматически не пересчитывается.
Это пилотная версия интеграции. До проверки на реальных данных мы не можем гарантировать полную корректность всех показателей. По итогам сверки и исправлений мы подготовим финальную инструкцию и расширим подключение.