Аналитика кликов сайта

1.0.1 (07.10.2024)

Устранена ошибка выбора пользователя для возможности последующего удаления данных статистики для сайтов под лицензией Битрикс Управление Сайтом в диалоговом окне "Настройка параметров удаления" на странице "Администрирование" в административной части портала.

Внимание!!! Решение работает на последних версиях Google Chrome, Opera, Microsoft Internet Explorer, Microsoft Edge, поддерживающих HTML5.

Перед установкой
Необходимо установить модуль «Миграции для разработчиков». Без установки данного решения установка модуля «Аналитика кликов сайта» невозможна.

Установка модуля
Для установки модуля необходимо выполнить следующие действия:
       1. перейти в раздел «Маркетплейс» в административной части сайта;
       2. найти решение «Аналитика кликов сайта» в перечне решений сайта;
       3. нажать в меню с названием решения кнопку «Установить», как показано на рисунке ниже.            В результате данных действий будет осуществлен переход на страницу установки модуля, как показано на рисунке ниже;                                                                                                                                            
Настройки модуля:
Настройки модуля расположены в административной части портала по пути Настройки -> Настройки продукта -> Настройки модулей -> Аналитика кликов сайта и представлены на следующих вкладках:

• «Настройки».
  

               На данной вкладке возможно определить следующие настройки:
                       - «Активность» - активен ли модуль (по умолчанию - активен);
                       - «Тип системы»:
                               - Битрикс24 (значение по умолчанию);
                               - Битрикс Управление сайтом;
                       - «Тип хранилища информации о кликах»:
                               - «Локальное (в БД сайта) (значение по умолчанию)»;
                               - «Удаленное (удаленный сервер)». При выборе данного значения добавляется опция «API URL» (строка для ввода IP-адреса удаленного сервера, например,
                               «196.217.24.138» и кнопка «Тест подключения» для проверки соединения с удаленным сервером;

• «Основное».
  

               На данной вкладке возможно определить следующие настройки:
                       - «Частота отправки данных о посещении страницы, с» - частота отправки данных о посещении страницы на удаленный сервер в секундах (по умолчанию - 10 с).                                      Рекомендуется отправлять данные на сервер с частотой в 10 секунд. Такая частота отправки позволит в случае возникновения нештатной ситуации, а именно:
                               - закрытия вкладки браузера, при критической ошибке,
                               - закрытия браузера, при критической ошибке,
                               - потери соединения интернета, на длительный срок,
                               - сбоя операционной системы
                          сохранить максимально точно время завершения просмотра страницы;
                       - «Цвет подложки тепловой карты кликов» - цвет в формате HEX подложки тепловой карты кликов (по умолчанию - «#2e2d93»);
                       - «Прозрачность подложки тепловой карты, %» - прозрачность подложки тепловой карты выраженная в процентах (по умолчанию - «25»);
                       - «Руководителей подразделений» - доступен ли функционал модуля помимо администратора портала еще и руководителям подразделения (только для сайтов                                       Битрикс24);
                       - «Пользователей»:
                               - пользователи, которым доступно построение тепловой карты кликов и статистики посещения страниц пользователей в случае сайта с лицензией БУС;
                               - руководители подразделений в случае сайта с лицензией Битрикс24;

• «Доступ».
  

               На данной вкладке возможно определить уровень доступа к настройкам модуля для определенных групп пользователей (штатный функционал Битрикс).

Настройки удаления статистики
Существует возможность удаления статистики в следующих режимах:

• по расписанию;
  
• вручную.
  

Внимание!!! Удаление данных возможно только той статистики, данные о которой хранятся в БД Битрикс.

Для того, чтобы приступить к настройке удаления статистики, необходимо перейти в административную часть сайта по пути Сервисы -> Администрирование в подразделе (Аналитика кликов сайта), как показано на рисунке ниже.                                                                                                                                                                                                                                                                                                                                                                                                               Рис. 6 - Пример отображения экранной формы «Администрирование»

Удаление по расписанию
Для того, чтобы установить удаление статистики по расписанию необходимо выполнить следующие действия:
       1. установить в значении поля «Удаление данных статистики» одно из следующих значений:
               а. «старше 1 месяца» - удаляются данные срок давности которых превышает 1 месяц;
               b. «старше 3 месяцев» - удаляются данные, срок давности которых превышает 3 месяца;
               с. «старше полгода» - удаляются данные, срок давности которых превышает полгода;
               d. «старше года» - удаляются данные, срок давности которых превышает 1 год;
               e. «старше числа дней» - удаляются данные, срок давности которых превышает заданное количество дней. При выборе данного значения справа от поля отображается                  поле для ввода количества дней;
       2. выбрать в поле «Дата и время начала удаления статистики» дату и время начала удаления статистики в календаре, который будет отображен при попытке ввода данных в                поле;
       3. нажать на кнопку «Применить». В результате данных действий будет отображено диалоговое окно «Подтверждение удаления данных», как показано на рисунке ниже;                                                                                                                                                                                                         Рис. 7 - Пример отображения диалогового окна «Подтверждение удаления данных»
       4. нажать на кнопку «Удалить».
В результате данных действий будет создан агент, который по расписанию будет удалять необходимые к удалению данные статистики.

Удаление вручную
Существует возможность удалить данные статистики как за все время, так и только той, что соответствует параметрам фильтрации.
Для того, чтобы удалить всю статистику, необходимо выполнить следующие действия:

1. установить в значении поля «Удаление данных статистики» следующее значение «за все время»;
   
2. выбрать, из каких таблиц следует удалять статистику (о кликах или о посещении страниц портала или и тех, и других) посредством отметки флажком полей «Кликов» и «О посещении страниц»;
   
3. нажать на кнопку «Применить». В результате данных действий будет отображено диалоговое окно «Подтверждение удаления данных», как показано на рисунке 7;
   
4. нажать на кнопку «Подтвердить».
   

В результате данных действий будет удалена вся раннее собранная статистика из выбранных таблиц.

Для того, чтобы удалить только определенную статистику, необходимо выполнить следующие действия:
       1. нажать на кнопку «Удалить принудительно». В результате данных действий будет отображено диалоговое окно «Настройка параметров удаления», как показано на рисунке                ниже;                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    Рис. 8 - Пример отображения диалогового окна «Настройка параметров удаления»
       2. выбрать значение из списка «Удалить данные статистики»:
               a. «за этот месяц» - удаляются данные полученные в текущем месяце;
               b. «за прошлый месяц» - удаляются данные полученные в прошлом месяце;
               с. «за эту неделю» - удаляются данные полученные за текущую неделю;
               d. «за прошлую неделю» - удаляются данные полученные за прошлую неделю;
               e. «за последнюю неделю» - удаляются данные полученные за последние 7 дней;
               f. «позже» - удаляются данные полученные позже указанной даты. При выборе данного значения под списочным полем будет отображено поле для ввода даты. При                               попытке ввода будет отображен календарь для выбора даты;
               g. «раньше» - удаляются данные полученные ранее указанной даты. При выборе данного значения под списочным полем будет отображено поле для ввода даты. При                           попытке ввода будет отображен календарь для выбора даты;
               h. «за интервал» - удаляются данные полученные в интервале между выбранными датами. При выборе данного значения под списочным полем будут отображены поля                          для ввода даты. При попытке ввода будет отображен календарь для выбора даты;
               i. «по вхождению в ссылке» - удаляются данные полученные при нахождении пользователей на страницах сайта у который в URL входит указанное значение;
               j. «пользователя(-ей)» - удаляются данные полученные для указанного(-ых) пользователя(-ей) (штатный функционал выбора пользователей Битрикс);
       3. выбрать, из каких таблиц следует удалять статистику (о кликах или о посещении страниц портала или и тех, и других) посредством отметки флажком полей «Кликов» и «О                  посещении страниц»;
       4. нажать на кнопку «Удалить». В результате данных действий будет открыто диалоговое окно «Подтверждение удаления данных», как показано на рисунке 7;
       5. нажать на кнопку «Удалить».
В результате данных действий будут удалены данные статистики, подпадающие под действие заданного фильтра.

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

1. установить в значении поля «Удаление данных статистики» следующее значение «не используется»;
   
2. выбрать, из каких таблиц не следует удалять статистику (о кликах или о посещении страниц портала или и тех, и других) посредством отметки флажком полей «Кликов» и «О посещении страниц»;
   
3. нажать на кнопку «Применить». В результате данных действий будет отображено диалоговое окно «Подтверждение удаления данных», как показано на рисунке 7;
   
4. нажать на кнопку «Удалить».
   

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

Удаленная БД
Архив с файлами проекта для работы удаленной БД под управлением фреймворка Symfony, а также скрипты для создания таблиц удаленной БД находятся в файлах модуля. Данный проект является примером и требует наличие навыков в администрировании для развертывания удаленной БД. Если существует необходимость в развертывании других удаленных БД, необходимо использовать содержимое файлов, приведенных в примере.

По всем вопросам, связанным с работой модуля, необходимо обращаться по адресу: lion.bitrix24@gmail.com