Запросы JS API для разных типов страниц сайта

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

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

Примеры запросов

На главной и 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;
    }
  }
);

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

Также вы можете определить поле (параметр), по которому в фиде будет происходить фильтрация категорий товаров для показа в рекомендациях. Для этого укажите нужное значение categoryField в запросе.

Пример запроса:

eS('getRecommendations', {
    variantId: 'r1673v2111',
		categoryKey: 'ВАННАЯ КОМНАТА',
    categoryField:'tags_all_category_names'
  },
  function(error, products) {
    if (error) {
      console.error(error);
      return;
    }
  }
);

где tags_all_category_names гарантирует поиск по всем значениям дерева категорий.

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