Инструкция по настройке "Отзывы с маркетплейсов"
1. Общие настройки
Где находится: «Shop-Script → Настройки → Плагины → Отзывы с маркетплейсов», верхняя часть страницы.
| Настройка | Описание |
|---|---|
| Включить пагинацию | Заменяет стандартный вывод отзывов на странице товара на постраничную навигацию. Рекомендуется включать при большом количестве отзывов — ускоряет загрузку страницы. |
| Количество отзывов на странице | Сколько отзывов показывать на одной странице при включенной пагинации (по умолчанию: 20). Оптимально: 20–50. |
| Пересчитать кол-во отзывов и рейтинги | Кнопка ручного пересчёта — обновляет счётчики отзывов и средний рейтинг для всех товаров на основе импортированных данных. Нажимайте после массового импорта или удаления отзывов. |
Рекомендация: включите пагинацию и установите 20–50 отзывов на странице. После первого массового импорта обязательно нажмите «Пересчитать» для актуализации рейтингов.
2. Настройка импорта из OZON
Где находится: блок «OZON» на странице настроек.
Получение API-ключей OZON
- Зайдите в личный кабинет продавца OZON: https://seller.ozon.ru/
- Важно: убедитесь, что у вас подключена подписка «Управление отзывами» или «Premium Plus» — без неё API отзывов недоступен.
- Перейдите в «Настройки → API-ключи»: https://seller.ozon.ru/app/settings/api-keys
- Создайте новый ключ или используйте существующий. Необходимые права ключа:
- Отзывы (Reviews) — чтение (эндпоинты
/v1/review/*) - Товары (Products) — чтение (эндпоинт
/v3/product/info/list— для сопоставления артикулов)
- Отзывы (Reviews) — чтение (эндпоинты
- Скопируйте Client-ID и API-Key
Параметры:
| Настройка | Описание |
|---|---|
| Client-ID | Идентификатор клиента OZON API |
| API-Key | Ключ API для доступа к отзывам |
| ID для сопоставления товаров | Как сопоставлять отзывы с товарами в Shop-Script (см. раздел 5) |
| Минимальная оценка | Импортировать отзывы с оценкой не ниже указанной (0 — все, 5 — только пятёрки) |
| Включать отзывы с пустым текстом | Если выключено — отзывы без текста пропускаются |
3. Настройка импорта из Яндекс.Маркета
Где находится: блок «Яндекс.Маркет» на странице настроек.
Получение API-ключа Яндекс.Маркета
- Зайдите в личный кабинет Яндекс.Маркета для продавцов
- Перейдите в раздел API и создайте ключ. Необходимые права:
- Чтение отзывов о товарах (эндпоинт
/v2/businesses/{id}/goods-feedback)
- Чтение отзывов о товарах (эндпоинт
- Скопируйте API-Key и Business ID (идентификатор вашего бизнеса, отображается в личном кабинете)
Параметры:
| Настройка | Описание |
|---|---|
| Business ID | Идентификатор бизнеса в Яндекс.Маркете |
| Токен | Токен авторизации API (передаётся в заголовке Api-Key) |
| ID для сопоставления товаров | Как сопоставлять отзывы с товарами (см. раздел 5) |
| Минимальная оценка | Импортировать отзывы с оценкой не ниже указанной |
| Включать отзывы с пустым текстом | Если выключено — отзывы без текста пропускаются |
Статистика, кнопки «Обновить», «Удалить» и CRON-команда работают аналогично блоку OZON.
4. Настройка импорта из Wildberries
Где находится: блок «Wildberries» на странице настроек.
Получение API-ключа Wildberries
- Зайдите в личный кабинет продавца Wildberries
- Перейдите в «Настройки → Доступ к API»
- Создайте или скопируйте существующий токен. Необходимые права:
- Отзывы (Feedbacks API) — чтение (эндпоинт
/api/v1/feedbacks)
- Отзывы (Feedbacks API) — чтение (эндпоинт
- Токен передаётся в заголовке
Authorization
Ограничение API: Wildberries допускает не более 3 запросов в секунду. Плагин соблюдает это ограничение автоматически — между запросами выдерживается пауза не менее 333 мс.
Параметры:
| Настройка | Описание |
|---|---|
| Токен | Токен авторизации API Wildberries |
| ID для сопоставления товаров | Как сопоставлять отзывы с товарами (см. раздел 5) |
| Минимальная оценка | Импортировать отзывы с оценкой не ниже указанной |
| Включать отзывы с пустым текстом | Если выключено — отзывы без текста пропускаются |
5. Сопоставление товаров (маппинг)
Ключевая настройка для каждого маркетплейса — «ID для сопоставления товаров». Она определяет, как плагин связывает отзыв с товаром в Shop-Script.
| Вариант | Пример | Когда использовать |
|---|---|---|
| [ID Товара] | 12345 |
ID товара в Shop-Script совпадает с ID товара на маркетплейсе |
| [ID Артикула] | 12345 |
SKU товара в Shop-Script совпадает с ID на маркетплейсе |
| [Код артикула] | ABC-123 |
Рекомендуемый вариант. Код артикула в Shop-Script совпадает с артикулом на маркетплейсе |
| [ID Товара]s[ID артикула] | 12345s67890 |
Составной ключ: ID товара + буква s + ID артикула |
Рекомендация: используйте «[Код артикула]», если вы ведёте единую номенклатуру артикулов на всех площадках. Это наиболее надёжный способ сопоставления.
Важно: если товар не найден по выбранному идентификатору — отзыв будет загружен, но останется несопоставленным. Такие отзывы не отображаются на витрине, но видны в блоке статистики (счётчик «Сопоставлено отзывов»). Чтобы исправить: смените тип сопоставления, удалите старые отзывы и нажмите «Обновить» заново.
6. Ручное обновление, удаление и пересчёт рейтинга
Кнопка «Пересчитать кол-во отзывов и рейтинги»
Находится в общих настройках (блок «Общие»). Обновляет агрегированные данные в карточках товаров: количество отзывов и средний рейтинг. Нажимайте после массового импорта или удаления отзывов — без пересчёта новые оценки могут не отображаться на витрине.
Кнопка «Обновить отзывы»
Запускает процесс импорта из выбранного маркетплейса прямо сейчас:
- Плагин обращается к API маркетплейса
- Загружает отзывы по всем товарам (с учётом фильтров: минимальная оценка, пустой текст)
- Сопоставляет их с товарами в Shop-Script по выбранному идентификатору
- Сохраняет в базе данных
Процесс может занять несколько минут при большом количестве отзывов. Не закрывайте страницу до завершения.
| Элемент | Назначение |
|---|---|
| Выгружено отзывов / Сопоставлено отзывов | Статистика: сколько всего загружено и сколько привязано к товарам |
| Обновить отзывы | Запускает ручной импорт отзывов из OZON |
| Удалить сопоставленные отзывы | Удаляет все импортированные из OZON отзывы (товары не затрагиваются) |
| CRON-команда | Для автоматического обновления (см. раздел 7) |
Кнопка «Удалить сопоставленные отзывы»
Удаляет все отзывы, импортированные из выбранного маркетплейса: тексты и оценки сбрасываются, сами товары не затрагиваются. Используйте, если нужно переимпортировать отзывы заново — например, после смены ID для сопоставления.
7. Автоматическое обновление по CRON
Для каждого маркетплейса в настройках указана команда CRON. Добавьте её в crontab на сервере, чтобы отзывы подгружались автоматически по расписанию.
Команды:
| Маркетплейс | CRON-команда |
|---|---|
| OZON | php /home/user/example.com/www/cli.php shop mpreviewsImportOzonReviews |
| Яндекс.Маркет | php /home/user/example.com/www/cli.php shop mpreviewsImportYandexMarketFeedbacks |
| Wildberries | php /home/user/example.com/www/cli.php shop mpreviewsImportWildberriesFeedbacks |
Важно: убедитесь, что путь к cli.php соответствует вашему серверу, а в настройках каждого маркетплейса заполнены API-ключи и выбран тип сопоставления — иначе cron-импорт ничего не загрузит.
Пример настройки cron (раз в сутки, в 3:00 ночи):
crontab -e -u web
Добавьте строки:
0 3 * * * php /home/user/example.com/www/cli.php shop mpreviewsImportOzonReviews 0 3 * * * php /home/user/example.com/www/cli.php shop mpreviewsImportYandexMarketFeedbacks 0 3 * * * php /home/user/example.com/www/cli.php shop mpreviewsImportWildberriesFeedbacks
