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

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


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

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

  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.1791373157.txt.gz · Последнее изменение: — admin

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki