Как передавать параметры и UTM-метки

Платформы вроде Instagram, Facebook, WhatsApp и Telegram реализуют этот механизм через visit_key параметра.

Поддержка deep link Большинство мессенджеров (таких как Instagram, Facebook, Telegram) поддерживают deep link. Однако другие — нет.

Обходной путь для WhatsApp Хотя WhatsApp не поддерживает deep linking нативно, вы всё равно можете передавать параметры и UTM-метки. Для этого вставьте специальную переменную в текст заранее заполненного сообщения, который пользователь увидит после перехода по вашей ссылке. (Подробно этот метод будет рассмотрен позже.)

Хранение параметров Все переданные параметры сохраняются в системе как клиентские переменные.

Структура и типы параметров Параметр — это пара имя-значение. В зависимости от источника параметры могут быть:

Статические: Вы задаёте точное значение, которое нужно передать.
- Пример: utm_term=webinar1 (где utm_term — это имя, а webinar1 — это статическое значение).
Динамические: Рекламная платформа (например, Google Ads, Facebook Ads) автоматически подставляет нужные данные в момент клика.
- Пример: term={keyword} — здесь {keyword} заполнитель динамически заменяется на фактический поисковый запрос, который вызвал показ объявления.

Как использовать эти параметры на сайте

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

Чтобы получить ссылку на ваш сайт, перейдите в «Сайты» .

Пример добавления UTM-меток к ссылке сайта:

https://mavibot.ai/st/black_friday_mavibot?utm_source=test_wi_me&utm_medium=cpc&utm_campaign=id_campaign&utm_content=registration

Параметры и метки будут переданы в бота и сохранены как клиентские переменные.

Как использовать эти параметры без сайта

Вы можете использовать прокси-ссылки чтобы передавать параметры напрямую. Как только бот будет запущен по такой ссылке, все переданные данные будут сохранены как переменные сделки.

Формат ссылки с параметрами должен быть следующим:

Структура proxy-ссылки

Параметризованная proxy-ссылка состоит из двух частей:

Базовый URL (сама proxy-ссылка): https://mavibot.ai/r/mavibot_1
Строка запроса (ваши параметры): ?param1=value1&param2=value2

Пример: добавление UTM-меток к ссылке Telegram

Вот пример прямой ссылки с сайта в Telegram с UTM-параметрами:

https://mavibot.ai/r/mavibot_1?utm_medium=cpc&utm_source=yandex&utm_term=key_phrase&utm_content=HappyNY#ancor

Прямые ссылки на мессенджеры в «Сайтах»

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

Функции WhatsApp

Поскольку WhatsApp не поддерживает deep links, вам нужно добавить специальную переменную в стартовое сообщение бота. Бот будет использовать эту переменную, чтобы определить параметры, с которыми был запущен WhatsApp.

Переменная: #{visit_key}

Когда пользователь нажимает на вашу ссылку WhatsApp, этот заполнитель автоматически заменяется уникальным числовым кодом, содержащим переданные параметры.

«Сайты» → Сайт → Настройки страницы сайта → Мессенджеры → Настройки WhatsApp

Когда пользователь переходит в WhatsApp с вашего сайта (или по ссылке на мессенджер из настроек сайта), #{visit_key} заполнитель заменяется уникальным числовым кодом.

Подписка Instagram

Эволюция отслеживания параметров

Предыдущий метод (#{visit_key}):
Текст #{visit_key} переменная использовалась путём добавления её в «Начальное сообщение WhatsApp». Это позволяло отслеживать параметры запуска для взаимодействий в Instagram.
Текущий метод (deep links с реферальными параметрами):

Теперь вы можете передавать реферальные параметры напрямую через deep links Instagram, что даёт большую гибкость и контроль.

Преимущества использования реферальных параметров:

С реферальными параметрами вы можете:

Отслеживать кампании — связывая клики с конкретными источниками или каналами.
Атрибутировать пользователей — сопоставляя посетителя Instagram с сессией или учётной записью во внешнем приложении.
Персонализировать пути — направляя пользователей к целевому контенту или определённым функциям внутри вашего аккаунта Instagram.