Различия

Показаны различия между двумя версиями страницы.

--- insales_maxma:maxma-pixel [15/09/2026 07:37] – admin
+++ insales_maxma:maxma-pixel [15/09/2026 08:53] (текущий) – удалено admin
@@ Строка 1: / Строка 1: @@
-====== Пиксель 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.
-  - Инструкции по отладке пикселя — в [[https://help.maxma.com/p/aG0RcIG_GnForE/Testirovanie-pikselya|документации Maxma]].
-Если события не доходят до Maxma, убедитесь, что включён «Е-com блок» — это самая частая причина.
-===== Неочевидные особенности =====
-  * Событие создания заказа не видно в браузере. Создание заказа (''submitOrder'') передаёт в Maxma наш сервер, а не страница магазина. Поэтому в консоли браузера или отладчике пикселя вы его не увидите — оно появится в личном кабинете Maxma.
-  * Заказы, созданные вручную в админке Insales и по API, также передаются в Maxma.
-  * Событие «Очистка корзины» (''setCart'') определяется косвенно. InSales не сообщает о нажатии кнопки «очистить корзину», поэтому мы отслеживаем момент, когда корзина стала пустой. Из-за этого событие очистки может сработать и при оформлении заказа (когда корзина обнуляется) — это известная особенность, не ошибка.
-  * Событие авторизации клиента (''addClientInfo'') срабатывает один раз на браузер. Оно передаётся при первом открытии страницы уже авторизованным покупателем и запоминается в браузере. Повторно в том же браузере оно не уйдёт. Возможны редкие дубли при оформлении заказа — это не критично.
-  * Идентификатор браузера (''clid'') может меняться после очистки кэша или смены браузера. В этом случае при следующем заходе авторизованного покупателя он автоматически привяжется заново.
-  * Пиксель не работает на новом оформлении заказа (чекауте) InSales. Код приложения на новой странице чекаута не подключается, поэтому события на ней не собираются.