====== Пиксель 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 (поле «подписка»). 
 
**Важно!** Вы можете настроить отправку события addClientInfo, когда клиент подписывается на рассылку. Это решение зависит от особенностей вашей формы подписки. Если вам нужна такая настройка, свяжитесь с вашим менеджером в Maxma для получения стоимости такой доработки.

===== Как проверить, что пиксель работает =====

  - Откройте любую страницу магазина и добавьте в URL параметр %%?maxma_debug=1%% (например, %%https://ваш-магазин.ru/cart_items?maxma_debug=1%%). Появится отладочная консоль пикселя Maxma — в ней видны события, уходящие из браузера (просмотр товара, корзина, избранное).
  - Для проверки авторизации и подписки откройте страницу авторизованным покупателем — событие ''addClientInfo'' уходит при первом заходе.
  - Событие создания заказа (''submitOrder'') в браузере не появится — проверяйте его в личном кабинете Maxma.
  - Инструкции по отладке пикселя — в [[https://help.maxma.com/p/aG0RcIG_GnForE/Testirovanie-pikselya|документации Maxma]].

Если события не доходят до Maxma, убедитесь, что включён «Е-com блок» — это самая частая причина.

===== Неочевидные особенности =====

  * Событие создания заказа не видно в браузере. Создание заказа (''submitOrder'') передаёт в Maxma наш сервер, а не страница магазина. Поэтому в консоли браузера или отладчике пикселя вы его не увидите — оно появится в личном кабинете Maxma.
  * Заказы, созданные вручную в админке Insales и по API, также передаются в Maxma.
  * Событие «Очистка корзины» (''setCart'') определяется косвенно. InSales не сообщает о нажатии кнопки «очистить корзину», поэтому мы отслеживаем момент, когда корзина стала пустой. Из-за этого событие очистки может сработать и при оформлении заказа (когда корзина обнуляется) — это известная особенность, не ошибка.
  * Событие авторизации клиента (''addClientInfo'') срабатывает один раз на браузер. Оно передаётся при первом открытии страницы уже авторизованным покупателем и запоминается в браузере. Повторно в том же браузере оно не уйдёт. Возможны редкие дубли при оформлении заказа — это не критично.
  * Идентификатор браузера (''clid'') может меняться после очистки кэша или смены браузера. В этом случае при следующем заходе авторизованного покупателя он автоматически привяжется заново.
  * Пиксель не работает на новом оформлении заказа (чекауте) InSales. Код приложения на новой странице чекаута не подключается, поэтому события на ней не собираются.