Такие платформы, как Instagram, Facebook, WhatsApp и Telegram, реализуют этот механизм через параметр
visit_key.
Поддержка глубоких ссылок
Большинство мессенджеров (например, Instagram, Facebook, Telegram) поддерживают глубокие ссылки. Однако другие — нет.
Обходной путь для WhatsApp
Хотя WhatsApp не поддерживает нативные глубокие ссылки, вы все равно можете передавать параметры и 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
Параметры и метки будут переданы боту и сохранены как переменные клиента.

Как использовать эти параметры без сайта
Вы можете использовать прокси-ссылки для прямой передачи параметров. После запуска бота через такую ссылку все переданные данные будут сохранены как переменные сделки.
Формат ссылки с параметрами должен быть следующим:
Структура прокси-ссылки
Параметризованная прокси-ссылка состоит из двух частей:
-
Базовый URL (сама прокси-ссылка):
https://mavibot.ai/r/mavibot_1 -
Строка запроса (ваши параметры):
?param1=value1¶m2=value2
Пример: добавление UTM-меток в ссылку Telegram
Вот пример прямой ссылки с сайта в Telegram с UTM-параметрами:


Прямые ссылки на мессенджеры в разделе «Сайты»
В этом разделе отображаются кликабельные ссылки для всех мессенджеров, интегрированных с вашей системой.
Особенности WhatsApp
Поскольку WhatsApp не поддерживает глубокие ссылки, вы должны добавить специальную переменную в начальное сообщение бота. Бот будет использовать эту переменную для идентификации параметров, с которыми был запущен WhatsApp.
Переменная: #{visit_key}
Когда пользователь переходит по вашей ссылке WhatsApp, этот плейсхолдер будет автоматически заменен на уникальный числовой код, содержащий переданные параметры.

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

Подписка Instagram
Эволюция отслеживания параметров
- Предыдущий метод (
#{visit_key}): - Переменная
#{visit_key}использовалась путем размещения в поле «Начальное сообщение WhatsApp». Это позволяло отслеживать параметры запуска для взаимодействий в Instagram. - Текущий метод (глубокие ссылки с реферальными параметрами):
Теперь вы можете передавать реферальные параметры напрямую через глубокие ссылки Instagram, что обеспечивает большую гибкость и контроль.
Преимущества использования реферальных параметров:
С помощью реферальных параметров вы можете:
- Отслеживать кампании, связывая клики с конкретными источниками или каналами.
- Атрибутировать пользователей, связывая посетителя Instagram с сессией или аккаунтом в вашем внешнем приложении.
- Персонализировать пути, направляя пользователей на целевой контент или конкретные функции в вашем аккаунте Instagram.

Параметр REF_PARAM передается на сервер через вебхук.
Пример: https://ig.me/m/mavibotai?ref=mavi
Вы можете скопировать ссылку на вашего бота Instagram в разделе «Каналы».
Ссылка выглядит так: https://ig.me/m/\\<account_login_instagram> *

Ссылка выглядит так: https://ig.me/m/\\<account_login_instagram>*
Добавьте параметр в скопированную ссылку:?ref=<your parameter>
Затем вы можете использовать ссылку с параметром ref для входа пользователей в бота Instagram.
Параметр будет передан ТОЛЬКО при самом первом контакте пользователя с вашим аккаунтом (ботом).
UTM-метки в разделе «Аналитика»
Вы можете просматривать статистику по UTM-меткам в разделе «Аналитика».
Перейдите в раздел «Аналитика» и выберите вкладку «Клиенты».

Нажмите кнопку «Добавить виджет».

Откроется окно Конструктор виджетов.
- Выберите вкладку UTM-метки.
- Нажмите кнопку «Добавить значение».

Появятся дополнительные настройки для значений UTM-меток. Нажмите на поле «Выберите метку».

И выберите метку, для которой хотите просмотреть статистику.

Если вы хотите добавить несколько меток или все, снова нажмите «Добавить значение».

Не забудьте указать период и другие настройки и обязательно сохраните их.
Затем добавьте необходимое количество меток и нажмите кнопку «Сохранить».

Затем нажмите кнопку «Добавить виджет».

Подробнее о работе с аналитикой читайте в статье «Аналитика MaviBot»