MarkerViewДокументацияМаркетплейсы
Разделы документации

Маркетплейсы

Магазин, каталог и артикулы

Как связать отзывы с нужными товарами, обновить каталог и проверить варианты товара.

Каталог связывает адрес каждой карточки вашего магазина с артикулом продавца. Без этого виджет может получить отзывы из маркетплейса, но не понять, на какой странице сайта их показать. В облачной версии каталог настраивается и обновляется в интерфейсе MarkerView — терминал не нужен.

Указать магазин и sitemap

  1. В MarkerView откройте Настройки.
  2. В блоке Магазин и каталог укажите Адрес магазина (origin · CORS), например https://ваш-магазин.ру. Это схема и домен без пути к товару.
  3. Если карта сайта доступна по стандартному адресу /sitemap.xml, поле Адрес sitemap (необязательно) можно оставить пустым.
  4. Если каталог опубликован по другому адресу, вставьте полный URL, например https://ваш-магазин.ру/catalog-sitemap.xml.
  5. Сохраните настройки.

Адрес магазина также разрешает сайту загружать виджет; вариант домена с www разрешается автоматически. Sitemap должна открываться по HTTPS без входа и содержать актуальные страницы товаров. MarkerView выбирает из неё URL с путём /products/, открывает эти страницы и ищет указанный на странице SKU или «Артикул».

Запустить обновление

  1. Откройте Маркетплейсы и найдите блок Каталог товаров → Товары вашего магазина.
  2. Нажмите Обновить каталог для обычного обновления. MarkerView читает карту сайта и обходит только новые страницы, сохраняя уже известные.
  3. Следите за статусом: сначала «читаем карту сайта», затем «N из M новых товаров».
  4. Дождитесь состояния «Обновлён». В результате показаны число найденных товаров и число артикулов, для которых есть отзывы.

Кнопка Пересканировать полностью повторно открывает все страницы товаров. Она нужна после массовой смены артикулов, шаблона карточек или адресов. Полный обход дольше обычного; не запускайте его после каждого добавленного товара.

Как сопоставляются артикулы

MarkerView сравнивает артикул на сайте с артикулом продавца из маркетплейса:

  • Wildberries передаёт артикул поставщика;
  • Яндекс Маркет — offerId предложения;
  • Ozon в отзыве передаёт внутренний SKU, поэтому MarkerView дополнительно читает каталог Ozon и переводит его в ваш offer_id. Ключу Ozon нужен доступ к товарам.

Регистр, разделители и суффиксы вариантов могут отличаться. MarkerView нормализует известные обозначения цвета и размера и может связать вариант вроде 3467/Белый с базовым артикулом 3467, если такой артикул найден в каталоге сайта. Несколько страниц вариантов могут иметь один артикул — каждая страница сохраняется, чтобы виджет работал на любом её URL.

Это не исправляет произвольные расхождения. Например, если на сайте указан DRESS-42, а в маркетплейсе — 104587, без общего артикула автоматическое сопоставление невозможно. Приведите offer/SKU в системе управления магазином и маркетплейсе к одному значению, затем полностью пересканируйте каталог и снова синхронизируйте источник.

Состояния и ошибки

  • «Ожидание запуска» — обновление ещё не запускали или нет результата текущего запуска.
  • «Обновляется» — задача идёт в фоне; повторная кнопка не ускорит её.
  • «Ошибка обновления» — прочитайте текст рядом со статусом. Проверьте, что URL sitemap открывается публично, отдаёт XML и содержит адреса /products/.
  • Товаров 0 — чаще всего в sitemap нет подходящих URL либо страницы закрыты от внешнего доступа.
  • Товар найден, но артикулов с отзывами мало — сравните артикулы сайта с данными маркетплейса; для Ozon также исправьте предупреждение о доступе к товарам в карточке источника.
  • Новые товары не появились — нажмите обычное Обновить каталог. Если изменились уже существующие страницы, используйте полное сканирование.
  • Удалённые из sitemap URL убираются из каталога при обновлении.

После успешного обновления откройте реальную карточку товара и проверьте виджет по инструкции для вашей платформы в разделе «Установка». Настройка источников описана отдельно: Wildberries, Ozon и Яндекс Маркет.