Интеграция с Яндекс Метрика

ЯндексМетрика - это инструмент веб-аналитики для понимания, что проиходит на сайте. 

Мы можем как передавать важные данные с сайта, так и забирать нужную статистику по API. 

Установка счетчика Яндекс Метрики

Код счетчика получаем в настройках счетчика на metrika.yandex.ru и прописываем в /settings в настройке CommonScripts (разметка перед закрывающим /body)

Также в этой настройке прописываем номер счетчика, это потребуется для фиксации целей и передачи параметров в Метрику. 

<input type="hidden" class="as-metrikaCounterID" value="5331XXXXXXX" />

Достижение цели Яндекс Метрики на форме

Используем в SaveItem параметры:

• MetrikaGoal - название цели (код, который мы укаазали при создании цели типа JS-событие в Яндекс Метрике)
• MetrikaGoalParameter - какой доп параметр передадим в Метрику. 

Также в параметрах цели передаются code и itemID формы. 

Важно! Должен быть прописан номер счетчика на странице в таком элементе: 

<input type="hidden" class="as-metrikaCounterID" value="5331XXXXXXX" />

Если нужна более сложная цель - используем JS коллбеки форм (или таблицы).

Получение metrika clientID текущего посетителя

ClientID - это идентификатор браузера в метрике.

В разделе Посетители можно по clientID найти этого посетителя и просмотреть все его визиты. 

Чтобы включить этот режим, необходимо установить в as.systemOptions.js опцию "metrika.trackClientID": true

При каждом посещении из Метрики будет запрашиваться clientID и если он новый, то добавляться в куку с кодом metrikaClientID (через запятую). 

Важно! Должен быть прописан номер счетчика на странице в таком элементе: 

<input type="hidden" class="as-metrikaCounterID" value="5331XXXXXXX" />

Далее вы можете использовать этот clientID при сохрании формы (извлекая его через куки). Тем самым вы можете узнать полный путь клиента по его clientID. 

Отправка в Яндекс Метрику параметров пользователя

Если Client ID — это уникальный анонимный идентификатор браузера, то User ID — это уникальный идентификатор пользователя в вашей внутренней системе, который пользователь получил при регистрации.

Чтобы включить этот режим, необходимо установить в as.systemOptions.js опцию "metrika.sendUserParams": true

При этом в Яндекс будет по умолчанию передавать параметр пользователя username. 

Вы можете переопределить этот момент используя функцию as.getMetrikaCustomUserParams. 

Важно! Должен быть прописан номер счетчика на странице в таком элементе: 

<input type="hidden" class="as-metrikaCounterID" value="5331XXXXXXX" />