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

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


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

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

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


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

Вынесение общего кода в  <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 - (обязательный) идентификатор просматриваемой категории ( что такое category_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 - (обязательный) идентификатор просматриваемого товара ( что такое product_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 - (обязательный) идентификатор товара, добавляемого в корзину ( что такое product_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 - (обязательный) идентификатор товара, удаляемого из корзины ( что такое product_id?⁠ )


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

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

<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 - (обязательный) идентификатор созданного заказа


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

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

<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"
  });
</script>

Параметры:
email - (обязательный) e-mail пользователя.


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

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

<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 - (обязательный) идентификатор товара, добавляемого в Избранное ( что такое product_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 - (обязательный) идентификатор товара, удаляемого из Избранного ( что такое product_id?⁠ )


Что такое category_id?

category_id - уникальный идентификатор товарной категории, который должен совпадать с идентификатором категории, ранее загруженной в MAXMA.
Если для загрузки товаров и категорий в MAXMA используется YML-фид, то category_id должен совпадать со значением атрибута id в тэге category.

Что такое product_id?

product_id - уникальный идентификатор товара, который должен совпадать с идентификатором товара, ранее загруженного в MAXMA. Если товар может состоять из нескольких вариантов (отдельного цвета, размера и т.д.), то product_id - это идентификатор конкретного варианта.
Если для загрузки товаров в MAXMA используется YML-фид, то product_id должен совпадать со значением атрибута id в тэге offer.

Что такое полная ссылка?

Ссылки на страницу категории или товара, а также ссылку на изображение товара нужно передавать полностью: http(s)://domain.com/path/to/page_or_image.jpg