Отримання рекомендацій у мобільний додаток

Ви можете персоналізувати досвід користувачів і збільшити обсяги продажів, передаючи в додаток рекомендації своїх товарів та послуг.

Рекомендації, що передаються, базуються на даних про дії клієнтів і включають до себе такі варіанти:

• Товару немає в наявності. Добірка подібних товарів.
• Cross-sell (із цим товаром купують). Пропозиція супутніх товарів. Вибір здійснюється на підставі доданих до кошика товарів.
• Upsell (збільшення суми замовлення). Пропозиція дорожчих і комплементарних товарів та послуг для збільшення суми замовлення.
• Ймовірна купівля. Добірка на підставі замовлень користувачів, які придбали цей товар.
• Персональні рекомендації, сформовані з урахуванням історії переглядів і замовлень клієнта.
• Інше. Пропозиція створюється індивідуально, якщо необхідний алгоритм відсутній у стандартних алгоритмах eSputnik.

📘

Примітка

Для кожного з типів рекомендацій передаються різні запити, що мають власний алгоритм і правила, оскільки вони беруть дані з різних джерел.

Попередні умови

Щоб розпочати використання рекомендацій, слід виконати такі умови:

• Підключити один із тарифів Extra features.
• Налашутвати веб-трекінг або трекінг для мобільних додатків.
• Створити джерело даних із потібним алгоритмом для кожного типу рекомендацій, щоб використовувати його ID під час виклику по API.

Налаштування передавання рекомендацій складається з етапів, які детально описані нижче:

1. Отримання токена аутентифікації
2. Отримання рекомендацій запитом v1/recoms/{dataSourceId}

Отримання токена аутентифікації

Для отримання токена автентифікації користувача (authToken) додаток відправляє запит із вашого сервера до API eSputnik.

Запит має бути аутентифікований одним із способів, описаних в інструкції до API. Наприклад, API-ключем.

У запиті треба передати вказані у таблиці відомі поля користувача (принаймні одне поле має бути обов'язковим).

Приклад запиту: 

{
    "email": string,
    "phone": string,
    "externalCustomerId": string,
    "userPseudoId": string, 
    "cookie": string 
}

Приклад відповіді:

{
"token": string
}

У подальшому authToken використовується для аутентифікації запиту щодо отримання рекомендацій. Його слід передавати у заголовку запиту ES-TOKEN. Після кожного запиту поточний токен інвалідується, а в заголовку відповіді ES-TOKEN надходить новий, що використовується для наступного запиту.

Якщо у відповідь на запит рекомендацій надходить статус 401, запит щодо отримання токена необхідно повторити.

Отримання рекомендацій

Для отримання персоналізованих, що базуються на поведінці клієнта, треба відправити такий запит:

Параметри запиту:

* Щоб дізнатися ідентифікатор джерела даних, перейдіть в Акаунт → Налаштування → Джерела даних.

У відповіді на запит кожне поле буде заповнене даними.

Приклад відповіді:

{
    // Mandatory fields
    id: string
    name: string
    url: URL
    price: double
    descr: text
    brand: string
    category: string[]
    isInStock: int
    // Optional fields which depend on a customer's feed format
    // All such fields start from "tags_".
    // Examples: tags_gender, tags_clear_size, tags_universal_size
}

Після отримання рекомендацій від eSputnik ви можете здійснювати їхнє виведення до мобільного додатка клієнта. 

Налаштування параметрів рекомендацій власне в додатку (зовнішній вигляд, спосіб виведення) здійснюється на боці клієнта.