Интеграция Mindbox для магазина настольных игр

Задача

Магазин настольных игр Crowdgames хотел автоматизировать маркетинг. Клиентам нужны были персонализированные рассылки, возврат брошенных корзин, рекомендации товаров на основе истории покупок. Всё это требовало интеграции с платформой маркетинговой автоматизации.

Выбор пал на Mindbox российскую платформу с мощными инструментами сегментации, триггерных кампаний и программ лояльности. Но у Mindbox сложное API и специфическая архитектура, требующая глубокой интеграции на уровне backend и frontend.

Клиент уже оплатил Mindbox, но не мог полноценно его использовать без технической интеграции. Каждый месяц простоя это потерянные деньги и упущенные возможности по автоматизации маркетинга.

Архитектура интеграции

Mindbox требует двусторонней интеграции: данные должны идти как с сайта в Mindbox, так и обратно. Это не просто отправка заказов в CRM, а полноценный обмен информацией в реальном времени.

Frontend: JavaScript SDK

На фронтенде установили JavaScript SDK Mindbox. Он отслеживает действия пользователей:

• Просмотр товара — отправляется ID товара
• Просмотр категории — отправляется ID категории
• Добавление в корзину — отправляется состав корзины
• Изменение корзины — обновляется состав
• Очистка корзины — отправляется событие удаления

JavaScript SDK работает асинхронно и не влияет на скорость загрузки сайта. Все события отправляются в фоновом режиме.

Backend: API интеграция

Критичные операции идут через backend для гарантии доставки данных:

• Регистрация клиента — создание профиля в Mindbox
• Авторизация — связывание сессии с профилем
• Редактирование профиля — обновление данных
• Создание заказа — отправка для авторизованных и неавторизованных
• Изменение статуса заказа — обновление в реальном времени
• Изменение состава заказа — частичные возвраты и отмены

Что реализовали

Базовая техническая настройка

Настроили DNS-записи для email-канала (DKIM), чтобы письма от Mindbox проходили через спам-фильтры. Заполнили справочники: статусы заказов (более 20 различных статусов) и способы оплаты (ЮKassa, Сплит от Яндекс Пэй).

Передача номенклатуры

Создали YML-фид для автоматической передачи актуальных товаров в Mindbox. Фид обновляется каждые 2 часа и содержит полную информацию о товарах: название, цена, категория, изображения, дополнительные поля (жанр игры).

Загрузка исторических данных

Выгрузили всю историю клиентов и заказов в Mindbox через CSV-импорт. Это позволило сразу запустить сегментацию по прошлым покупкам и начать работу с существующей базой.

Личный кабинет клиента

Интегрировали все операции в личном кабинете:

• Регистрация — клиент сразу создаётся в Mindbox с подписками
• Авторизация — отслеживается для триггеров "давно не заходил"
• Редактирование данных — синхронизация в реальном времени
• Подписка в футере — быстрая подписка на новости

Обработка заказов

Реализовали разделение логики для авторизованных и неавторизованных клиентов. Неавторизованный пользователь регистрируется в Mindbox автоматически вместе с созданием заказа. Все скидки и промокоды передаются с полной детализацией.

При изменении статуса заказа (оплачен, отправлен, доставлен) событие мгновенно отправляется в Mindbox. Это запускает автоматические триггерные цепочки: подтверждение заказа, уведомление об отправке, просьба оставить отзыв.

Технические особенности

Асинхронная обработка

Mindbox API поддерживает синхронный и асинхронный режимы. Синхронный ждёт обработки (таймаут 60 секунд) и возвращает результат. Асинхронный принимает запрос и обрабатывает в фоне. Для большинства операций используем асинхронный режим, чтобы не тормозить сайт.

Логирование

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

Обработка скидок и промокодов

Mindbox умеет сохранять применённые скидки: простые акции без промокода и скидки по промокоду. Акция может применяться на весь заказ или на отдельную позицию. Важно передавать ID акции и сумму скидки для корректной аналитики.

Проблемы и решения

Медленная поддержка Mindbox

Техническая поддержка Mindbox отвечала медленно. Разница во времени с ними составляла 5-6 часов, что замедляло процесс согласования. Приходилось ждать ответов по несколько дней на критичные вопросы.

Сложное согласование ТЗ

Mindbox имеет специфическую архитектуру и нестандартные механизмы. Часть логики настраивается через их интерфейс, часть через API. Согласование ТЗ заняло больше месяца — нужно было выяснить границы ответственности и технические возможности системы.

Результат

Интеграция полностью завершена и работает стабильно. Клиент получил доступ ко всему функционалу Mindbox: триггерные рассылки, сегментация, программа лояльности, персонализация контента.

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

Маркетологи запустили автоматические цепочки: брошенная корзина, брошенный просмотр, реактивация неактивных клиентов, пост-покупочные цепочки с просьбой оставить отзыв.