Пиксель для сайта

Этот документ предназначен для JS-программистов. Он описывает, как подключить MAXMA для отслеживания событий на вашем сайте.

Для того, чтобы механики программы лояльности основывать на поведении посетителей вашего сайта, нужно начать передавать события, используя описанные ниже примеры кода. На месте параметров, отмеченных "string", подставьте реальные данные.

События передаются асинхронно, не влияя на время отклика вашего сайта, а ошибки, возникающие при передаче, не вызывают сбоев в работе страниц.

Подключите нашу библиотеку на всех страницах:
<script src="//s.maxma.com/js/sdk.js" async></script>


Какие события подключать?

Title
Title
  • Просмотр каталога товаров (categoryView)
  • Просмотр товара (productView)
Требуется для работы триггера "брошенный просмотр", а также для товарных рекомендаций в письмах
  • Добавление товара в корзину (addToCart)
  • Удаление товара из корзины (removeFromCart)
  • Очистка корзины (setCart)
  • Создание заказа (submitOrder)
Требуется для работы триггера писем о брошенной корзине или снижения цены на товар в корзине
  • Добавление товара в избранное (addToFav)
  • Удаление товара из избранного (removeFromFav)
Требуется для работы триггера писем о снижении цены на товар в избранном
  • Подписался на рассылку (addClientInfo)
  • Авторизовался на сайте (addClientInfo)
Добавляет подписчика в базу клиентов, связывает ранее анонимного посетителя с введенным адресом email. Влияет на количество срабатываний всех упомянутых выше триггеров для писем

Вынесение общего кода в <head> (необязательно)

Разместите этот код между тегами <head></head> на всех страницах. Важно, чтобы он вызывался до первого использования метода ClTrack() на странице.
<script type="text/javascript">
  (function(e) {
    e.ClTrack = e.ClTrack || function() { e.ClTrack.queue.push([arguments, +new Date()]) };
    e.ClTrack.queue = e.ClTrack.queue || [];
  })(window);
</script>
Сделав это, вы можете убрать такой повторяющийся фрагмент из всех примеров кода, приведенных ниже.

Событие: просмотрел каталог товаров

Этот код должен вызываться на странице с каталогом товаров.

<script type="text/javascript">
  (function(e) {
    e.ClTrack = e.ClTrack || function() { e.ClTrack.queue.push([arguments, +new Date()]) };
    e.ClTrack.queue = e.ClTrack.queue || [];
  })(window);
  
  ClTrack('categoryView', {
    id: "string",
    title: "string",
    url: "string"
  });
</script>

Параметры:
  • id - (обязательный) идентификатор просматриваемой категории;
  • title - название этой категории;
  • url - полная ссылка на просмотр категории.


Событие: просмотрел товар

Этот код должен вызываться на странице просмотра товара.

<script type="text/javascript">
  (function(e) {
    e.ClTrack = e.ClTrack || function() { e.ClTrack.queue.push([arguments, +new Date()]) };
    e.ClTrack.queue = e.ClTrack.queue || [];
  })(window);
  
  ClTrack("productView", {
    id: "string",
    title: "string",
    url: "string",
    imageUrl: "string"
  });
</script>

Параметры:
  • id - (обязательный) идентификатор просматриваемого товара;
  • title - название товара;
  • url - полная ссылка на товар;
  • price - цена товара;
  • imageUrl - полная ссылка на фото товара.


Событие: добавил товар в корзину

Этот код вызывается при помещении товара в корзину.

<script type="text/javascript">
  (function(e) {
    e.ClTrack = e.ClTrack || function() { e.ClTrack.queue.push([arguments, +new Date()]) };
    e.ClTrack.queue = e.ClTrack.queue || [];
  })(window);

  ClTrack("addToCart", {
    product: {
      id: "string",
      title: "string",
      url: "string",
      imageUrl: "string"
    },
    price: "string"
  });
</script>

Параметры:
  • id - (обязательный) идентификатор товара, добавляемого в корзину;
  • title - название товара;
  • url - полная ссылка на товар;
  • imageUrl - полная ссылка на фото товара;
  • price - цена товара, добавляемого в корзину.


Событие: удалил товар из корзины

Этот код вызывается при удалении товара из корзины.

Если посетитель уменьшает количество товара, но товар при этом остается в корзине, вызывать это событие не нужно.

<script type="text/javascript">
  (function(e) {
    e.ClTrack = e.ClTrack || function() { e.ClTrack.queue.push([arguments, +new Date()]) };
    e.ClTrack.queue = e.ClTrack.queue || [];
  })(window);

  ClTrack("removeFromCart", {
    product: {
      id: "string"
    }
  });
</script>

Параметры:
  • id - (обязательный) идентификатор товара, удаляемого из корзины.


Событие: очистил корзину

Этот код вызывается, когда клиент нажимает кнопку очистки корзины. При оформлении заказа корзина очищается автоматически — передавать это событие не требуется.

<script type="text/javascript">
  (function(e) {
    e.ClTrack = e.ClTrack || function() { e.ClTrack.queue.push([arguments, +new Date()]) };
    e.ClTrack.queue = e.ClTrack.queue || [];
  })(window);

  ClTrack("setCart", {items: []});
</script>


Событие: создал заказ

Этот код нужно вызывать на странице, появляющейся после создания заказа, когда уже известен его номер, а также данные, которые клиент предоставил в процессе оформления.

<script>
  (function(e) {
    e.ClTrack = e.ClTrack || function() { e.ClTrack.queue.push([arguments, +new Date()]) };
    e.ClTrack.queue = e.ClTrack.queue || [];
  })(window);

  ClTrack("submitOrder", {
    orderId: "string"
  });
</script>

Параметры:
  • orderId - (обязательный) идентификатор созданного заказа


Событие: подписался на Email-рассылку

Вызывается, когда посетитель сайта оставляет свой адрес электронной почты, чтобы получать рассылку.

<script>
  (function(e) {
    e.ClTrack = e.ClTrack || function() { e.ClTrack.queue.push([arguments, +new Date()]) };
    e.ClTrack.queue = e.ClTrack.queue || [];
  })(window);

  ClTrack("addClientInfo", {
    email: "string",
    subscribed: true
  });
</script>

Параметры:
  • email - (обязательный) введенный e-mail;
  • subscribed - признак, что посетитель подписался на рассылку.


Событие: успешно авторизовался на сайте

Вызывается, когда посетитель сайта успешно входит в свой аккаунт.

<script>
  (function(e) {
    e.ClTrack = e.ClTrack || function() { e.ClTrack.queue.push([arguments, +new Date()]) };
    e.ClTrack.queue = e.ClTrack.queue || [];
  })(window);

  ClTrack("addClientInfo", {
    email: "string",
    phoneNumber: "string"
  });
</script>

Параметры (обязателен хотя бы один из двух):
  • email - адрес электронной почты пользователя;
  • phoneNumber - номер телефона пользователя.


Событие: добавил товар в Избранное

Этот код вызывается при помещении товара в Избранное.

<script type="text/javascript">
  (function(e) {
    e.ClTrack = e.ClTrack || function() { e.ClTrack.queue.push([arguments, +new Date()]) };
    e.ClTrack.queue = e.ClTrack.queue || [];
  })(window);

  ClTrack("addToFav", {
    product: {
      id: "string",
      title: "string",
      url: "string",
      imageUrl: "string"
    },
    price: "string"
  });
</script>

Параметры:
  • id - (обязательный) идентификатор товара, добавляемого в Избранное;
  • title - название товара;
  • url - полная ссылка на товар;
  • imageUrl - полная ссылка на фото товара;
  • price - цена товара, добавляемого в Избранное.


Событие: удалил товар из Избранного


<script type="text/javascript">
  (function(e) {
    e.ClTrack = e.ClTrack || function() { e.ClTrack.queue.push([arguments, +new Date()]) };
    e.ClTrack.queue = e.ClTrack.queue || [];
  })(window);

  ClTrack("removeFromFav", {
    product: {
      id: "string"
    }
  });
</script>

Параметры:
  • id - (обязательный) идентификатор товара, удаляемого из Избранного.