JS-трекер

Скрипт может быть запущен триггером Трекер. Блок срабатывает каждые 5 минут (параметр невозможно изменить) и собирает статистику о действиях посетителей на сайте, в код которого встроен сниппет. Информация автоматически подгружается пакетно в систему Proceset, где объединяется с данными из других систем. Количество элементов в пакете – 1 (отправка каждого события происходит сразу). На основании полученной статистики можно проводить аналитику по выделению сценариев или процессов.

Работа трекера состоит из 3 компонентов:

• Snippet — небольшой фрагмент кода, в котором содержатся настройки подключения трекера
• Трекер — блок-триггер, который осуществляет сбор данных и их передачу на сервер
• Модуль трекинга на платформе Proceset — модуль, осуществляющий прием данных от трекера

Данные с сайта копятся в локальном хранилище и передаются JS-трекером каждые 15 секунд. В случае, если сервер не принимает отправленные данные от трекера, эти и все следующие собираемые с сайта данные будут храниться в буфере размером 1 Мб до момента, пока сервер не станет вновь доступным. После того как события будут успешно переданы, буфер очищается.

В левой панели представлены параметры блока:

• имя веб-приложения
• UUID
• адрес сервера сбора аналитики
• встраиваемый код (snippet)

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

Список возвращаемых полей по умолчанию:

Сбор кастомных событий

Кастомные события автоматически собираются с помощью параметра interceptor. В качестве значения параметра передается массив объектов.

Чтобы JS-трекер собирал кастомные события, дополните встраиваемый код:

{
    action: "Click" | "FieldChange",
    interceptor: (target: EventTarget) => {
        eventName: string,
        elementName: string,
        element: Element,
        eventProps: object
    } | null
}

Где:

• action — тип события, по которому будет вызван interceptor
• interceptor — обработчик события. Принимает элемент, по которому произошло событие, и возвращает структуру, описывающую кастомное событие. Также в коде можно указать null, если событие следует проигнорировать

В зависимости от того, какие данные необходимо получать, у параметра могут быть указаны следующие поля:

• eventName
• elementName
• element
• eventProps

Настройка сбора активности системы Proceset

Для настройки приема данных с JS-трекера, встроенного в Proceset нужно построить скрипт и добавить uuid (сгенерированный блоком Трекер) в файл конфигурации модуля трекинга com.infomaximum.subsystem.automationwebhook.json. Файл расположен на сервере Proceset в каталоге: C:\ProgramData\Infomaximum\config\com.infomaximum.subsystem. automationwebhook.json.

Пример настройки файла com.infomaximum.subsystem.automationwebhook.json для обмена данными с JS-трекером:

{
    "monitoring": {
        …
        "uuid": "7317172d2fca45ec890caf4127480484",
        …
    }
}

Параметры конфигурационного файла:

• monitoring — блок настроек, предназначенный только для передачи статистики от системы Proceset (JS-трекера, встроенного в систему). Настраивается только для передачи информации о пользователях Proceset:
  • uuid (обязательный параметр) — идентификатор данных Трекера. Используется в качестве публичного ID данных. Данный uuid используется для сопоставления конфигурации Трекера и ID скрипта, в котором будут обрабатываться данные

Настройка cors_policy для междоменного обмена данным

В случаях, когда JS-трекер находится в домене отличном от того, на котором располагается Proceset, необходимо настроить политику cors, предоставляющую доступ к этому домену. Для этого необходимо в конце конфигурационного файла Proceset com.infomaximum.subsystem.frontend.json добавить перед последней фигурной скобкой:

"cors_policy": "*"

Файл расположен на сервере Proceset в каталоге: C:\ProgramData\Infomaximum\config\com.infomaximum.subsystem.frontend.json.

Несовместимость типов при получении Null в активности

При возникновении несовместимости типов при получении Null в активности, собираемой JS-трекером, необходимо привести колонки целевой таблицы в скрипте к типу Nullable. Если таблица была создана ранее, то можно воспользоваться следующим способом устранения данной проблемы:

1. Создайте блок «SQL-запрос» в целевом скрипте.
2. Введите SQL-запрос ALTER TABLE NAME_TABLE(название таблицы) MODIFY COLUMN person_user_id Nullable(String).
3. Измените тип целевой колонки.
4. Удалите блок «SQL-запрос», созданный в п. 1 и 2.
5. Используйте обновленную таблицу с типом колонок Nullable и ранее созданным скриптом.

Способ подходит для решения любой подобной ситуации, связанной с несовместимостью типов.