Как сохранить UTM-метки в дополнительные поля с помощью модуля "Воронки"

UTM-метки — важный инструмент для анализа источников трафика и эффективности маркетинговых кампаний. Чтобы использовать эти данные для аналитики или сегментации, вы можете сохранять значения UTM-меток в дополнительные поля пользователей или заказов. Такой подход позволяет в дальнейшем выгружать объекты с нужными метками, строить отчёты и глубже понимать, откуда приходят клиенты. В этой статье разберем, как с помощью модуля «Воронки» собирать информацию о UTM-метках и сохранять их в дополнительные поля объектов.

Общий принцип сохранения UTM-меток:

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

Способ сохранения меток будет зависеть от того, куда ведет ссылка с UTM-метками:

• на страницу,
• в бот.

Если пользователь попадает в воронку при переходе по ссылке на страницу, то для записи меток из этой ссылки в переменные:

1. Создайте ноду «Страница».
2. Добавьте в ее настройки выражение для записи меток:
   • слева укажите агент и название переменной через точку, например, session.utm_source;
   • справа через знак равенства — значение переменной, например, event.utm.source.

Названия переменных могут быть любыми. В нашем примере в качестве названий используются следующие значения: utm_source, utm_medium, utm_campaign.

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

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

Далее сохраненные метки нужно записать в доп. поля. Читайте об этом [в разделе ниже].

Общий принцип записи меток будет таким:

1. Сформируйте ссылку для запуска бота с метками через функционал ссылки-метрики.
2. Запишите метки в переменные в ноде «Команда бота», аналогично тому, как было описано [выше]. В ноде «Команда бота» всегда есть агент chat, поэтому метки можно записать в него.

После сохранения меток в переменные переходите к следующему шагу — добавлению меток в доп. поля.

После фиксации меток в переменные нужно записать информацию из них в дополнительные поля.

Для записи меток в доп. поле пользователя:

1. Добавьте ноду «Обновить поля пользователя».
2. Выберите ранее созданное дополнительное поле, в нашем примере utm_source.
3. Запишите локальную переменную, в которую ранее была записана метка, в нашем примере session.utm_source.

Для записи меток в доп. поле заказа, если пользователь попадает в воронку со страницы с UTM-метками:

1. Добавьте ноду «Событие» — без нее после запуска бота и ноды «Команда бота» агент deal в воронку не будет передан, и обновить поля заказа не удастся. Ниже пример воронки с добавленной нодой «Событие».

2. Скопируйте идентификатор события из ноды «Событие».
3. В форму на странице перед переадресацией добавьте обработчик «Запустить событие в воронках» и пропишите в нем скопированный идентификатор.
4. В ноде «Обновить заказ» выберите нужное доп. поле, а также впишите переменную, в которую ранее записали utm-метку.

Если же пользователь попадает в воронку по ссылке-метрике в бота, то для запуска события и записи UTM-меток вы можете добавить в цепочку ноду «Событие» следующим образом:

• после ноды «Команда бота» добавьте отправку сообщения пользователю;
• в сообщении отметьте опцию «Обернуть ссылки для отслеживания кликов и синхронизации сессии» и добавьте ссылку на страницу с формой;
• далее добавьте ноду «Событие» и скопируйте идентификатор;
• в форме добавьте запуск события воронок и вставьте скопированный идентификатор.

При такой схеме не потеряется агент deal, и дополнительные поля заказа можно будет обновить.