Перейти к основному содержимому

Клиентская интеграция

Этапы подключения​

1. Базовая интеграция​

Интеграция Rocket Listing требует базовой интеграции Retail Rocket, в которую входит передача товарной базы и настройка отслеживания пользовательского поведения.

Однако может потребоваться настроить передачу дополнительных товарных атрибутов, которые необходимы для настроек фильтров в категорийном листинге.

Например: если желаемый вами дизайн выдачи должен содержать фильтр диагонали экрана для телевизоров, то в товарной базе должен передаваться этот самый параметр диагонали.

Базовые этапы интеграции

Подробнее о начале интеграции с Retail Rocket можно ознакомиться в соответствующем разделе.

2. Реализация клиентского дизайна​

Перед началом работ согласовываются и фиксируются все требования к внешнему виду и поведению интерфейса. Это обеспечивает прозрачность процесса и исключает недопонимания на этапе внедрения.

3. Интеграция на сайт магазина​

На этом этапе происходит подключение продукта к вашему сайту. Подробное описание процесса интеграции вы сможете найти в следующих разделах данной инструкции.

Процесс интеграции​

Подключение скрипта​

Необходимо разместить ссылку на скрипт в теге <head>:

<script src="https://unpkg.com/@retailrocketgroup/listing-<partnerId>"></script>
Заметка
  • partnerId - уникальный идентификатор вашего интернет-магазина в Retail Rocket, выдается при регистрации;
  • Вместо ручного подключения скрипта можно использовать пакетный менеджер npm;

Размещение веб-компонентов​

Компонент листинга каталога​

Для показа результатов листинга на общих страницах, например на главной странице, необходимо добавить в вёрстку магазина веб-компонент <rrg-listing-catalog-result-page> на главную страницу.

<rrg-listing-catalog-result-page></rrg-listing-catalog-result-page>

Rocket Listing Main

Компонент настроек листинга​

Для передачи параметров для листинга необходимо добавить в вёрстку магазина веб-компонент <rrg-listing-settings>:

<rrg-listing-settings
  stock=<stock>
></rrg-listing-settings>

Параметры компонента:

  • stock - идентификатор склада/региона текущего пользователя, если используется мультирегиональность;

Компонент листинга для страницы категории​

Для показа результатов листинга на странице категории необходимо добавить в вёрстку магазина веб-компонент <rrg-rocket-listing-category-result-page> на страницу категории.

Для листинга в категории при передаче товарной базы через XML:

<rrg-rocket-listing-category-result-page 
  category-path=<category-path>
>
</rrg-rocket-listing-category-result-page>

Для листинга в категории при передаче товарной базы через Product API:

<rrg-rocket-listing-category-result-page 
  category-id=<category-id>
>
</rrg-rocket-listing-category-result-page>

Необходимо передавать только один параметр: category-path или category-id в зависимости от типа интеграции товарной базы.

Rocket Listing Category

Настройка фильтров​

Для настройки фильтров в категорийном листинге ознакомьтесь с разделом Подготовка фильтров.