Инструменты пользователя

Инструменты сайта


insales_maxma:features:maxma-pixel

Это старая версия документа!


Пиксель Maxma: передача событий магазина

Пиксель Maxma — это инструмент, который передаёт в Maxma данные о действиях покупателей в вашем магазине: просмотр товара, добавление в корзину, оформление заказа и т. д. Эти данные нужны Maxma для товарных рекомендаций и триггерных писем — чтобы предлагать покупателям то, что им интересно, и напоминать о заброшенной корзине.

Начало работы

  1. Необходимо подключить услугу «Е-com блок» в аккаунте Maxma. Пиксель работает только при подключённом «е-ком блоке». Если он не подключён, события передаются, но Maxma их просто игнорирует — с вашей стороны всё выглядит «как будто не работает». Подключается это поддержкой Maxma; если после включения пикселя данных нет, обратитесь в поддержку Maxma для подключения услуги «Е-com блок».
  2. Настройка магазина в приложении Maxma СИ. В настройках магазина в приложении Maxma СИ включите чекбокс: «Подключить пиксель Maxma в магазине». По умолчанию пиксель выключен. Настройку может включить администратор магазина или техподдержка. После включения на всех страницах магазина подключается код пикселя Maxma и начинается сбор событий.

Какие события передаются

Событие Когда передаётся
Просмотр товара (productView) Покупатель открыл карточку товара
Добавление в корзину (addToCart) Покупатель добавил товар в корзину
Удаление из корзины (removeFromCart) Покупатель удалил товар из корзины
Очистка корзины (setCart) Корзина стала пустой
Добавление в избранное (addToFav) Покупатель добавил товар в избранное
Удаление из избранного (removeFromFav) Покупатель удалил товар из избранного
Авторизация клиента (addClientInfo) При первом заходе авторизованного покупателя, а также при оформлении заказа
Создание заказа (submitOrder) Оформлен новый заказ
Подписка на рассылку (addClientInfo) Изменилось согласие клиента на рассылку в InSales

События собираются для всех посетителей магазина, включая неавторизованных: Maxma опознаёт браузер по своему идентификатору (clid), который есть у каждого посетителя. Но чтобы связать эти действия с конкретным человеком (его email и телефоном), покупатель должен авторизоваться на сайте или оформить заказ — тогда в Maxma уходит его контакт.

Какие события НЕ передаются и почему

  • Просмотр каталога товаров (categoryView) — технически невозможно получить данные просматриваемой коллекции на витрине магазина. Событие не передаётся.
  • Авторизация в момент входа/регистрации — InSales не отдаёт такое событие напрямую. Мы определяем авторизованного покупателя косвенно: при первом открытии страницы авторизованным пользователем (см. особенности ниже).
  • Подписка на рассылку через форму на сайте — если на вашем сайте есть отдельная форма подписки, её событие мы не передаём. Передаётся только изменение согласия на рассылку в карточке клиента InSales (поле «подписка»).

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

  1. Откройте любую страницу магазина и добавьте в URL параметр ?maxma_debug=1 (например, https://ваш-магазин.ru/cart_items?maxma_debug=1). Появится отладочная консоль пикселя Maxma — в ней видны события, уходящие из браузера (просмотр товара, корзина, избранное).
  2. Для проверки авторизации и подписки откройте страницу авторизованным покупателем — событие addClientInfo уходит при первом заходе.
  3. Событие создания заказа (submitOrder) в браузере не появится — проверяйте его в личном кабинете Maxma.
  4. Инструкции по отладке пикселя — в документации Maxma.

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

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

  • Событие создания заказа не видно в браузере. Создание заказа (submitOrder) передаёт в Maxma наш сервер, а не страница магазина. Поэтому в консоли браузера или отладчике пикселя вы его не увидите — оно появится в личном кабинете Maxma.
  • Заказы, созданные вручную в админке Insales и по API, также передаются в Maxma.
  • Событие «Очистка корзины» (setCart) определяется косвенно. InSales не сообщает о нажатии кнопки «очистить корзину», поэтому мы отслеживаем момент, когда корзина стала пустой. Из-за этого событие очистки может сработать и при оформлении заказа (когда корзина обнуляется) — это известная особенность, не ошибка.
  • Событие авторизации клиента (addClientInfo) срабатывает один раз на браузер. Оно передаётся при первом открытии страницы уже авторизованным покупателем и запоминается в браузере. Повторно в том же браузере оно не уйдёт. Возможны редкие дубли при оформлении заказа — это не критично.
  • Идентификатор браузера (clid) может меняться после очистки кэша или смены браузера. В этом случае при следующем заходе авторизованного покупателя он автоматически привяжется заново.
  • Пиксель не работает на новом оформлении заказа (чекауте) InSales. Код приложения на новой странице чекаута не подключается, поэтому события на ней не собираются.
insales_maxma/features/maxma-pixel.1789451567.txt.gz · Последнее изменение: — admin

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki