Loymax SmartCom
Русский
Русский
  • Что такое Loymax SmartCom
  • Основы
    • Основные возможности
    • Основные понятия
    • Как начать работу
    • Виды и каналы коммуникаций
    • FAQ
  • Возможности
    • Сегментация
      • Построитель сегментов
      • Список сегментов
      • RFM-сегменты
      • Метки
    • Массовые рассылки
      • Список рассылок
      • E-mail-рассылки
      • SMS-рассылки
      • Push-рассылки
      • Настройки рассылки
      • A/B-тестирование в рассылке
      • Отчёт по рассылке
      • Календарь рассылок
    • Контрольные группы
    • Рецепты кампаний
    • Опросы
    • Профиль клиента
    • Персонализация
      • Шаблонизатор
    • Аналитика
      • Дашборд
    • Шаблоны
    • Управление подписками
    • Атрибуция чеков
    • Промокоды
    • Настройки
      • Общие настройки
      • Поля
      • Справочники
      • Наблюдатели
      • Пользователи
        • Права доступа
      • Регионы
      • Константы для шаблонов
      • Категории рассылок
      • Управление представлениями
    • Кампании
      • Создание кампании
      • Список кампаний
      • Триггеры
        • Брошенная корзина
        • Брошенный просмотр
        • Брошенный просмотр категории
        • Брошенный просмотр продукта
        • Годовщина
        • Дней с последнего чека
        • Дней с регистрации
        • Добавлен товар в контейнер
        • Клиент зарегистрирован
        • Клиент посетил раздел
        • Клиент посетил сайт
        • Клиент посмотрел продукт на сайте
        • Клиент посмотрел продуктовую категорию
        • Куплен продукт
        • Куплен продукт из категории
        • Наступление даты
        • Наступление даты для заказа
        • Наступление даты для клиента
        • Ожидается сгорание бонусов
        • Оплачен заказ
        • Отменён заказ
        • Повторяемая дата
        • Попадание в RFM-сегмент
        • Попадание в сегмент
        • Произошло событие
        • Прошло дней с последнего посещения сайта
        • Системное событие
        • Создан заказ / пробит чек
      • Действия
        • Актуализировать фильтр
        • Выбрать клиентов из сегмента
        • Выполнить A/B-тест
        • Назначить звонок
        • Начислить баллы
        • Начислить бонусы в программе лояльности
        • Ограничить количество участников
        • Ограничить опрос
        • Отправить push
        • Отправить SMS
        • Отправить письмо
        • Отфильтровать клиентов
        • Подождать X минут/часов/дней
        • Подождать до даты
        • Проверить статус письма
        • Сообщить менеджеру
        • Установить метку
      • Отчёт по кампании
      • Брошенная корзина
  • Использование
    • Качество контактных данных
    • Метрики
    • Регионы
    • Каскады
    • События
    • Рекомендации по качественным рассылкам
      • Пост-мастера
      • Настройка DNS
      • Прогрев IP-адреса
      • Аватар для почты
  • Интеграция
    • Готовые интеграции
    • Агрегатор мессенджеров Chat2Desk
    • Обмен данными
      • Введение
      • Структура данных
      • Файловый обмен
      • Данные SQL-сервера
      • REST API
      • Шина обмена данными
    • JS-трекер
    • Мобильный SDK
Powered by GitBook
On this page
  • Обзор
  • Метод getPopup
  • Метод viewPopup
  • Метод event
  1. Интеграция

Мобильный 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, sourceCode) – зафиксировать факт события.

Во избежание влияния сетевых проблем на работу мобильного приложения разработчикам рекомендуется вызывать методы мобильного SDK в отдельном потоке и обрабатывать возможные исключения, возвращаемые методами.

Метод getPopup

Метод получает на вход:

  • clientId - идентификатор клиента в ПЛ;

  • action – идентификатор целевого действия;

  • sourceID – идентификатор источника событий, не обязательный (например, когда у Партнера несколько мобильных приложений).

Метод возвращает null, если ничего показывать не надо, либо, в противном случае, массив, содержащий информацию:

  • Идентификатор попапа (popupID);

  • Действие Navlink;

  • Значение для действия;

  • Заголовок;

  • Подзаголовок;

  • Ссылка на изображение;

  • Текст;

  • Текст кнопки;

  • Доп.текст (например, промокод);

  • Код цвета1;

  • Код цвета2.

При возникновении сетевой проблемы метод выбрасывает исключение.

Данный метод необходимо вызывать при каждом переходе клиента на другую карточку в приложении, а также при совершении иных целевых действий (например, удаление из корзины, очистка корзины и тд).

Ответственность за отрисовку попапа лежит на приложении. Это позволяет упростить процесс стилизации попапов.

Метод viewPopup

Метод получает на вход:

  • clientId - идентификатор клиента в ПЛ;

  • popupID – идентификатор попапа;

  • sourceID – идентификатор источника событий, не обязательный (например, когда у Партнера несколько мобильных приложений).

При возникновении сетевой проблемы метод выбрасывает исключение.

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

Метод event

Метод получает на вход:

  • clientId - идентификатор клиента в ПЛ;

  • eventCode – код события;

  • eventData – детали события, массив;

  • sourceCode – идентификатор источника событий, не обязательный (например, когда у Партнера несколько мобильных приложений).

Возможные значения пар eventCode/eventData:

Событие
eventCode
eventData

Авторизация или регистрация

user_login

Просмотр карточки в МП

view_page

name: 'PAGE_NAME'

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

view_category

category_id: 'CATEGORY_ID'

Просмотр продукта

view_product

category_id: 'CATEGORY_ID', product_id: 'PRODUCT_ID'

Добавление продукта в корзину

add_to_cart

category_id: 'CATEGORY_ID', product_id: 'PRODUCT_ID', quantity: float, price: float

Удаление продукта из корзины

remove_from_cart

product_id: 'PRODUCT_ID', quantity: float

Очистка корзины

clear_cart

Завершение оформления заказа

order_complete

order_id: 'ORDER_ID'

Регистрация произвольного события

event

name: 'EVENT_NAME', context: 'JSON'

При возникновении сетевой проблемы метод выбрасывает исключение.

PreviousJS-трекер

Last updated 1 year ago