Запити 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, ознайомтеся з цією інструкцією.