JS-трекер

Обзор

JS-трекер Loymax SmartCom – это небольшой фрагмент JavaScript-кода, устанавливаемый на сайт пользователя по аналогии с трекером Google Analytics или Яндекс.Метрика. Трекер фиксирует посещение сайта клиентом и привязывает это посещение к профилю данного клиента в Loymax SmartCom.

На основе данных от трекера Loymax SmartCom строит карту интересов клиента относительно продуктов и продуктовых категорий, а также позволяет реализовать функционал возврата брошенных корзин и другие веб-триггера.

Возможности

Трекер фиксирует веб-события:

  • Посещение сайта (старт новой сессии);

  • Просмотр продукта;

  • Просмотр продуктовой категории;

  • Добавление/удаление товара в контейнер (корзина, избранное, уведомить о поступлении и др);

  • Просмотр раздела (фиксируется строковое имя раздела; например, акция_xxx, заявка_партнерство);

  • Авторизация / регистрация клиента;

  • Обработка брошенной корзины.

Деанонимизация

Loymax SmartCom хранит историю анонимных посещений за 60 дней. Это значит, что если неидентифицированный посетитель производил на сайте действия (например, интересовался определёнными продуктами), а затем в течение 60 дней авторизовался на сайте или зарегистрировался, то действия этого посетителя будут "подшиты" в профиль соответствующего клиента в Loymax SmartCom.

Если клиент никогда не авторизовывался на сайте и не совершал заказы на сайте, то он всё равно может быть автоматически идентифицирован, если он хотя бы раз перейдёт на сайт по ссылке из рассылок Loymax SmartCom.

Рекомендуется проводить рассылки хотя бы 2-3 раза в месяц, "размечая" таким образом клиентов, чтобы эффективно собирать данные об их поведении на вашем сайте.

Установка трекера

Код отслеживания

Установите на все страницы вашего сайта загрузку кода отслеживания:

<script type='text/javascript'>
  var _gcTracker = _gcTracker || [];
  _gcTracker.push(['init', 'SHOP_ID', 'ESRC_ID']);
  
  (function() {
    var s = document.createElement('script');
    s.type = 'text/javascript'; s.async = true; s.src = '//:domain/tracker/v1.3/tracker.min.js';
    document.getElementsByTagName('head')[0].appendChild(s);
  })();
</script>

где:

  • (int) SHOP_ID – это ваш числовой идентификатор в Loymax SmartCom. Чтобы получить его, напишите запрос в службу поддержки Loymax SmartCom.

  • (string) ESRC_ID - это идентификатор источника события, соответствующий указанным в настройках источникам, например: интернет-магазин/мобильное приложение.

Чтобы узнать актуальное доменное имя :domain, напишите запрос в службу поддержки Loymax SmartCom.

Параметр ESRC_ID может быть пустым. Если его не передавать, то в качестве идентификатора источника события будет выбран тот, что указан по умолчанию в настройках.

Пример:

<script type='text/javascript'>
  var _gcTracker = _gcTracker || [];
  _gcTracker.push(['init', '123456789', 'main_web']);
  
  (function() {
    var s = document.createElement('script');
    s.type = 'text/javascript'; s.async = true; s.src = '//:domain/tracker/v1.3/tracker.min.js';
    document.getElementsByTagName('head')[0].appendChild(s);
  })();
</script>

Желательно разместить код трекера как можно ближе к началу страницы после кода основных счётчиков Google Analytics / Яндекс.Метрика.

Загрузка кода отслеживания должна производиться ДО вызовов, описанных в изложенных ниже пунктах.

Авторизация и регистрация

Добавьте вызов кода отслеживания на события авторизации и регистрации

_gcTracker.push(['user_login', { user_id: 'USER_ID' }]);

где (string) USER_ID – уникальный идентификатор клиента в ваших информационных системах.

Пример:

<script type='text/javascript'>
  _gcTracker.push(['user_login', { user_id: '65535' }]);
</script>

В качестве USER_ID используйте тот код, который через интеграцию передаётся в качестве основного ключа в Loymax SmartCom.

Просмотр раздела

Добавьте вызов кода отслеживания на событие просмотра раздела:

_gcTracker.push(['view_page', { name: 'PAGE_NAME' }]);

где (string) PAGE_NAME – идентификатор страницы, который в дальнейшем может быть использован вами при настройке триггера "Клиент посетил раздел".

Пример:

<script type='text/javascript'>
  _gcTracker.push(['view_page', { name: 'view_partnership_conditions' }]);
</script>

Просмотр продуктовой категории

Добавьте вызов кода отслеживания на событие просмотра продуктовой категории:

_gcTracker.push(['view_category', { category_id: 'CATEGORY_ID' }]);

где (string) CATEGORY_ID – идентификатор категории продукта в ваших ИС.

Пример:

<script type='text/javascript'>
  _gcTracker.push(['view_category', { category_id: '214' }]);
</script>

Данный код обычно располагают на странице списка продуктов в продуктовой категории.

В качестве CATEGORY_ID используйте тот код категории, который через интеграцию передаётся в Loymax SmartCom.

Просмотр продукта

Добавьте вызов кода отслеживания на событие просмотра продукта:

_gcTracker.push(['view_product', { category_id: 'CATEGORY_ID' , product_id: 'PRODUCT_ID' }]);

где:

  • (string) CATEGORY_ID – идентификатор категории продукта в ваших ИС.

  • (string) PRODUCT_ID – идентификатор продукта в ваших ИС.

Пример:

<script type='text/javascript'>
  _gcTracker.push(['view_product', { category_id: '218' , product_id: '1735' }]);
</script>

Данный код обычно располагают на странице карточки продукта.

В качестве CATEGORY_ID и PRODUCT_ID используйте те коды категории и продукта, которые через интеграцию передаются в Loymax SmartCom.

Работа с контейнерами

JS-трекер позволяет управлять индивидуальными клиентскими списками товаров. Такие списки товаров в Платформе называются Контейнерами.

Примеры контейнеров:

  • Корзина (webcart);

  • Любимые товары (like_products);

  • Виш-лист;

  • Уведомить о поступлении;

  • Уведомить о снижении цены.

Контейнеры делятся на системные и пользовательские.

Операции с контейнером из JS-трекера производятся по коду контейнера. Коды наиболее часто используемых системных контейнеров указаны выше в скобках.

Управление списком зарегистрированных в Платформе контейнеров и просмотр кодов контейнеров производится в Настройках плафтормы в разделе Контейнеры.

Над контейнером определены операции:

  • Добавить товар в контейнер;

  • Удалить товар из контейнера;

  • Очистить контейнер.

Системные контейнеры не могут быть удалены. Количество пользовательских контейнеров не ограничено.

Важно!

В предыдущих версиях JS-трекера контейнеров не было, а был всего один доступный список товаров - корзина. Для работы с корзиной использовались методы трекера:

  • add_to_cart - Добавить в корзину;

  • remove_from_cart - Удалить из корзины;

  • clear_cart - Очистить корзину.

Данные методы всё еще доступны и работают, но использовать их не рекомендуется. В 2025 году эти методы будут удалены.

Добавление продукта в контейнер

Добавьте вызов кода отслеживания на событие добавление продукта в контейнер:

gcTracker.push(['add_to_container', { container: 'CONTAINER_CODE', category_id: 'CATEGORY_ID' , product_id: 'PRODUCT_ID' , quantity: 'QUANTITY', price: 'PRICE'}]);

Где:

  • (string) CONTAINER_CODE – код контейнера;

  • (string) CATEGORY_ID – идентификатор категории продукта в ваших ИС;

  • (string) PRODUCT_ID – идентификатор продукта в ваших ИС;

  • (float) QUANTITY – количество единиц продукта;

  • (float) PRICE – стоимость продукта.

Пример:

<script type='text/javascript'>
  _gcTracker.push(['add_to_container', { container: 'webcart', category_id: '218' , product_id: '1735' , quantity: '200', price: '300'}]);
</script>

Удаление продукта из контейнера

Добавьте вызов кода отслеживания на событие удаления продукта из контейнера:

gcTracker.push(['remove_from_container', { container: 'CONTAINER_CODE', category_id: 'CATEGORY_ID' , product_id: 'PRODUCT_ID' , quantity: 'QUANTITY', price: 'PRICE'}]);

Где:

  • (string) CONTAINER_CODE – код контейнера;

  • (string) CATEGORY_ID – идентификатор категории продукта в ваших ИС;

  • (string) PRODUCT_ID – идентификатор продукта в ваших ИС;

  • (float) QUANTITY – количество единиц продукта;

  • (float) PRICE – стоимость продукта.

Пример:

<script type='text/javascript'>
  _gcTracker.push(['remove_from_container', { container: 'wish_list', category_id: '218' , product_id: '1735' , quantity: '200', price: '300'}]);
</script>

Очистка контейнера

Добавьте вызов кода отслеживания на событие очистки контейнера:

gcTracker.push(['clear_container', { container: 'CONTAINER_CODE'}]);

Где:

  • (string) CONTAINER_ID – код контейнера.

Пример:

gcTracker.push(['clear_container', { container: 'webcart'}]);

Завершение оформления заказа

Добавьте вызов кода отслеживания на событие завершения оформления заказа:

_gcTracker.push(['order_complete', { order_id: 'ORDER_ID' }]);

где (string) ORDER_ID – идентификатор заказа в ваших ИС.

Пример:

<script type='text/javascript'>
  _gcTracker.push(['order_complete', { order_id: '20713' }]);
</script>

Данный код обычно располагают на странице "Спасибо, ваш заказ успешно оформлен".

В качестве ORDER_ID используйте тот идентификатор заказа, который через интеграцию передаётся в Loymax SmartCom.

Метод оформления заказа применяется к содержимому контейнера webcart.

Регистрация произвольного события

Трекер может регистрировать произвольные пользовательские события, например, подписка на новости, запись на мероприятие, подписка на появление товара в наличии. Для регистрации события добавьте вызов кода регистрации события:

_gcTracker.push(['event', { name: 'EVENT_NAME', context: 'JSON' }]);

где (string) EVENT_NAME – наименование события, которое в дальнейшем может быть использовано вами при настройке триггера "Событие сайта".

Пример:

<script type='text/javascript'>
  _gcTracker.push(['event', { name: 'news_signup', context: '[news_group: 1]' }]);
</script>

Last updated