Различия

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

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