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

Подписка на события виджетов

Содержание

 

Осторожно, много технической информации! :)

Общая информация

Помимо отправки данных в Google Analytics, вы можете получать расширенные данные по виджетам напрямую с вашего сайта. Ниже описывается схема подключения отслеживания событий с сайта.

Следует иметь в виду, что фиксация событий наступает с 2-секундной задержкой. Все события, которые наступают одновременно или с небольшой разницей во времени, добавляются в очередь на отправку. После прохождения таймаута все события отправляются на сервер в виде массива событий.

 

Подписка на события

Для получения событий от виджетов, необходимо добавить в объект window функцию под названием calltouchEvent. Пример:

window.calltouchEvent = function(events)

{ ... }

Где параметр events является массивом объектов (событий), которые имеют следующую структуру:

action: 'show' // строка, обозначающая тип действия. Возможные варианты: 'show', 'close', 'create', 'fail', 'click'

object: 'widget-form' // строка, обозначающая элемент, с которым произошло событие. Возможные варианты: 'widget-form', 'widget-button', 'widget-button-dialog', 'widget-request', 'multi-button-button', 'multi-button-carousel', 'multi-button-buttons' // объект с подробным описанием события

data: {

actionType: 'auto' // строка, обозначающая, по какому типу произошло событие (ручное или авто). Возможные значения: 'auto', 'manual'

isMobile: false // булево значение, обозначающее, произошло ли событие в мобильном устройстве, или в веб

isMultiButton: false // булево значение, обозначающее, произошло ли событие в мультикнопке или в одиночном виджете

sessionId: 555 // числовое значение, ID сессии

siteId: 555 // числовое значение, ID сайта

widgetId: 555 // числовое значение, ID виджета

widgetType: 'request' // строковое значение, обозначающее тип виджета. Возможные значения: 'callback', 'request', 'promotion', 'calltovisit', 'whatsapp-messenger', 'telegram-messenger', 'vk-messenger', 'facebook-messenger'

workMode: 'working_hours' // строковое значение, обозначающее в какое время произошло событие (рабочее или нерабочее). Возможные значения: 'working_hours', 'non_working_hours'

}

 

Формат события

Объекты виджетов

Кнопка виджета (widget-button)

Типы виджетов, на которых может возникать событие:

Действия:

  • show - показ кнопки

Данные события:

  • widgetId - идентификатор виджета, над объектом которого было произведено действие 
  • widgetType - тип виджета, над объектом которого было произведено действие 
  • siteId - идентификатор сайта, виджет которого сработал
  • sessionId - идентификатор сессии, в рамках которой произошло событие
  • workMode - режим работы виджета, может принимать одно из 2 значений
    • working_hours - рабочее время
    • non_working_hours - нерабочее время
  • actionType - тип действия, может принимать одно из 2 значений
    • manual - действие произведено пользователем
    • auto - действие произведено автоматически (по таймеру или автоматически происходит при загрузке в соотвествии с наcтройками виджета)
  • isMobile - флаг, мобильное ли устройство, на котором произошло событие
  • isMultiButton - флаг, был ли виджет, над объектом которого было произведено действие , в составе мультикнопки

 

Всплывающий диалог виджета (widget-button-dialog)

Типы виджетов, на которых может возникать событие:

  • callback
  • promotion
  • request
  • calltovisit

Действия:

  • show - показ всплывающего диалога
  • close - закрытие всплывающего диалога

Данные события:

  • widgetId - идентификатор виджета, над объектом которого было произведено действие 
  • widgetType - тип виджета, над объектом которого было произведено действие 
  • siteId - идентификатор сайта, виджет которого сработал
  • sessionId - идентификатор сессии, в рамках которой произошло событие
  • workMode - режим работы виджета, может принимать одно из 2 значений
    • working_hours - рабочее время
    • non_working_hours - нерабочее время
  • actionType - тип действия, может принимать одно из 2 значений
    • manual - действие произведено пользователем
    • auto - действие произведено автоматически (по таймеру или автоматически происходит при загрузке в соотвествии с настройками виджета)
  • isMobile - флаг, мобильное ли устройство, на котором произошло событие
  • isMultiButton - флаг, был ли виджет, над объектом которого было произведено действие , в составе мультикнопки

 

Форма виджета (widget-form)

Типы виджетов, на которых может возникать событие:

  • callback
  • promotion
  • request
  • calltovisit

Действия:

  • show - показ формы
  • close - закрытие формы

Данные события:

  • widgetId - идентификатор виджета, над объектом которого было произведено действие 
  • widgetType - тип виджета, над объектом которого было произведено действие 
  • siteId - идентификатор сайта, виджет которого сработал
  • sessionId - идентификатор сессии, в рамках которой произошло событие
  • workMode - режим работы виджета, может принимать одно из 2 значений
    • working_hours - рабочее время
    • non_working_hours - нерабочее время
  • actionType - тип действия, может принимать одно из 2 значений
    • manual - действие произведено пользователем
    • auto - действие произведено автоматически (по таймеру или автоматически происходит при загрузке в соотвествии с настройками виджета)
  • isMobile - флаг, мобильное ли устройство, на котором произошло событие
  • isMultiButton - флаг, был ли виджет, над объектом которого было произведено действие , в составе мультикнопки

 

Заявка с виджета (widget-request)

Типы виджетов, на которых может возникать событие:

  • callback
  • promotion
  • request
  • calltovisit
  • user-form

Действия:

  • create - заявка создана успешна
  • fail - в ходе отправки заявки произошла ошибка

Данные события:

  • widgetId - идентификатор виджета, над объектом которого было произведено действие 
  • widgetType - тип виджета, над объектом которого было произведено действие 
  • siteId - идентификатор сайта, виджет которого сработал
  • sessionId - идентификатор сессии, в рамках которой произошло событие
  • workMode - режим работы виджета, может принимать одно из 2 значений working_hours - рабочее время, non_working_hours - нерабочее время
  • actionType - тип действия, может принимать одно из 2 значений
    • manual - действие произведено пользователем
    • auto - действие произведено автоматически (по таймеру или автоматически происходит при загрузке в соотвествии с настройками виджета)
  • isMobile - флаг, мобильное ли устройство, на котором произошло событие
  • isMultiButton - флаг, был ли виджет, над объектом которого было произведено действие , в составе мультикнопки
  • timePeriodType - тип временного периода, на которое заказана заявка, может принимать одно из 2 значений
    • now - выполнить сейчас
    • exact - выполнить в конкретное время
 

Объекты мультикнопки

Кнопка мультикнопки (multi-button-button)

Действия:

  • show - показана кнопка мультикнопки

Данные события:

  • siteId - идентификатор сайта, виджет которого сработал

  • sessionId - идентификатор сессии, в рамках которой произошло событие

 

"Карусель" мультикнопки (multi-button-carousel)

Действия:

  • show - открыта карусель мультикнопки

  • close - закрыта карусель мультикнопки

Данные события:

  • siteId - идентификатор сайта, виджет которого сработал

  • sessionId - идентификатор сессии, в рамках которой произошло событие

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 1
Еще есть вопросы? Отправить запрос

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

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