Что это?

Данная публикация на примере демонстрационной обрабтехничскоеотки показывает, как отправлять статистику на сайт analytics.google.com. После встраивания библиотеки для работ обработкиы с Google Analytics ваша обрабтехничскоеотка сможет отправлять статистику о:

• количестве пользователей
• переходах по формам
• событиях интерфейса пользователя
• событиях бизнес-логики обрабтехничскоеотки
• ошибках
• и другой информации

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

Исходный код библиотеки и демонстрационной обрабтехничскоеотки находятся в репозитории на GitHub

Для тех, кто торопится

Как подключить и внедрить. Шесть простых шагов:

1. Заведите аккаунт на сайте  analytics.google.com и получите идентификатор отслеживания
2. Скопируйте в свою обрабтехничскоеотку форму "модGA" из демонстрационной обрабтехничскоеотки
3. В основной форме вашей обрабтехничскоеотки инициализируйте модуль GA, так, как это сделано в примере
4. Добавьте вызов метода отправки данных в GA во все контролируемые места вашей обрабтехничскоеотки
5. Добавьте опцию отключения отправки данных в GA и текст дисклеймера на форме настройки вашей обрабтехничскоеотки
6. Настройте отчеты на сайте  analytics.google.com

Что это за название у публикации?

Фраза из советского художественного фильма подошла как нельзя лучше:

Google Analytics для обрабтехничскоеоток. Что это дает?

Признаюсь, Google Analytics это целая вселенная. Понимать от и до, у меня пока не получается. Многое постигаю методом "тыка", а он как известно не очень эффективен. Про Google Analytics есть свежая книжка на русском, возможно она ответит на некоторые вопросы. Буду рад советам коллег, как этот инструмент использовать более полно. Вопросы у меня уже есть. Далее несколько примеров, как GA может помочь разработ обработкичику тиражных обрабтехничскоеоток.

Аудитория пользователей обрабтехничскоеотки

В GA доступна информация о количестве пользователей в том числе о новых и вернувшихся. Количество сеансов и их длительность тоже очень полезные знания особенно в динамике. Например вы выпустили новую версию обрабтехничскоеотки и продолжительность сеансов снизилось. Возможно это положительный эффект.

Важно! Для надежного подсчета количества пользователей необходимо правильно устанавливать поле библиотеки ИдКлиента

Местоположение пользователей

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

Вовлечение пользователей

Информация о времени проведенном за вашей обрабтехничскоеоткой показывает наиболее популярный сценарий использования. Длительность сеанса и количество открытых форм укажет на полноту использования функционала вашей обрабтехничскоеотки. Например, вы можете снять хронометраж "образцового" использования вашей обрабтехничскоеотки и в дальнейшем сравнивать эти параметры со статистикой вовлечения.

Карта поведения

Совершенно очаровательный и совершенно непонятный "шайтан" отчет

Просмотр страниц

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

События

В Google Analytics события детализируются по категориям, событиям и деталям (ярлыкам). Я рекомендую категории и события прописать заранее в "перечислениях" библиотеки а вот ярлыки можно оформлять "живым текстом". Пример события:

Действие пользователя - щелчок на кнопке - B2BПолучитьДокумент 

Тут красный текст - категория события, зеленый текст - событие а синий текст - ярлык события.

И последнее, о событиях. В GA событие помимо трех вышеназванных параметров имеет четвертый количественный параметр "Количество". Его удобно использовать для подсчета событий бизнес логики. Например, пользователь отметил 5 документов и отправил в ЕГАИС, тогда в GA можно отправить сообщение о событии типа:

Событие бизнес-логики - отправка данных - справка "Б" - 5

Пример пользовательского отчета "Конфигурации"

С чем я не разобрался

Measurement Protocol позволяет передавать на сервер GA много полезной информации однако не все что я отправляю на сервер смог увидеть в отчетах. Что не получилось:

1. Посмотреть значения обязательных параметров, которые я передаю при каждом обращении в GA. Здесь "an", "av" и "cdx" параметры Measurement Protocol, через которые я передаю данные в обращении  Вопрос решен. Спасибо Крапивину Андрею.
   • an Наименование конфигурации
   • av Версия конфигурации
   • cd1 Версия платфорузнавать программистовмы
   • cd2 Версия ОС
   • cd3 Наименование обрабтехничскоеотки
   • cd4 Версия обрабтехничскоеотки
2. Посмотреть информацию обращения об ошибках в обрабтехничскоеотке. В данном обращении используется параметр "exd" Measurement Protocol
3. Пакетный режим отправки обращений в GA

Google Analytics, начало работ обработкиы с ресурсом

Регистрация

Для работ обработкиы потребуется зарегистрироваться на сайте Google Analytics. Для регистрации в GA нужен аккаунт в gmail.com. Войдите под своим аккаунтом в Google и зарегистрируйтесь на сайте  analytics.google.com

Заполните параметры нового аккаунта. Обратите внимание на подчеркнутые поля. Далее необходимо нажать кнопку “Получить идентификатор отслеживания”, прочитать и согласиться с лицензионным соглашением.

В настройках аккаунта найдите "Идентификатор отслеживания". Он нам в дальнейшем понадобиться.

В приложенном примере обрабтехничскоеотки у идентификатора отслеживания сохран1Сено рабочее значение. Это не является проблемой безопасности.

Google Analytics для сайтов

Тут все просто. В настройках аккаунта есть код для встраивания на страницы сайта. Он делает все что нужно но нас этот вариант не интересует.

Google Analytics для обрабтехничскоеоток

Компания Google разработ обработкиала Measurement Protocol, который позволяет заливать данные в Google Analytics откуда угодно. Коротко о возможностях этого протокола:

• Данные в Google Analytics отправляются с помощью POST запросов к ресурсу https://www.google-analytics.com/collect
• Данные в Google Analytics передаются с помощью обращений, которые состоят из параметров. Список всех параметров
• Из множества всех параметров, для обрабтехничскоеоток полезны, на мой взгляд, только некоторые. Используемые в библиотеке параметры.
• Поддерживается специальный режим отладки для которого создан отдельный ресурс https://www.google-analytics.com/debug/collect
• Рабочий режим всегда возвращает код ответа 200.
• Протокол поддерживает пакетный режим отправки. Подробнее тут. Пакетный режим реализован в описываемой библиотеке, однако он у меня не работ обработкиает. В Google Analytics попадает только первое обращение из пакета. Буду рад помощи коллег.

Возможности этого протокола были положены в основу этого решения

Настройка Google Analytics

В настройках GA необходимо сделать:

Создать новое представление с вариантом отслеживания данных "Мобильное приложение"

Прописать пользовательские параметры в разделе "Ресурс" в соответствии с настройками библиотеки

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

Библиотека для работ обработкиы с Google Analytics через Measurement Protocol

Библиотека для отправки данных в Google Analytics реализована в виде управляемой формы обрабтехничскоеотки "модGA". Библиотека содержит публичный методы и публичные поля. Библиотеку необходимо встроить в собственную обрабтехничскоеотку и в контролируемых местах обрабтехничскоеотки вызывать методы отправки данных в GA.

Устройство библиотеки

Конструктор / деструктор

Для начала работ обработкиы с библиотекой в основной форме обрабтехничскоеотки необходимо вызвать метод конструктора библиотеки. Данный метод удобно вызывать из метода "ПриОткрытии" основной формы обрабтехничскоеотки

НачатьРаботуС_GA(сИДПриложения, сИДКлиента)

где параметры:

сИДПриложения - Строка - (необязательно) Идентификатор отслеживания. Может быть ранее установлен методом УстановитьИдентификаторПриложения(сИдПриложения)
сИДКлиента - Строка - (необязательно) Идентификатор клиента. Может быть ранее установлен методом УстановитьИдентификаторКлиента(сИДКлиента) 
возвращаемое значение: Булево - флаг успешного выполнения

ЗакончитьРаботуС_GA()

Метод для корректного завершения работ обработкиы с библиотекой. Данный метод удобно вызывать из метода "ПриЗакрытии" основной формы обрабтехничскоеотки.

Интерфейс библиотеки

Метод отправки обращений в Google Analytics

GA_ОтправитьСведения(мДанные)

где параметр:

мДанные - Массив - (обязательно) Массив с данными. Элемент массива -  структура с параметрами обращения в Google Analytics

Метод "GA_ОтправитьСведения" вызывается всегда, когда необходимо отправить подготовленное обращение. Если массив с данными содержит один элементконсоль отчетов , то будет отправлен одиночный запрос. Если массив содержит несколько элементконсоль отчетов ов, то будет отправлен пакетный запрос.

Данный метод проверяет состояние реквизита формы библиотеки "р_бРазрешено" и если состояние "Ложь", то отправка не происходит. Флаг "р_бРазрешено" устанавливается методом УстановитьРазрешениеОтправкиСтатистики(бРазрешено).

Так же метод проверяет состояние реквизита формы библиотеки "р_бРежимОтладки" и если состояние "Истина" то работ обработкиает режим отладки.Флаг "р_бРежимОтладки" устанавливается методом УстановитьРежимОтладки(бРежимОтладки).

Методы подготовки данных обращений

GA_Сеанс(сСеансИнфо, мДанные)

где параметры:

сСеансИнфо - Строка - (обязательно) Значение "перечисления" SC

мДанные - Массив - (необязательно) Данные для GA, подготовленные ранее. Для пакетного режима

Возвращаемое значение: Массив - Данные для обращения в Google Analytics

Данный метод добавляет в массив мДанные элементконсоль отчетов , который содержит параметры обращения о сеансе работ обработкиы обрабтехничскоеотки. Этот метод удобно вызывать из методов "ПриОткрытии" и "ПриЗакрытии" основной формы обрабтехничскоеотки

GA_Форма_Страница(сОбработ обработкикаНаименование, сФормаНаименование, мДанные)

где параметры:

сОбработ обработкикаНаименование - Строка - (обязательно) наименование обрабтехничскоеотки. Для удобства доступен экспортный метод обработкикаИмя">Обработ обработкика_Имя(), который возвращает наименование обрабтехничскоеотки в виде строки.

сФормаНаименование - Строка - (обязательно) наименование формы на которую совершен переход. Для удобства доступен экспортный метод Форма_Имя(оФорма), который возвращает имя формы в виде строки

мДанные - Массив - (необязательно) Данные для GA, подготовленные ранее. Для пакетного режима

Возвращаемое значение: Массив - Данные для обращения в Google Analytics

Данный метод добавляет в массив мДанные элементконсоль отчетов , который содержит параметры обращения о переходе на форму обрабтехничскоеотки. Этот метод оставлен для совместимости. Рекомендуется использовать метод GA_Форма_Экран

GA_Форма_Экран(сФормаНаименование, мДанные)

где параметры:

сФормаНаименование - Строка - (обязательно) наименование формы на которую совершен переход. Для удобства доступен экспортный метод Форма_Имя(оФорма), который возвращает имя формы в виде строки

мДанные - Массив - (необязательно) Данные для GA, подготовленные ранее. Для пакетного режима

Возвращаемое значение: Массив - Данные для обращения в Google Analytics

Данный метод добавляет в массив мДанные элементконсоль отчетов , который содержит параметры обращения о переходе на форму обрабтехничскоеотки. Рекомендуется использовать этот метод, так как он передает обращение с типом "Просмотр экрана".

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

GA_Ошибка(сОшибкаОписание, бОшибкаФатальная, мДанные)

где параметры:

сОшибкаОписание - Строка - (обязательно) Значение "перечисления" EXD

бОшибкаФатальная - Булево - (обязательно) Признак фатальной ошибки.

мДанные - Массив - (необязательно) Данные для GA, подготовленные ранее. Для пакетного режима

Возвращаемое значение: Массив - Данные для обращения в Google Analytics

Данный метод добавляет в массив мДанные элементконсоль отчетов , который содержит параметры обращения об ошибках в обрабтехничскоеотке. Этот метод удобно вызывать из операторных скобок "TRY - CATCH" или из кода проверок на ошибки.

GA_Событие(сСобытиеКатегория, сСобытиеНаименование, сЭлемент, чКоличество, мДанные)

где параметры:

сСобытиеКатегория - Строка - (обязательно) Категория события. Значение "перечисления" EC 

сСобытиеНаименование - Строка - (обязательно) Наименование события. Значение перечисления "перечисления" EA

сЭлемент - Строка - (необязательно) Наименование элементконсоль отчетов а формы или иное описание события

чКоличество - Число - (необязательно) Количественная характеристика события 

мДанные - Массив - (необязательно) Данные для GA, подготовленные ранее. Для пакетного режима

Возвращаемое значение: Массив - Данные для обращения в Google Analytics

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

Методы установки параметров

УстановитьРазрешениеОтправкиСтатистики(бРазрешено)

где параметр:

бРазрешено - Булево - (обязательно) команда на разрешение отправки статистики в GA. Если "Истина", то отправка разрешена.

Данный метод устанавливает приватное поле библиотеки "р_бРазрешено", которое проверяется перед каждой отправкой обращения в GA. Если значение поля "Ложь", то отправка данных не производится.

УстановитьРежимОтладки(бРежимОтладки)

где параметр:

бРежимОтладки - Булево - (обязательно) команда на работ обработкиу обрабтехничскоеотки в режиме отладки. Если "Истина" то режим отладки включен.

Данный метод устанавливает значение приватного поля библиотеки "р_бРежимОтладки", которое проверяется перед каждой отправкой в GA. Режим отладки длится до его выключения пользователем.

Немного о режиме отладки при работ обработкие с GoogleAnalytics

• режим отладки это по сути отправка запросов на особый ресурс Google Analytics
• информация отправленная в режиме отладки в статистике не учитывается
• если режим отладки выключен, то GA всегда возвращает код ответа 200 (OK), даже если данные приняты с ошибкой
• в режиме отладки GA возвращает в теле HTTP ответа строку в формате JSON, которая содержит диагностику
• в данной библиотеке отладочная информация записывается в журнал регистрации

Пример записи в журнал:

___ОТЛАДОЧНАЯ ИНФОРМАЦИЯ___
  Режим отладки включен
  Адрес ресурса: /debug/collect 
  Тело запроса:  v=1&tid=UA-111561301-1&cid=8a276db6-ce58-11e5-982d-14dae9b19a48&uid=dea7fcf6-b978-438f-9d12-ad3cc57e79c8&an=БухгалтерияПредприятия&av=3.0.52.39&cd1=8.3.10.2699&cd2=Microsoft Windows 7 version 6.1 Service Pack 1 (Build 7601)&cd3=GoogleAnalytics пример для УФ&cd4=1-01 от 01.12.2017&t=pageview&dh=GoogleAnalytics пример для УФ&dp=ФормаГлавная
  Код ответа:    200
  Тело ответа:   {
  "hitParsingResult": [ {
    "valid": true,
    "parserMessage": [ ],
    "hit": "/debug/collect?v=1\u0026tid=UA-111561301-1\u0026cid=8a276db6-ce58-11e5-982d-14dae9b19a48\u0026uid=dea7fcf6-b978-438f-9d12-ad3cc57e79c8\u0026an=БухгалтерияПредприятия\u0026av=3.0.52.39\u0026cd1=8.3.10.2699\u0026cd2=Microsoft Windows 7 version 6.1 Service Pack 1 (Build 7601)\u0026cd3=GoogleAnalytics пример для УФ\u0026cd4=1-01 от 01.12.2017\u0026t=pageview\u0026dh=GoogleAnalytics пример для УФ\u0026dp=ФормаГлавная"
  } ],
  "parserMessage": [ {
    "messageType": "INFO",
    "description": "Found 1 hit in the request."
  } ]
}
 

УстановитьИдентификаторПриложения(сИдПриложения)

где параметр:

сИдПриложения - Строка - (обязательно) код отслеживания, полученный при регистрации в GoogleAnalytics. Код отслеживания, также может быть установлен в конструкторе и в таком случае вызов этого метода не требуется. Данный метод должен быть вызван до вызова метода конструктора.

УстановитьИдентификаторКлиента(сИдКлиента)

где параметр:

сИдКлиента - Строка | УникальныйИдентификатор - (обязательно) идентификатор УИД, который характеризует пользователя обрабтехничскоеотки. Идентификатор клиента, также может быть установлен в конструкторе и в таком случае вызов этого метода не требуется. Данный метод должен быть вызван до вызова метода конструктора.

Немного об идентификаторе клиента:

• Google строго регламентирует способ формировконфигурацииания идентификатора. Главное, с помощью идентификатора не должно быть возможности идентифицировать личность пользователя.
• По ИдКлиента GoogleAnalytics учитывает статистику об аудитории в разрезе пользователей
• Источником для ИдКлиента, на мой взгляд, оправданно использовать УИД Организации или УИД Пользователя БД

Пример кода для получения идентификатора, который можно подать в параметр сИдКлиента 

&НаСервереБезКонтекста
Функция ПолучитьИдентификаторКлиента_Сервер()
	Перем рефОрганизация, ИдКлиента;
	
	рефОрганизация = БухгалтерскийУчетПереопределяемый.ПолучитьЗначениеПоУмолчанию("ОсновнаяОрганизация");	
	
	Если ТипЗнч(рефОрганизация) = Тип("СправочникСсылка.Организации") И НЕ рефОрганизация.Пустая() Тогда
		ИдКлиента = рефОрганизация.УникальныйИдентификатор();
	Иначе
		ИдКлиента = ПользователиИнформационнойБазы.ТекущийПользователь().УникальныйИдентификатор;
	Конецпечатную версиюЕсли;
	
	Возврат Инфостарт  ИдКлиента;
Конецпечатную версиюФункции

Вспомогательные методы интерфейса

Форма_Имя(оФорма)

где параметр:

оФорма - УправляемаяФорма - (обязательно) объект управляемой формы, имя которого нужно получить

Возвращаемое значение: Строка - Имя формы

Данный метод удобно использовать в аргументе "сФормаНаименование" метода GA_Форма_Экран(сФормаНаименование, мДанные)

Обработ обработкика_Имя()

обработкикаИмя" name="Обработ обработкикаИмя">Возвращаемое значение: Строка - Имя обрабтехничскоеотки. Синоним, если доступно или имя объекта ВнешняяОбработ обработкика.

Данный метод удобно использовать в аргументе "сОбработ обработкикаНаименование" метода GA_Форма_Экран(сФормаНаименование, мДанные)

GA_ПолучитьТекстДисклеймера()

Данный метод возвращает строку - текст дисклеймера. При необходимости вы можете переопределить текст предупреждения. Данный текст желательно показывать пользователю на форме, где происходит настройка (разрешение) отправки данных в GA

ВерсияМодуляGA()

Данный метод возвращает номер версии библиотеки как строка.

Публичные реквизиты "Перечисления"

Для однообразия значений параметров отправляемых в Google Analytics в библиотеке присутствуют предопределенные "перечисления". Термин взят в кавычки, так как это реквизит формы с типом ФиксированнаяСтруктура, который имитирует работ обработкиу с перечислениями. В библиотеке предопределены следующие структуры:

• EC - категория события. Элементы структуры - литералы, обозначающие категории событий. Метод, отвечающий за построение перечисления: Перечисление_КатегорияСобытия_Создать()
• EA - событие. Элементы структуры - литералы, обозначающие виды событий. Метод, отвечающий за построение перечисления: Перечисление_Событие_Создать()
• EXD - ошибка. Элементы структуры - литералы, обозначающие виды ошибок в обрабтехничскоеотке. Метод, отвечающий за построение перечисления: Перечисление_Ошибка_Создать()
• SC - сеанс. Элементы структуры - литералы, обозначающие начало и конец сеанса. Метод, отвечающий за построение перечисления: Перечисление_Сеанс_Создать()

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

Встраивание библиотеки в собственную обрабтехничскоеотку

Принцип встраивания библиотеки

Встраивание библиотеки в собственную обрабтехничскоеотку простая задача. Необходимо выполнить несколько условий.

1. Интерфейс библиотеки реализован только клиентскими методами. Следовательно из серверных методов обрабтехничскоеотки статистику отправить не получится.
2. На протяжении всего времени работ обработкиы обрабтехничскоеотки в памяти должна существовать форма "модGA".
3. Модуль основной формы обрабтехничскоеотки должен иметь экспортную переменную которой присвоена ссылка на форму "модGA" Эта переменная будет "точкой доступа" к методам библиотеки.
4. Все формы обрабтехничскоеотки должны иметь удобный доступ к "точке доступа"

Пример встраивания

К публикации приложен пример обрабтехничскоеотки со встроенной библиотекой. Прокомментирую последовательность встраивания:

добавьте форму библиотеки в вашу обрабтехничскоеотку

в модуле основной формы, в моем примере это "ФормаГлавная", добавьте переменные модуля из области "Встраивание_GA_в_модуль_формы_ПЕРЕМЕННЫЕ". 

#Область Встраивание_GA_в_модуль_формы_ПЕРЕМЕННЫЕ

&НаКлиенте
Перем м_GA Экспорт; // Только для основной формы. 
// Переменная содержит ссылку на форму "модGA". Это точка доступа к методам библиотеки.

&НаКлиенте
Перем м_ОФ; // Требуется в каждой форме
// Переменная содержит ссылку на основную форму обрабтехничскоеотки

#Конецпечатную версиюОбласти

в модуле основной формы добавьте методы встраивания из области "Встраивание_GA_в_модуль_формы_МЕТОДЫ"

в модуле основной формы в методе "ПриОткрытии" инициализируйте библиотеку, например так:

&НаКлиенте
Процедура ПриОткрытии(Отказ)
	Перем сИдКлиента, мДанные;
	Перем ИДПРИЛОЖЕНИЯ;
	
	// КОНСТАНТА
	ИДПРИЛОЖЕНИЯ = "UA-111111111-1"; // Идентификатор отслеживания полученный в GoogleAnalytics
		
	// ПОДКЛЮЧЕНИЕ БИБЛИОТЕКИ модGA
	Если НЕ МодульGA_Подключить() Тогда
		СообщитьПользователю("Модуль GA не подключен. Подробнее, см. ЖР.");
	Конецпечатную версиюЕсли;
	
	м_ОФ = ОсновнаяФорма_Получить(ЭтотОбъект);
	Если м_ОФ = Неопределено Тогда
		СообщитьПользователю("ОсновнаяФорма не определена. Модуль GA не подключен. Подробнее, см. ЖР.");
	Конецпечатную версиюЕсли;
	
	// ИНИЦИАЛИЗАЦИЯ БИБЛИОТЕКИ И УСТАНОВКА ПАРАМЕТРОВ GA
	м_ОФ.м_GA.УстановитьИдентификаторПриложения(ИДПРИЛОЖЕНИЯ);
	сИдКлиента = ПолучитьИдентификаторКлиента();
	м_ОФ.м_GA.УстановитьИдентификаторКлиента(сИдКлиента);
	м_ОФ.м_GA.УстановитьРазрешениеОтправкиСтатистики(р_бОтправкаРазрешена);
	м_ОФ.м_GA.УстановитьРежимОтладки(р_бРежимОтладки);
	
	Если НЕ м_ОФ.м_GA.НачатьРаботуС_GA() Тогда
		СообщитьПользователю("Не удалось начать работ обработкиу с GA. Подробнее, см. ЖР.");
	Конецпечатную версиюЕсли;
		
Конецпечатную версиюПроцедуры

Комментарий к коду:

• Константа "ИДПРИЛОЖЕНИЯ" указана ненастоящая. Вам нужно получить свой код отслеживания
• Переменные "р_бОтправкаРазрешена" и "р_бРежимОтладки" в демонстрационном примере это реквизиты основной формы, в которых хран1Ситься состояние флагов.
• Вызов методов библиотеки производится через цепочку м_ОФ.м_GA . Это обозначает, что в контексте основной формы (м_ОФ) есть контекст формы модGA (м_GA), который в свою очередь предоставляет доступ к методам библиотеки

в модулях всех форм, кроме основной, добавьте код из областей "Встраивание_GA_в_модуль_формы_ПЕРЕМЕННЫЕ" и "Встраивание_GA_в_модуль_формы_МЕТОДЫ" взятый из приложенного примера обрабтехничскоеотки

в модулях всех форм, кроме основной в методе "ПриОткрытии" инициализируйте библиотеку, например так:

&НаКлиенте
Процедура ПриОткрытии(Отказ)
	
	// ИНИЦИАЛИЗАЦИЯ БИБЛИОТЕКИ
    м_ОФ = ОсновнаяФорма_Получить(ЭтотОбъект);
	Если м_ОФ = Неопределено Тогда
		СообщитьПользователю("Модуль GA не подключен. Подробнее, см. ЖР.");
	Конецпечатную версиюЕсли;
	
	// Отправка данных в GA о начале просмотра формы
	мДанные = м_ОФ.м_GA.GA_Форма(м_ОФ.м_GA.Обработ обработкика_Имя(), м_ОФ.м_GA.Форма_Имя(ЭтотОбъект));
	м_ОФ.м_GA.GA_ОтправитьСведения(мДанные);

Конецпечатную версиюПроцедуры

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

и наконец, добавьте в контролируемые места обрабтехничскоеотки код отправки статистики в GA, например такой:

сИмяДокумента = "СЧФ";
чКоличествоДокументов = 4;
	
мДанные = м_ОФ.м_GA.GA_Событие(м_ОФ.м_GA.EC.UX, м_ОФ.м_GA.EA.UX_clic, Команда.Имя);
м_ОФ.м_GA.GA_ОтправитьСведения(мДанные);
мДанные = м_ОФ.м_GA.GA_Событие(м_ОФ.м_GA.EC.B2B, м_ОФ.м_GA.EA.B2B_send, сИмяДокумента, чКоличествоДокументов);
м_ОФ.м_GA.GA_ОтправитьСведения(мДанные);

Внешний вид демонстрационной обрабтехничскоеотки приведен на скриншоте ниже. Открытие форм и нажатие на кнопки отправляет данные в GA.

Дополнения

дополнение от 22.01.2018

проверил профайлером время, которое уходит на работ обработкиу с GA. На мой взгляд не критично 0,16 - 0,2 с на один запрос к сервису.

дополнение от 27.01.2018

Спасибо уважаемому Андрею (Scorpion4eg) за толковые подсказки.

Решен вопрос использования параметров cd1 - cd4. Требуется настроить Google Analytics и создать пользовательский отчет

Решен вопрос использования параметров an и av. Требуется добавить представление в Google Analytics и отправлять обращения о просмотре форм используя метод GA_Форма_Экран

Уточнена таблица с параметрами обращения и добавлен новый метод GA_Форма_Экран

Выложена новая версия библиотеки 1-04

Приложения

Параметры обращения в Google Analytics

"Перечисления" категории и события

"Перечисление" ошибки

"Перечисление" SC сеанс

Конецпечатную версию.