Запись UTM-меток в дополнительное поле пользователя или заказа

В этой статье рассмотрим способы записи меток в дополнительное поле пользователя или заказа в зависимости от размещения меток.

1. Метки указаны в ссылке на страницу

Для записи меток в переменные добавляем код в ноде «Страница», в котором слева указываем агент и название переменной, а справа - значение переменной.

Названия переменных могут быть любыми (на изображении ниже названиями выступают utm_source, utm_medium, utm_campaign).

Значение переменных берется из отладки и должно быть аналогичным значению переменных, представленных на скриншотах ниже.

Пример кода преобразования:

session.utm_source = event.utm.source;
session.utm_medium = event.utm.medium;
session.utm_campaign = event.utm.campaign;

Где: session - агент utm_source - название переменной (задается вами) event.utm.source - значение переменной, состоящего из имени (event) и свойства объекта (utm.source). Про объект event и работу с переменными можно подробнее прочитать в статье.

Агент, в которого происходит запись меток, может отличаться в зависимости от схемы воронки. Например, в ноде "Страница" всегда есть агент session. Поэтому в данном примере метки записываем в него. Подробнее про агентов рассказано в статье.

После фиксации меток в переменные нужно записать значения этих переменных в дополнительные поля через ноду «Обновить поля пользователя» либо «Обновить заказ» в зависимости от задачи.

2. Метки указаны в ссылке для запуска бота

Ссылку для запуска бота с метками нужно формировать через функционал ссылки-метрики

В этом случае нужно записывать метки в переменные в ноде «Команда бота».

В ноде "Команда бота" всегда есть агент chat, поэтому метки можно записать в него. Обязательные агенты, с которыми работает нода, выделены красными иконками. Без обязательного агента нода не сработает. Подробнее об этом рассказано в видео.