Page tree
Skip to end of metadata
Go to start of metadata
Оглавление

1. Введение

Этот документ описывает процесс установки модуля REES46 на ваш магазин на платформе Webasyst Shop-Script версии 5 и выше.

2. Краткий план установки

  1. Зарегистрировать магазин в системе REES46.
  2. Установить плагин.
  3. Ввести в настройки модуля данные вашего магазина.
  4. Включить плагин.
  5. Установить блоки рекомендаций.
  6. Проверить работоспособность.

3. Пошаговая инструкция по установке

3.1. Регистрация магазина

  1. Перейдите на сайт http://rees46.com.
  2. Зарегистрируйтесь и создайте новый магазин.
  3. Запишите код магазина и секретный ключ (длинная бессмысленная последовательность букв и цифр, которую вы получите после создания магазина на сайте REES46).

3.2. Установка модуля на сайт

  1. Перейдите в раздел "Инсталлер" в верхнем меню интернет-магазина.
  2. В левом меню перейдите в раздел "Плагины" и в выпадающем меню выберите "Shop" - плагины для магазина.
  3. Найдите и установите плагин "REES46: рекомендательная система".
  4. Если у вас не установлен плагин "Яндекс.Маркет", то его также необходимо установить. Данный плагин потребуется для создания файла списка товаров, с которым будет работать REES46.

3.3. Первичная настройка

3.3.1. Создание YML-файла

  1. Перейдите в раздел "Магазин" в верхнем меню интернет-магазина.
  2. Откройте список установленных плагинов. Для этого необходимо кликнуть по ссылке "Плагины" в правой части открывшегося окна.
  3. Выберите плагин "Яндекс.Маркет" и, если ранее настройка данного плагина не производилась, выберите основную валюту вашего интернет-магазина и при необходимости конвертацию.
  4. Перейдите в раздел "Импорт/экспорт". Для этого необходимо кликнуть по соответствующей ссылке в правой части текущего окна.
  5. В левом меню открывшейся страницы выберите плагин "Яндекс.Маркет".
  6. Если у вас уже есть профиль экcпорта, то создайте новый профиль с названием "REES46".
  7. В поле "Обновление файла" выберите "Автоматически при каждом запросе".
  8. В разделе "1. Выберите товары" выберите "Все товары".
  9. В разделе "2. Общие параметры экспорта" введите название интернет-магазина и компании, если значения не подставились автоматически. Опции "Выгружать товары с нулевым остатком", "Экспортировать каждый артикул товара как отдельную позицию" и "Выгружать скрытые категории" необходимо выключить.
  10. В разделе "3. Экспорт характеристик товаров" обязательными полями являются "Название" и "Наличие", поле "Описание" является рекомендуемым.
  11. После задания всех настроек нажмите кнопку "Экспортировать" внизу страницы и дождитесь завершения экспорта.
  12. По завершении экспорта перейдите по ссылке "Получить ссылку на файл", где на открывшейся странице отобразится ссылка на сформированный YML-файл.
  13. Скопируйте предложенную ссылку и укажите её в настройках интернет-магазина в личном кабинете на сайте REES46. Не забудьте сохранить настройки.

3.3.2. Настройка плагина REES46

  1. Перейдите в раздел "Магазин" в верхнем меню интернет-магазина.
  2. Откройте список установленных плагинов. Для этого необходимо кликнуть по ссылке "Плагины" в правой части открывшегося окна.
  3. Выберите плагин "REES46: рекомендательная система".
  4. В поля "Код магазина" и "Секретный ключ" вставьте соответствующие значения, полученные в разделе 3.1 данной инструкции.
  5. Выберите способ расстановки блоков рекомендаций. Подробнее о каждом способе смотрите соответствующий раздел данной инструкции.
  6. Если ваш тариф REES46 предусматривает отраслевые модификации алгоритмов рекомендаций, выберите соответствующую модификацию.
  7. Включите плагин выбрав статус "Включен".
  8. Сохраните изменения.

3.4. Пакетная установка блоков рекомендаций

  1. По-умолчанию пакетный режим установки автоматически добавляет блок "Популярные товары" на главную страницу, блок "Не забудьте посмотреть" на страницу корзины и блок "Искавшие это также купили" на страницу поиска.
  2. Для установки блоков рекомендаций на страницы категорий необходимо перейти в раздел "Магазин" (верхнее меню), затем в раздел "Витрина" -> "Шаблоны". В левом списке файлов шаблона необходимо найти файл "category.html" и в самый низ данного файла скопировать следующий код, который пакетно добавит блоки "Популярные товары" (из категории), "Вам будет интересно" и "Вы недавно смотрели":

    category.html
    {shopRees46Plugin::frontendCategoryBottom()}
  3. Не забудьте сохранить изменения.
  4. Для установки блоков рекомендаций на страницы карточки товара необходимо перейти в раздел "Магазин" (верхнее меню), затем раздел "Витрина" -> "Шаблоны". В левом списке файлов шаблона необходимо найти файл "product.html" и в самый низ данного файла скопировать следующий код, который пакетно добавит блоки "Похожие", "С этим также покупают" и "Вам будет интересно":

    product.html
    {shopRees46Plugin::frontendProductBottom()}
  5. Не забудьте сохранить изменения.

3.5. Самостоятельная установка блоков рекомендаций

3.5.1. Рекомендуемая схема размещения блоков

Важно установить максимальное количество блоков из предложенных. Может возникнуть соблазн поставить только 1-2 блока, потому что "не хочется портить дизайн" (про стилизацию блоков с рекомендованными товарами в дизайн сайта смотрите в 6 разделе инструкции). В этом случае помните: 1-2 блока не могут работать эффективно. Для достижения максимального эффекта блоки должны быть расположены по рекомендованной схеме:

  • Главная страница:
    • вверху - блок "Популярные товары"
    • внизу - блоки "Вам будет интересно", "Прямо сейчас покупают"
  • Страница категории:
    • вверху - блоки "Популярные товары" (автоматически выбираются из текущей категории)
    • внизу - блоки "Вам будет интересно", "Вы недавно смотрели"
  • Страница карточки товара:
    • под подробным описанием - блоки "Похожие товары", "С этим также покупают", "Вам будет интересно"
  • Страница корзины
    • внизу - блоки "Не забудьте посмотреть" и "Вам будет интересно"
  • Страница поиска
    • вверху - блок "Искавшие это также купили"

3.5.2. Установка блока "Популярные"

  1. Блок "Популярные" может быть установлен на главной странице и странице категорий.
  2. Для установки блока перейдите в раздел "Магазин" (верхнее меню), затем в раздел "Витрина" -> "Шаблоны".
  3. В левом списке файлов выберите необходимый шаблон и скопируйте в рекомендованное место размещения блока следующий код:

    home.html, category.html
    {shopRees46Plugin::REES46_recommender('Popular',5)}
  4. Значение '5' в примере задаёт верхний лимит товаров в блоке рекомендаций и может принимать значение от 1 до 10.
  5. Не забудьте сохранить изменения.

3.5.3. Установка блока "Вам будет интересно"

  1. Блок "Вам будет интересно" может быть установлен на главной странице, странице категорий, в карточке товара и на странице корзины
  2. Для установки блока перейдите в раздел "Магазин" (верхнее меню), затем в раздел "Витрина" -> "Шаблоны".
  3. В левом списке файлов выберите необходимый шаблон и скопируйте в рекомендованное место размещения блока следующий код:

    home.html, category.html, product.html, cart.html
    {shopRees46Plugin::REES46_recommender('Interesting',5)}
  4. Значение '5' в примере задаёт верхний лимит товаров в блоке рекомендаций и может принимать значение от 1 до 10.
  5. Не забудьте сохранить изменения.

3.5.4. Установка блока "Вы недавно смотрели"

  1. Блок "Вы недавно смотрели" может быть установлен на главной страницестранице категорий и в карточке товара
  2. Для установки блока перейдите в раздел "Магазин" (верхнее меню), затем в раздел "Витрина" -> "Шаблоны".
  3. В левом списке файлов выберите необходимый шаблон и скопируйте в рекомендованное место размещения блока следующий код:

    home.html, category.html, product.html
    {shopRees46Plugin::REES46_recommender('Recently_Viewed',5)}
  4. Значение '5' в примере задаёт верхний лимит товаров в блоке рекомендаций и может принимать значение от 1 до 10.
  5. Не забудьте сохранить изменения.

3.5.5. Установка блока "Похожие товары"

  1. Блок "Похожие товары" может быть установлен только в карточке товара
  2. Для установки блока перейдите в раздел "Магазин" (верхнее меню), затем в раздел "Витрина" -> "Шаблоны".
  3. В левом списке файлов выберите шаблон "product.html" и скопируйте в рекомендованное место размещения блока следующий код:

    product.html
    {shopRees46Plugin::REES46_recommender('Similar',5)}
  4. Значение '5' в примере задаёт верхний лимит товаров в блоке рекомендаций и может принимать значение от 1 до 10.
  5. Не забудьте сохранить изменения.

3.5.6. Установка блока "С этим также покупают"

  1. Блок "С этим также покупают" может быть установлен только в карточке товара
  2. Для установки блока перейдите в раздел "Магазин" (верхнее меню), затем в раздел "Витрина" -> "Шаблоны".
  3. В левом списке файлов выберите шаблон "product.html" и скопируйте в рекомендованное место размещения блока следующий код:

    product.html
    {shopRees46Plugin::REES46_recommender('Also_Bought',5)}
  4. Значение '5' в примере задаёт верхний лимит товаров в блоке рекомендаций и может принимать значение от 1 до 10.
  5. Не забудьте сохранить изменения.

3.5.7. Установка блока "Не забудьте посмотреть"

  1. Блок "Не забудьте посмотреть" может быть установлен только на странице корзины.
  2. Для установки блока перейдите в раздел "Магазин" (верхнее меню), затем в раздел "Витрина" -> "Шаблоны".
  3. В левом списке файлов выберите шаблон "cart.html" и скопируйте в рекомендованное место размещения блока следующий код:

    cart.html
    {shopRees46Plugin::REES46_recommender('See_Also',5)}
  4. Значение '5' в примере задаёт верхний лимит товаров в блоке рекомендаций и может принимать значение от 1 до 10.

Не забудьте сохранить изменения.

3.5.8. Установка блока "Прямо сейчас покупают"

  1. Блок "Прямо сейчас покупают" может быть установлен на любой странице, но чаще всего его рекомендуется устанавливать на главную страницу.
  2. Для установки блока перейдите в раздел "Магазин" (верхнее меню), затем в раздел "Витрина" -> "Шаблоны".
  3. В левом списке файлов выберите необходимый шаблон и скопируйте в рекомендованное место размещения блока следующий код:

    home.html, category.html, product.html, cart.html
    {shopRees46Plugin::REES46_recommender('Buying_Now',5)}
  4. Значение '5' в примере задаёт верхний лимит товаров в блоке рекомендаций и может принимать значение от 1 до 10.
  5. Не забудьте сохранить изменения.

3.5.9. Установка блока "Искавшие это также купили"

  1. Блок "Искавшие это также купили" может быть установлен только на странице поиска.
  2. Для установки блока перейдите в раздел "Магазин" (верхнее меню), затем в раздел "Витрина" -> "Шаблоны".
  3. В левом списке файлов выберите шаблон "search.html" и скопируйте в рекомендованное место размещения блока следующий код:

    search.html
    {shopRees46Plugin::REES46_recommender('Search',5)}
  4. Значение '5' в примере задаёт верхний лимит товаров в блоке рекомендаций и может принимать значение от 1 до 10.
  5. Не забудьте сохранить изменения.

3.5.10. Проверьте работоспособность блоков рекомендаций

  1. Откройте консоль разработчика в вашем браузере.
  2. Перейдите на вкладку Network (или "Сеть"), в которой при обновлении страницы отображаются происходящие запросы.
  3. Включите режим фильтрации только XHR-запросов.
  4. Убедитесь, что выполняются запросы на api.rees46.com/recommend.
     

4. Удаление плагина

4.1. Выключение плагина

Если вы решили временно не использовать REES46, то для этого достаточно выключить плагин в настройках. Чтобы выключить плагин необходимо сделать следующее:

  1. Перейдите в раздел "Магазин" в верхнем меню интернет-магазина.
  2. Откройте список установленных плагинов. Для этого необходимо кликнуть по ссылке "Плагины" в правой части открывшегося окна.
  3. Выберите плагин "REES46: рекомендательная система".
  4. Выключите плагин выбрав статус "Выключен".
  5. Сохраните изменения.

4.2. Удаление плагина

Для удаления плагина необходимо произвести действия в обратном порядке:

  1. Если вы использовали пакетную установку блоков, то необходимо удалить все строки, добавленные в шаблоны в п.3.4. данной инструкции.
  2. Если вы использовали самостоятельную установку блоков, то необходимо удалить все строки, добавленные в шаблоны в п.3.5. данной инструкции.
  3. Удалите плагин.
  4. Если в процессе удаления возникли проблемы: свяжитесь с нами по адресу [email protected].

5. Если рекомендации еще не появились

Рекомендации могут появиться не сразу – все зависит от посещаемости вашего сайта. Если на вашем сайте оформляются заказы, значит статистика собирается, и скоро рекомендации начнут появляться. Но обязательно проверьте правильность установки.

6. Оформление блоков в дизайн сайта

  1. Войдите в личный кабинет REES46.
  2. В левом меню перейдите в раздел "Вид блоков рекомендаций".
  3. Используя возможности CSS оформите внешний вид блоков по своему усмотрению.
  4. Не забудьте сохранить изменения.

7. Участие в разработке модуля

REES46 является бесплатной профессиональной рекомендательной системой, цель которой – дать возможность персонализированного подхода к клиенту любому интернет-магазину. Если вы специалист в разработке модулей под WebAsyst/ShopScript и желаете улучшить модуль, отправляйте pull request в репозиторий https://github.com/rees46/rees46_webasyst.

 

 

  • No labels