Что такое UTM-метки и зачем они нужны в чат-ботах
UTM-метки — это специальные параметры, которые добавляются к ссылкам для отслеживания источников трафика. В чат-ботах они помогают понять:
- откуда пришёл пользователь (реклама, соцсети, email и т.д.);
- какая кампания или объявление сработали лучше;
- как сравнивать эффективность Telegram и VKontakte;
Важно: чтобы аналитика работала корректно, нужно учитывать, что разные мессенджеры обрабатывают ссылки по-разному. Например, Telegram-боты не принимают стандартные UTM-параметры напрямую — вместо этого вся информация «упаковывается» внутрь одного параметра start=....
Поэтому при настройке передачи данных из рекламной ссылки в бота важно использовать правильный формат — особенно если вы работаете с BotHunter для Telegram и ВКонтакте.
Настройка передачи UTM-меток в BotHunter для Telegram
Важное отличие: Telegram-боты не принимают стандартные UTM-метки (utm_source, utm_campaign и т.д.) напрямую как отдельные параметры. Они видят только один параметр — start.
Поэтому вся информация об источнике трафика должна быть «упакована» внутрь значения start=....
Шаг 1. Формируем правильную ссылку для Telegram
Обычная ссылка на бота выглядит так:
https://t.me/targethunter_THbot
Если вы просто добавите UTM-метки через знак вопроса, как для сайта, Telegram их проигнорирует.
Правильный формат ссылки:
Все данные нужно передать через параметр start, используя разделитель — нижнее подчеркивание _.
Пример:
https://t.me/targethunter_THbot?start=dzen_statya_proutm
Где:
- dzen — площадка размещения;
- statya — способ размещения;
- proutm — кампания.
В ссылку на бота добавляете ?start= и дописываете то, что нужно — именно то, что вам нужно и как вам нужно. Возможно, будет достаточно добавить 30042026, что будет означать дату публикации креатива, с которого отслеживаете трафик, и уже становится понятно, что это и откуда, и не привязывать себя к каким-то правилам и форматам деления.
Шаг 2. Настраиваем вход в бот (Deep Link) в BotHunter
Зайдите в раздел «Автоматизация» → «Чат-боты» и создайте чат-бота с активностью «Получено новое входящее сообщение». Или в случае с MAX — «Пользователь запустил бота».
Сразу после запуска бота ставим блок с условием. В нём проверяем, равно ли входящее слово команде /start. Также в этом же блоке проверяем длину сообщения: если длина полученного сообщения равна 7, значит, человек пришёл с рекламы.
Если условие выполняется (пользователь пришёл по ссылке), переходим к ветке «Да» (или основной ветке сценария).
Шаг 3. Сохраняем данные в переменные (парсинг строки)
BotHunter не создаёт переменные автоматически. Данные из start приходят одной строкой (например, campaign_source_banner_ad_march). Нам нужно разбить эту строку на части и сохранить каждую в отдельную переменную пользователя.
После того как вы поняли, что пользователь пришёл с метками в параметре {tg_start}, добавьте блок действия: «Изменить переменную пользователя».
В качестве значения используйте функцию split — она разбивает строку на части по указанному разделителю.
Создаём переменные для хранения данных
Например:
- user_traffic_source
- user_ad_creative
- user_campaign_name
Или любые другие — на ваше усмотрение, главное — чтобы было удобно ориентироваться.
Записываем каждую часть в свою переменную
BotHunter автоматически создаёт временные переменные вида:
- {%text.1%}
- {%text.2%}
- {%text.3%}
- {%text.4%}
👉 То есть, если в {tg_start} было 6 параметров через _, то будут доступны {%text.1%} до {%text.6%}.
Используем переменные в сценарии
Теперь созданные вами переменные ({user_traffic_source}, {user_campaign_name} и т.д.) можно применять везде:
- для сегментации пользователей;
- в приветственных сообщениях;
- при передаче данных в CRM или другие системы.
Не бойтесь создавать много переменных — чем точнее вы называете их под свои нужды, тем проще потом работать с данными и анализировать поведение пользователей.
Настройка UTM-меток в BotHunter для ВКонтакте (VK)
Сообщества ВКонтакте и боты в VK поддерживают стандартные GET-параметры. Это значит, что вы можете использовать привычные UTM-метки (utm_source, utm_medium, utm_campaign) прямо в ссылке, и бот сможет их считать.
Шаг 1. Формируем правильную ссылку для ВКонтакте
Ссылка на диалог с сообществом или ботом в VK имеет вид:
https://vk.me/th.bots
Далее добавляете реферальные метки (не UTM!). В данном случае также придётся ограничиться двумя параметрами:
- ref — обязательный параметр;
- ref_source — опциональный.
Вот ссылка на наш генератор UTM: https://bot.targethunter.ru/tools/utm_label, или даже сразу на новый интерфейс: https://bot-new.targethunter.ru/g168694/tools/utm-label
Выбираем правильный тип ссылки, которую делаем, если ведём в личку сообщества.
Если ведём на мини-лендинг, то вот ссылка на подписную: https://vk.com/app7070938_-187822477#s=674ef76211fc1676743d5da2
Если использовать наш генератор, то можно взять свои значения, но при этом ? нужно будет заменить на & в итоговой ссылке. Если будете использовать другие генераторы UTM, то тоже важно это проверить, так как обычно пишут сначала ?, но для VK мини-лендингов этот символ должен быть заменён на &. В противном случае ссылка не сработает.
В нашем генераторе удобно, что можно писать по-русски, а он переведёт в латиницу.
Но будьте аккуратны: после вашей ссылки не должно быть пробелов (как на скрине), и обязательно ? заменить на &.
Вот такая рабочая ссылка по итогу должна у вас получиться:
https://vk.com/app7070938_-187822477#s=674ef76211fc1676743d5da2&utm_medium=statya&utm_source=vk&utm_campaign=pro_yutm
Когда люди подписываются на мини-лендинг, за ними закрепляются параметры UTM, которые были зашиты в ссылку.
Шаг 2. Настраиваем вход в бот в BotHunter
Откройте сценарий бота в BotHunter.
Триггер входа: если ведём в личку — «Получено входящее сообщение»; если на мини-лендинг — «Произошла подписка на мини-лендинге».
В отличие от Telegram, в VK параметры приходят не в одном поле start, а как отдельные системные переменные или параметры запроса. В BotHunter для VK доступны переменные вида {utm_source}, {utm_campaign} и т.д. (названия могут зависеть от интеграции, проверьте список доступных переменных в редакторе).
Если прямые переменные недоступны, то параметры могут приходить в общем объекте параметров. Параметр {utms} выдаст сразу все UTM.
Чек-лист настройки UTM-меток перед запуском рекламы
- Ссылки для Telegram сформированы правильно: все UTM-данные внутри start=, разделены символом _.
- Ссылки для VK содержат корректные UTM-метки через &. Если же ссылка для лички с сообществом, не забудьте добавить ref-метки.
- В сценарии BotHunter для Telegram настроен парсинг {tg_start}.
- В сценарии BotHunter для VK значения {utm_source}, {utm_medium} присвоены переменным пользователя.
- Протестирован проход по ссылке: после нажатия «Start» / «Запустить» проверьте в карточке пользователя в BotHunter, заполнились ли созданные вами переменные.
Почему UTM-метки могут не передаваться в BotHunter
Иногда данные из UTM-меток не попадают в систему аналитики. Вот самые распространенные причины этой проблемы:
- Ошибка в ссылке: Самая частая причина — опечатка или неверный формат UTM-метки в ссылке. Например, лишний символ, пробел или неправильное название параметра (например, utm_sourse вместо utm_source).
- Редиректы (переадресации): Если пользователь переходит по ссылке с UTM-метками, но его перенаправляют на другую страницу (например, с http на https или через сокращатель ссылок), метки могут быть потеряны, если сервер редиректа настроен неправильно.
- Кэширование страницы: Если браузер пользователя показывает сохраненную (закешированную) версию страницы, скрипт аналитики может не запуститься заново и, соответственно, не считать новые UTM-метки.
- Блокировщики рекламы и трекеров: Расширения в браузере, такие как AdBlock, Ghostery и другие, могут блокировать работу скриптов аналитики, включая BotHunter. В результате данные просто не отправляются.
- Проблемы с настройкой BotHunter: Чаще всего причина не в самом сервисе, а в ошибках при его интеграции или использовании. Например: неправильная установка скрипта на сайт, конфликт с другими системами аналитики (например, Яндекс.Метрика или Google Analytics), либо ручное редактирование профиля пользователя, которое затирает ранее переданные UTM-параметры. Важно помнить: новые метки записываются поверх старых — если нужно сохранять историю всех запусков (включая повторные), рекомендуется использовать отдельную таблицу (например, TX-таблицу) для хранения полных данных о каждом визите. Это также помогает соблюдать требования по обработке персональных данных, так как данные хранятся на серверах в РФ, а не в зарубежных системах.
- Открытие ссылки в мессенджерах или соцсетях: Некоторые приложения (например, встроенные браузеры в Telegram, VK) могут "съедать" часть параметров из URL при открытии ссылки внутри приложения.