А чё это вы здесь делаете, а?

Что это?

Данная публикация на примере демонстрационной обработки показывает, как отправлять статистику на сайт 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

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

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

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

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_Форма_Экран(сФормаНаименование, мДанные)

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

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

Данный метод удобно использовать в аргументе "сОбработкаНаименование" метода 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. Подробнее, см. ЖР.");
	КонецЕсли;
		
КонецПроцедуры

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

• Константа "ИДПРИЛОЖЕНИЯ" указана ненастоящая. Вам нужно получить свой код отслеживания
• Переменные "р_бОтправкаРазрешена" и "р_бРежимОтладки" в демонстрационном примере это реквизиты основной формы, в которых храниться состояние флагов.
• Вызов методов библиотеки производится через цепочку м_ОФ.м_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 сеанс

Конец.