Comment on page
Мобильный SDK
Loymax предоставляет SDK для интеграции мобильных приложений с платформой Loymax SmartCom. SDK реализован для Kotlin и Swift. Данный SDK по своей сути является оберткой, которая осуществляет вызовы в бакенд Loymax.
SDK содержит методы:
- getPopup(clientId, action, sourceID) – получить из Loymax SmartCom информацию о попапе, который необходимо показать;
- viewPopup(clientId, popupID, sourceID) – зафиксировать факт показа попапа;
- event(clientId, eventCode, eventData, sourceID) – зафиксировать факт события.
Во избежание влияния сетевых проблем на работу мобильного приложения разработчикам рекомендуется вызывать методы мобильного SDK в отдельном потоке и обрабатывать возможные исключения, возвращаемые методами.
Метод получает на вход:
- clientId - идентификатор клиента в ПЛ;
- action – идентификатор целевого действия;
- sourceID – идентификатор источника событий, не обязательный (например, когда у Партнера несколько мобильных приложений).
Метод возвращает null, если ничего показывать не надо, либо, в противном случае, массив, содержащий информацию:
- Идентификатор попапа (popupID);
- Действие Navlink;
- Значение для действия;
- Заголовок;
- Подзаголовок;
- Ссылка на изображение;
- Текст;
- Текст кнопки;
- Доп.текст (например, промокод);
- Код цвета1;
- Код цвета2.
При возникновении сетевой проблемы метод выбрасывает исключение.
Данный метод необходимо вызывать при каждом переходе клиента на другую карточку в приложении, а также при совершении иных целевых действий (например, удаление из корзины, очистка корзины и тд).
Ответственность за отрисовку попапа лежит на приложении. Это позволяет упростить процесс стилизации попапов.
Метод получает на вход:
- clientId - идентификатор клиента в ПЛ;
- popupID – идентификатор попапа;
- sourceID – идентификатор источника событий, не обязательный (например, когда у Партнера несколько мобильных приложений).
При возникновении сетевой проблемы метод выбрасывает исключение.
Данный метод необходимо вызывать после отрисовки (показа) попапа, чтобы зафиксировать факт попапа и удалить его из назначенных к показу текущему клиенту.