Это старая версия документа!
Содержание
Пиксель Maxma: передача событий магазина
Пиксель Maxma — это инструмент, который передаёт в Maxma данные о действиях покупателей в вашем магазине: просмотр товара, добавление в корзину, оформление заказа и т. д. Эти данные нужны Maxma для товарных рекомендаций и триггерных писем — чтобы предлагать покупателям то, что им интересно, и напоминать о заброшенной корзине.
Начало работы
- Необходимо подключить услугу «Е-com блок» в аккаунте Maxma. Пиксель работает только при подключённом «е-ком блоке». Если он не подключён, события передаются, но Maxma их просто игнорирует — с вашей стороны всё выглядит «как будто не работает». Подключается это поддержкой Maxma; если после включения пикселя данных нет, обратитесь в поддержку Maxma для подключения услуги «Е-com блок».
- Настройка магазина в приложении Maxma СИ. В настройках магазина в приложении Maxma СИ включите чекбокс: «Подключить пиксель Maxma в магазине». По умолчанию пиксель выключен. Настройку может включить администратор магазина или техподдержка. После включения на всех страницах магазина подключается код пикселя Maxma и начинается сбор событий.
Какие события передаются
| Событие | Когда передаётся |
|---|---|
Просмотр товара (productView) | Покупатель открыл карточку товара |
Добавление в корзину (addToCart) | Покупатель добавил товар в корзину |
Удаление из корзины (removeFromCart) | Покупатель удалил товар из корзины |
Очистка корзины (setCart) | Корзина стала пустой |
Добавление в избранное (addToFav) | Покупатель добавил товар в избранное |
Удаление из избранного (removeFromFav) | Покупатель удалил товар из избранного |
Авторизация клиента (addClientInfo) | При первом заходе авторизованного покупателя, а также при оформлении заказа |
Создание заказа (submitOrder) | Оформлен новый заказ |
Подписка на рассылку (addClientInfo) | Изменилось согласие клиента на рассылку в InSales |
События собираются для всех посетителей магазина, включая неавторизованных: Maxma опознаёт браузер по своему идентификатору (clid), который есть у каждого посетителя. Но чтобы связать эти действия с конкретным человеком (его email и телефоном), покупатель должен авторизоваться на сайте или оформить заказ — тогда в Maxma уходит его контакт.
Какие события НЕ передаются и почему
- Просмотр каталога товаров (
categoryView) — технически невозможно получить данные просматриваемой коллекции на витрине магазина. Событие не передаётся. - Авторизация в момент входа/регистрации — InSales не отдаёт такое событие напрямую. Мы определяем авторизованного покупателя косвенно: при первом открытии страницы авторизованным пользователем (см. особенности ниже).
- Подписка на рассылку через форму на сайте — если на вашем сайте есть отдельная форма подписки, её событие мы не передаём. Передаётся только изменение согласия на рассылку в карточке клиента InSales (поле «подписка»).
Как проверить, что пиксель работает
- Откройте любую страницу магазина и добавьте в URL параметр ?maxma_debug=1 (например, https://ваш-магазин.ru/cart_items?maxma_debug=1). Появится отладочная консоль пикселя Maxma — в ней видны события, уходящие из браузера (просмотр товара, корзина, избранное).
- Для проверки авторизации и подписки откройте страницу авторизованным покупателем — событие
addClientInfoуходит при первом заходе. - Событие создания заказа (
submitOrder) в браузере не появится — проверяйте его в личном кабинете Maxma. - Инструкции по отладке пикселя — в документации Maxma.
Если события не доходят до Maxma, убедитесь, что включён «Е-com блок» — это самая частая причина.
Неочевидные особенности
- Событие создания заказа не видно в браузере. Создание заказа (
submitOrder) передаёт в Maxma наш сервер, а не страница магазина. Поэтому в консоли браузера или отладчике пикселя вы его не увидите — оно появится в личном кабинете Maxma. - Заказы, созданные вручную в админке Insales и по API, также передаются в Maxma.
- Событие «Очистка корзины» (
setCart) определяется косвенно. InSales не сообщает о нажатии кнопки «очистить корзину», поэтому мы отслеживаем момент, когда корзина стала пустой. Из-за этого событие очистки может сработать и при оформлении заказа (когда корзина обнуляется) — это известная особенность, не ошибка. - Событие авторизации клиента (
addClientInfo) срабатывает один раз на браузер. Оно передаётся при первом открытии страницы уже авторизованным покупателем и запоминается в браузере. Повторно в том же браузере оно не уйдёт. Возможны редкие дубли при оформлении заказа — это не критично. - Идентификатор браузера (
clid) может меняться после очистки кэша или смены браузера. В этом случае при следующем заходе авторизованного покупателя он автоматически привяжется заново. - Пиксель не работает на новом оформлении заказа (чекауте) InSales. Код приложения на новой странице чекаута не подключается, поэтому события на ней не собираются.
