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

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

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

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

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

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

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

});
JavaScript
COPY

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

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

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

});
JavaScript
COPY

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

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

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

});
JavaScript
COPY

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

eS('sendEvent', 'StatusCartPage');
JavaScript
COPY

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

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


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

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

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

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

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

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

Важно
Вы не должны редактировать, возвращаемое значение в поле 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;
    }
  }
);
JavaScript
COPY

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

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

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

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

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

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