Наверх
Подписаться

Установка модуля и описание событий

Содержание

 

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

Включение модуля

Включение модуля электронной торговли происходит в меню «Настройки - Статистика». После включения модуля вам станет доступен блок с выбором валюты, который может принимать два значения: рубли и доллары.

______________2019-05-28___10.35.26.png

Включение модуля добавляет следующий функционал к вашему проекту:

  1. Открывает в меню дополнительный отчет «Электронная торговля»
  2. Добавляет в пользовательские столбцы новый блок метрик «Электронная торговля»
  3. Добавляет во все таблицы, в настройки столбцов, блок метрик «Электронная торговля»
  4. Добавляет в группу метрик «Сделки и ROI» данные, собранные модулем
  5. Позволяет скрипту подмены принимать от сайта события, связанные с электронной торговлей.

 

Установка модуля

Важно! Модуль электронной торговли работает только с новым скриптом Calltouch. 

Для использования модуля электронной торговли необходимо в секции сайта head удалить новый скрипт Calltouch и разместить следующий код, заменив в конце скрипта counter-id на идентификатор сайта (mod_id. О том, где взять mod_id, прочитайте инструкцию):

!function(t,c,e,a){t.CalltouchDataObject=e,t.ct=function(){var c=[].slice.call(arguments),e=c[0],a=c.slice(1);t.ct.callbacks.push({method:e,args:a,id:performance.now().toString()})},t.ct.callbacks||(t.ct.callbacks=[]);var n=c.getElementsByTagName("script")[0],o=c.createElement("script"),r=function(){n.parentNode.insertBefore(o,n)};o.type="text/javascript",o.async=!0,o.src="https://mod.calltouch.ru/init.js?id="+a,"[object Opera]"==t.opera?c.addEventListener("DOMContentLoaded",r,!1):r()}(window,document,"ct","counter-id");

 

Важно! Если на вашем сайте уже существует глобальный объект ct, вы можете его переименовать, передав любое имя третьим параметром в коде вставки (вместо 'ct').


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

ct('send_ecommerce', 'method-name', {params});

где method-name — имя метода, а params — параметры вызова:

  • id: идентификатор действия
  • products: Array<product> - массив объектов с описанием товаров
  • product: данные о товаре

 

Где взять mod_id?

mod_id - уникальный идентификатор скрипта, который можно получить по запросу в тех.поддержу info@calltouch.net, либо просто скопировать уже готовый скрипт с сгенерированным идентификатором из настроек вашего проекта в Личном кабинете Calltouch:

Screenshot_12.png

 

Данные о товаре

Ниже представлена таблица, содержащая перечень полей, их тип и описание, которые передаются в параметрах вызова {params}.

Поле Тип Описание
id * string Идентификатор товара.
Пример: "10012"
name string Название товара.
Пример: "USB-удлинитель"
price int | float Стоимость товара.
Пример: 150.50
brand string Бренд, торговая марка.
Пример: "xiaomi"
category string Категория товара.
Пример: "кабели, шнуры, переходники"
variant string Разновидность товара.
Пример: "длина шнура: 5м"
margin int | float Маржа.
Пример: 150.50
quantity int Количество товаров.
Пример: 1

* — поле id является обязательным для всех типов запросов. Поле quantity является обязательным только для метода refund.

 

Отправка событий в Calltouch

Ниже представлены методы и примеры отправки событий по ним.

Просмотр товаров. Метод detail.

Когда отправлять эти события: при просмотре товара/товаров на сайте.

Пример отправки события:

ct('send_ecommerce', 'detail', {
products: [{
id: 1003,
name: "USB-удлинитель",
price: 150.50,
brand: "xiaomi",
category: "кабели, шнуры, переходники",
variant: "длина шнура: 5м",
margin: 150.50
}, {
id: 1005,
name: "Наушники",
price: 2000.00,
brand: "JBL",
category: "Наушники проводные",
variant: "Черные",
margin: 1000.00
}]
});

Список товаров не должен быть пустым

 

Добавлен в корзину. Метод addToCart.

Когда отправлять эти события: при добавлении товара в корзину.

Пример отправки события: 

ct('send_ecommerce', 'addToCart', {
products: [{
id: 1003,
name: "USB-удлинитель",
price: 150.50,
brand: "xiaomi",
category: "кабели, шнуры, переходники",
variant: "длина шнура: 5м",
margin: 150.50,
quantity: 1;
}, {
id: 1005,
name: "Наушники",
price: 2000.00,
brand: "JBL",
category: "Наушники проводные",
variant: "Черные",
margin: 1000.00,
quantity: 2;
}]
});

Список товаров не должен быть пустым

 

Удален из корзины. Метод removeFromCart.

Когда отправлять эти события: товар/товары удалены из корзины.

Пример отправки события:

ct('send_ecommerce', 'removeFromCart', {
products: [{
id: 1003,
name: "USB-удлинитель",
price: 150.50,
brand: "xiaomi",
category: "кабели, шнуры, переходники",
variant: "длина шнура: 5м",
margin: 150.50,
quantity: 1;
}, {
id: 1005,
name: "Наушники",
price: 2000.00,
brand: "JBL",
category: "Наушники проводные",
variant: "Черные",
margin: 1000.00,
quantity: 1;
}]
});

Список товаров не должен быть пустым

 

Оформление покупки. Метод checkout.

Когда отправлять эти события: пользователь закончил оформление покупки.

Пример отправки события:

ct('send_ecommerce', 'checkout', {
products: [{
id: 1003,
name: "USB-удлинитель",
price: 150.50,
brand: "xiaomi",
category: "кабели, шнуры, переходники",
variant: "длина шнура: 5м",
margin: 150.50,
quantity: 1;
}, {
id: 1005,
name: "Наушники",
price: 2000.00,
brand: "JBL",
category: "Наушники проводные",
variant: "Черные",
margin: 1000.00,
quantity: 1;
}]
});

Список товаров не должен быть пустым

 

Оплата. Метод purchase.

Когда отправлять эти события: транзакция успешно совершена.

Пример отправки события:

ct('send_ecommerce', 'purchase', {
id: "10031004";
products: [{
id: 1003,
name: "USB-удлинитель",
price: 150.50,
brand: "xiaomi",
category: "кабели, шнуры, переходники",
variant: "длина шнура: 5м",
margin: 150.50,
quantity: 1;
}, {
id: 1005,
name: "Наушники",
price: 2000.00,
brand: "JBL",
category: "Наушники проводные",
variant: "Черные",
margin: 1000.00,
quantity: 1;
}]
});

Список товаров не должен быть пустым. Обязательным также является параметр id (идентификатор транзакции с вашего сайта, по которому потом можно сделать отмену).

 

Отмена оплаты. Метод refund.

Частичная отмена

Когда отправлять эти события: происходит частичный возврат ил отказ от покупки.

Пример отправки события:

ct('send_ecommerce', refund', {
id: "10031004";
products: [{
id: 1003,
quantity: 1;
}]
});

Обязательным является параметр id (идентификатор транзакции), а также список товаров с указанием поля quantity для каждого товара.

 

Полная отмена

Когда отправлять эти события: происходит полный возврат или отказ от покупки.

Пример отправки события:

ct('send_ecommerce', refund', {
id: "10031004";
});

Обязательным является параметр id (идентификатор транзакции), список товаров не передается.

 

Отключение модуля

Важный пункт!

Отключение модуля приведет к отключению некоторых возможностей. Пропадут:

  1. Все пользовательские столбцы (целиком), содержащие в себе метрики из блока электронной коммерции.
  2. Если метрики из этого блока являлись частью воронок продаж на дашбордах, они исчезают из этих воронок. Если в воронке, после исчезновения, не остается ни одной метрики, пропадает вся воронка из дашборда.
  3. Из сохраненных наборов столбцов таблиц пропадают метрики из этого блока. Если в наборе, после исчезновения, не останется ни одной метрики, исчезает весь набор.
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
Еще есть вопросы? Отправить запрос

0 Комментарии

Войдите в службу, чтобы оставить комментарий.