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

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

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

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

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

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

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

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

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

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

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

Адреса запиту Метод запиту
https://esputnik.com/api/v1/auth/contact/token POST

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

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

Поле Значення Опис
email string email контакту
phone string телефон контакту
userPseudoId string firebase ID для відстеження поведінки контакту
cookie string

cookie sc –

файл cookie можно згенерувати скриптом трекінгу, встановленим на сайті

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

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

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

{
"token": string
}

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

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

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

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

Адреса запиту Метод запиту
https://esputnik.com/contact-api/v1/recoms/{dataSourceId} GET

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

Поле Значення Опис
dataSourceId  

Ідентифікатор джерела даних.

Обовʼязковий параметр*

products string Масив товарів. Обовʼязкове поле для алгоритмів на базі товарних даних
category string Масив категорій. Обовʼязкове поле для алгоритмів на базі даних категорій
заголовок запиту   ES-TOKEN: authToken
заголовок відповіді   ES-TOKEN: authToken

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

Налаштування

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

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

{
    // 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 ви можете здійснювати їхнє виведення до мобільного додатка клієнта. 

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

Залишилися питання?
Спеціалісти обов'язково нададуть відповідь та допоможуть вирішити вашу проблему!
Зворотний дзвінок
Залишіть заявку – і наш спеціаліст зв'яжеться з вами в робочий час.
Відправити заявку
Консультація в чаті
Готові до ваших запитань!
Написати в чат
Електронна пошта
Напишіть в службу підтримки eSputnik.
Надіслати email