Такие платформы, как 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

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

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

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

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

Структура прокси-ссылки

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

  1. Базовый URL (сама прокси-ссылка): https://mavibot.ai/r/mavibot_1
  2. Строка запроса (ваши параметры): ?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 не поддерживает глубокие ссылки, вы должны добавить специальную переменную в начальное сообщение бота. Бот будет использовать эту переменную для идентификации параметров, с которыми был запущен 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-меткам в разделе «Аналитика».

Перейдите в раздел «Аналитика» и выберите вкладку «Клиенты».

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

Откроется окно Конструктор виджетов.

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

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

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

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

Не забудьте указать период и другие настройки и обязательно сохраните их.

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

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

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