Получение рекомендаций в мобильное приложение

Вы можете персонализировать опыт пользователей и увеличить объемы продаж, добавив в приложение рекомендации своих товаров и услуг.

Передаваемые рекомендации основаны на данных о действиях клиентов и включают следующие варианты:

  • Товара нет в наличии. Подборка похожих товаров.
  • 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