Передача рекомендаций через JavaScript API

Если вы планируете использовать алгоритмы товарных рекомендации eSputnik, а отображение (внешний вид блоков, страницы показа и т. д.) настроить на своей стороне, вам необходимо

• установить на сайт скрипт для отслеживания поведения посетителей сайта;
• загрузить фид товарных данных в аккаунт eSputnik;
• настроить передачу рекомендаций из eSputnik на ваш сайт.

Описание настроек

Функция JS API необходима для получения рекомендаций и дальнейшего их использования в товарных блоках на сайте.

Скрипты получения рекомендаций

На главной и 404 странице

eS('getRecommendations', {
  'variantId': 'r554v778'
  }, function(error, products) {

  if (error) {
            console.error(error);
            return ;
        }

});

На странице товара

eS('getRecommendations', {
  'variantId': 'r554v778',
  'productId': 'MX-1512\42'
  }, function(error, products) {

  if (error) {
            console.error(error);
            return ;
        }

});

На странице корзины

eS('getRecommendations', {
  'variantId': 'r554v778',
  'productIds': ['123', '543534']
  }, function(error, products) {

  if (error) {
            console.error(error);
            return ;
        }

});

На поп-апе корзины использование события StatusCartPage

eS('sendEvent', 'StatusCartPage');

На странице категорий

eS('getRecommendations', {
  'variantId': 'r554v778',
  'categoryKey': 'cK'
  }, function(error, products) {


  if (error) {
            console.error(error);
            return ;
        }
});

Метод JS API – асинхронный, что позволяет не ждать выполнения других функций на сайте.

Параметры запроса

Пример ответа

При успешной отправке запроса вы получите ответ следующего вида:

[
 {
"product_id": "02G439",
 "container_type": "19534_r24v435",
"url": "https://…?sc_content=19534_r24v435"
// та iншi атрибути товару з фiда
 }
]

Важно
Вы не должны редактировать, возвращаемое значение в поле URL-адреса, чтобы веб-трекинг работал правильно.

Пример ошибки

Важно
После вызова и отображения блока рекомендаций для правильного трекинга необходимо передавать событие ProductImpressions.

Фильтрация рекомендаций

Фильтрация рекомендаций через JavaScript API позволяет показывать товары на сайте, фильтруя выдачу рекомендаций по данным из фида или по контактным данным, хранящимся на вашей стороне. Например, можно фильтровать рекомендации по городу проживания, размеру одежды, любимому бренду, акционному предложению и т. п. параметрам.

Фильтрация рекомендаций через JS API избавляет вас от необходимости каждый раз менять правила фильтрации в источнике данных в eSputnik.

Формат запроса:

eS('getRecommendations', {
    variantId: 'r362v614',
                'filters': {
                       'include': [{'name': 'city', values: ['Kiev','Kharkiv']}]
                }
  },
  function(error, products) {
    if (error) {
      console.error(error);
      return;
    }
  }
);

Параметры запроса:

Если вы хотите задавать отображение внешнего вида рекомендательных блоков в eSputnik, ознакомьтесь с этой инструкцией.