Mindbox
Flutter SDK

Интеграция действий в приложении

Для передачи данных о действиях клиента нужно завести «операции». Подробно о них в разделе «Операции и интеграции» на help.mindbox.ru.

Для вызова операций из мобильного приложение Mindbox SDK предлагает 2 метода:

  • executeAsyncOperation — передача данных в систему;
  • executeSyncOperation — получение данных из системы.

Для создания тела запроса при вызове операции нужно использовать конструктор OperationBodyRequest.

Техническое задание на интеграцию

Эта страница — пример того, как вызывать API SDK для передачи данных.

Для передачи данных в Mindbox сначала надо настроить нужные методы API. Это делается индивидуально для каждого проекта.

Менеджер проекта со стороны Mindbox настраивает нужные методы и описывает их в специальном документе.

Не приступайте к этому разделу, если у вас нет документа с описанием всех нужных методов.

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

Пример реализации вызовов по сценариями

Авторизация в приложении (только для тестов)

DartCode
Mindbox.instance.executeAsyncOperation( operationSystemName: "Mobile.CreateCustomer", operationBody: { "customer": { "mobilePhone": "<Мобильный телефон>", }, }, );

Передача действий просмотра продуктов и категорий

DartCode
Mindbox.instance.executeAsyncOperation( operationSystemName: "CheckGuide.viewProduct", operationBody: { "product": { "ids": { "website": "<product ID in Website>", }, }, }, ); Mindbox.instance.executeAsyncOperation( operationSystemName: "CheckGuide.viewProduct", operationBody: { "viewProductCategory": { "productCategory": { "ids": { "website": "<Product Category ID in Website>", }, }, }, }, );

Передача действий добавления и установки списка продуктов

Для работы со списком продуктов Mindbox предлагает 2 варианта подхода:

  • добавление/удаление по 1 шт;
  • установка списка одним запросом.

Популярные списки продуктов: «корзина» и «избранное».

DartCode
Mindbox.instance.executeAsyncOperation( operationSystemName: "CheckGuide.addProductToCart", operationBody: { "addProductToList": { "product": { "ids": { "website": "<Product ID in Website>", }, }, "pricePerItem": "<Price per item>", }, }, ); Mindbox.instance.executeAsyncOperation( operationSystemName: "CheckGuide.addProductToCart", operationBody: { "productList": [ { "product": { "ids": { "website": "<Product ID in Website>", }, }, "count": "<Number of products>", "priceOfLine": "<Price of line>", }, ], }, );

Пример проверки клиента в сегменте

Данный запрос проверяет принадлежность клиента к заранее настроенному сегменту в системе.

DartCode
Mindbox.instance.executeSyncOperation( operationSystemName: "CheckGuide.checkSegment", operationBody: {}, onSuccess: (success) => print(success), onError: (error) => print(error), );

Пример получения персональных рекомендаций

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

DartCode
Mindbox.instance.executeSyncOperation( operationSystemName: "CheckGuide.getReco", operationBody: { "recommendation": { "limit": "3", }, }, onSuccess: (success) => print(success), onError: (error) => print(error), );

Как прошла ваша интеграция SDK Mindbox?

Мы подготовили короткий опрос, чтобы вы могли поделиться своим опытом интеграции SDK Mindbox. Ваши ответы помогут нам сделать продукт и процесс интеграции лучше!


Last modified on