Система лояльности Maxma
База знаний постепенно обновляется, поэтому некоторые материалы могут временно отличаться от интерфейса вашей панели администрирования.
В данной статье мы рассмотрим, как подключить и настроить интеграцию интернет-магазина с системой лояльности Maxma.
Maxma - облачная платформа для автоматизации маркетинга и управления программами лояльности в розничных и интернет-магазинах.
Интеграция с Maxma позволяет настроить процент и условия начисления бонусов, их списание, сроки сгорания, товары-исключения и дополнительные бонусы за целевые действия. Магазин передает в Maxma покупателей, оформление, изменение и отмену заказов.
Установить модуль "Система лояльности Maxma" можно в разделе "Модули" - "Магазин модулей" панели администрирования.
Настройки модуля
После установки откроются настройки модуля (рис. 1).

Рисунок 1.
- API-ключ - ключ выдает ваш менеджер Maxma.
- Номер телефона для неавторизованных покупателей - номер вида +79999999999 клиента из системы лояльности. По этому номеру на витрине показываются акции для покупателей, которые не вошли в личный кабинет. Как создать такого клиента в Maxma, описано ниже.
- Что передавать в Maxma как ИД товара - "Артикул" или "Id модификации" (рис. 2). Предварительно выгрузите товары в формате Яндекс Маркет (YML) (инструкция по настройке выгрузки) и передайте файл менеджеру Maxma для загрузки в систему. Значение в модуле должно совпадать с настройкой выгрузки. Если в выгрузке для параметра "Выгружать в качестве идентификатора предложения" выбрано "артикул модификации", в модуле выберите "Артикул". Если выбрано "идентификатор модификации", выберите "Id модификации".
- Передавать отмену заказа - когда заказу в магазине выставляется статус отмены, отмена передается в Maxma.
- Когда начислять и списывать бонусы - "При оплате заказа" или "При выставлении статуса заказа" (рис. 3).
- Статус возврата заказа - необязательная настройка. Когда заказу выставляется один из выбранных статусов, в Maxma оформляется полный возврат заказа (рис. 4). Частичный возврат отдельных товаров не поддерживается.

Рисунок 2.

Рисунок 3.

Рисунок 4.
Внимание!
Отмена и возврат заказа в Maxma необратимы. После передачи их нельзя отменить на стороне Maxma.
После заполнения настроек нажмите "Сохранить".
Настройка на стороне Maxma
Авторизуйтесь в личном кабинете Maxma (рис. 5).

Рисунок 5.
Клиент для неавторизованных покупателей
Чтобы акции отображались на витрине для неавторизованных покупателей, укажите один и тот же подменный номер телефона в модуле и в Maxma.
В Maxma перейдите в раздел "Клиенты" - "Список клиентов" (рис. 6) и нажмите "+ Добавить клиента" (рис. 7).

Рисунок 6.

Рисунок 7.
В карточке клиента заполните данные (рис. 8). В поле "Телефон" укажите тот же номер, что и в настройках модуля.

Рисунок 8.
Акция для витрины
Теперь создайте акцию. Перейдите в раздел "Инструменты" - "Акции" (рис. 9) и нажмите "+ Создать акцию" (рис. 10).

Рисунок 9.

Рисунок 10.
Заполните поля акции: название, участников, условия, вознаграждение и ограничения (рис. 11).

Рисунок 11.
После сохранения акция начнет отображаться на витрине магазина (рис. 12).

Рисунок 12.
Как работает интеграция
Покупатели
Покупатель, который зарегистрировался в магазине (рис. 13), появится в списке клиентов Maxma (рис. 14).

Рисунок 13.

Рисунок 14.
Если изменить данные покупателя в магазине, они обновятся и в Maxma (рис. 15).

Рисунок 15.
Заказы
Заказ, оформленный в магазине (рис. 16, 17), передается в Maxma. Там его можно найти в разделе "Клиенты" - "Покупки", в разделе "Клиенты" - "События" - "Покупки" или в карточке клиента в блоке "История клиента" - "Все события" (рис. 18, 19).

Рисунок 16.

Рисунок 17.

Рисунок 18.

Рисунок 19.
Если изменить состав или сумму заказа в магазине (рис. 20), изменения передадутся в Maxma (рис. 21).

Рисунок 20.

Рисунок 21.
Если выставить заказу статус, выбранный в настройке "Статус возврата заказа" (рис. 22), в Maxma оформится полный возврат заказа. Если включена настройка "Передавать отмену заказа", то при отмене заказа в магазине он отменится и в Maxma.

Рисунок 22.
Бонусы на витрине
При оформлении заказа незарегистрированный покупатель видит, сколько бонусов получит на бонусную карту, если зарегистрируется (рис. 23).

Рисунок 23.
На странице оформления заказа покупатель видит свой баланс бонусов и сколько бонусов будет начислено за заказ (рис. 24).

Рисунок 24.
В личном кабинете, в разделе "Бонусная карта", покупатель видит уровень карты, баланс бонусов и сколько осталось до следующего уровня (рис. 25).

Рисунок 25.
Готово. Мы рассмотрели, как подключить и настроить интеграцию с системой лояльности Maxma.