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

{% hint style="info" %}
Платформы вроде Instagram, Facebook, WhatsApp и Telegram реализуют этот механизм через `visit_key` параметра.
{% endhint %}

**Поддержка 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-метки и другие метки.

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

<div data-with-frame="true"><figure><img src="/files/4de18428d188765fa90a044a2e539696f0a87658" alt="" width="563"><figcaption></figcaption></figure></div>

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

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

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

<div data-with-frame="true"><figure><img src="/files/8d48e71eeae7088c46b1509b33d9299fe676620a" alt=""><figcaption></figcaption></figure></div>

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

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

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

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

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

1. **Базовый URL** (сама proxy-ссылка): `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>

<div data-with-frame="true"><figure><img src="/files/157d21fdfc3d634c42009c920d5cc629737c43a0" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/4f1ff009467dd37700552119b431e7ccaa004708" alt=""><figcaption></figcaption></figure></div>

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

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

## Функции WhatsApp

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

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

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

<div data-with-frame="true"><figure><img src="/files/ccf65c3eb6d124b09bf81a48a7eb2bb49d881ae9" alt=""><figcaption></figcaption></figure></div>

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

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

<div data-with-frame="true"><figure><img src="/files/13262dabda96dcd6e907c577d6e2c8b637b48192" alt="" width="375"><figcaption></figcaption></figure></div>

## Подписка Instagram

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

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

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

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

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

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

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcc5PLfQg8uf4gvxZZ406aRwpoDcBtDJzqbOOthnQ2fjKIQ8UHr8NTFUVl5vkbPN541vIv5lvbRxhEn0n7FSDt-g7NYwodzJg09vzSowpMRTQaSrNwbBf3XTCpYuT2rKbDUAjADeg?key=9cFsqYH0-lPo60eUI7iEQg" alt=""><figcaption><p>Deep link Instagram</p></figcaption></figure>

Параметр REF\_PARAM передаётся на сервер через webhook.

Пример: <https://ig.me/m/mavibotai?ref=mavi>

Вы можете скопировать ссылку на вашего Instagram-бота в разделе «Каналы».

Ссылка выглядит так: <https://ig.me/m/\\>\<account\_login\_instagram> \*

<div data-with-frame="true"><figure><img src="/files/1d1609a8d0a0586baf531f0dd271e4447c16e03a" alt=""><figcaption></figcaption></figure></div>

Ссылка выглядит так: <https://ig.me/m/\\>\<account\_login\_instagram>\*

Добавьте параметр к скопированной ссылке:?ref=<ваш параметр>&#x20;

Далее вы можете использовать ссылку с параметром ref, чтобы вводить пользователей в ботаник Instagram.

Параметр будет передан ТОЛЬКО при самом первом контакте пользователя с вашим аккаунтом (ботом).

## UTM-метки в разделе аналитики

Вы можете просматривать статистику по UTM-меткам в разделе «Аналитика»

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

<div data-with-frame="true"><figure><img src="/files/e797d550d8ed0cfef732126c871bf82f580aafb7" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/118853f2af85d78984cccce67abaf1cc7c242c7c" alt="" width="563"><figcaption></figcaption></figure></div>

Текст **Откроется окно** конструктора виджетов.

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

<div data-with-frame="true"><figure><img src="/files/7a0a806c9da7ebfb9c1b3f37209cb7909f1bf445" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/7a16e45c2b739b54f17c793f41d0c9a8cf706a2a" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/f65acb79cfc5209a1179389e80771c46855516a7" alt="" width="325"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/2c6f48b3cae0abe9f2d433a1c1489fd5d396f109" alt="" width="563"><figcaption></figcaption></figure></div>

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

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

<div data-with-frame="true"><figure><img src="/files/b8d3f2b9b39eb749be5a91fdc4e9d8eb135bb3e8" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/4fd86f7c4c5943ad7996a33225a4c7f3bacb6d5a" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
Подробнее о том, как работать с аналитикой, в статье "[Аналитика MaviBot](/doc/ru/analitika-mavibot.md)"
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ru/websites/saity/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.