# Як передавати параметри та UTM-теги

{% hint style="info" %}
Платформи на кшталт Instagram, Facebook, WhatsApp і Telegram реалізують цей механізм через `visit_key` параметра.
{% endhint %}

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

**Обхідний шлях для WhatsApp**\
Хоча WhatsApp не має вбудованої підтримки глибокого посилання, ви все одно можете передавати параметри та UTM-мітки. Для цього вставте спеціальну змінну в попередньо заповнений текст повідомлення, який користувач побачить після переходу за вашим посиланням. (Цей метод буде детально розглянуто далі.)

**Зберігання параметрів**\
Усі передані параметри зберігаються в системі як змінні клієнта.

**Структура та типи параметрів**\
Параметр — це **пара «ім’я-значення»**. Залежно від джерела, параметри можуть бути:

* **Статичні:** Ви визначаєте точне значення, яке буде передано.
  * **Приклад:** `utm_term=webinar1` (де `utm_term` — це ім’я, а `webinar1` — це статичне значення).
* **Динамічні:** Рекламна платформа (наприклад, Google Ads, Facebook Ads) автоматично вставляє відповідні дані в момент кліку.
  * **Приклад:** `term={keyword}` — тут `{keyword}` заповнювач динамічно замінюється на фактичний пошуковий запит, який запустив рекламу.

#### Як використовувати ці параметри на сайті

Усі параметри, передані на ваш сайт, буде перетворено на змінні угоди після запуску ботом клієнта. Це включає UTM-мітки та інші позначки.

**Щоб отримати посилання на ваш сайт**, перейдіть до **«Сайти»** розділ.

<div data-with-frame="true"><figure><img src="/files/f71d69c281b15514778e0beaffae792dd2aecfcf" 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/fdbc7ff12ea6f3d6db52fd163ec15f51042d393c" alt=""><figcaption></figcaption></figure></div>

#### Як використовувати ці параметри без сайту

Ви можете використовувати **проксі-посилання** щоб передавати параметри безпосередньо. Після запуску бота за таким посиланням усі передані дані буде збережено як змінні угоди.

**Формат посилання з параметрами має бути таким:**

**Структура проксі-посилання**

Проксі-посилання з параметрами складається з двох частин:

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>

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

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

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

У цьому розділі відображаються клікабельні посилання для всіх месенджерів, інтегрованих із вашою системою.

## Функції WhatsApp

Оскільки WhatsApp не підтримує глибокі посилання, ви повинні додати спеціальну змінну до стартового повідомлення бота. Бот використовуватиме цю змінну для визначення параметрів, з якими було запущено WhatsApp.

**Змінна: `#{visit_key}`**

Коли користувач натискає ваше посилання WhatsApp, цей заповнювач автоматично замінюється унікальним числовим кодом, що містить передані параметри.

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

«Сайти» → Сайт → Налаштування сторінки сайту → Месенджери → Налаштування WhatsApp

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

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

## Підписка в Instagram

**Еволюція відстеження параметрів**

* **Попередній метод (`#{visit_key}`):**
* Поле `#{visit_key}` змінну використовували, розміщуючи її в **«Початкове повідомлення WhatsApp»**. Це дозволяло відстежувати параметри запуску для взаємодій в Instagram.
* **Поточний метод (глибокі посилання з реферальними параметрами):**

Тепер ви можете передавати реферальні параметри безпосередньо через глибокі посилання Instagram, що забезпечує більшу гнучкість і контроль.

**Переваги використання реферальних параметрів:**

За допомогою реферальних параметрів ви можете:

* **Відстежувати кампанії** пов’язуючи кліки з конкретними джерелами або каналами.
* **Атрибутувати користувачів** пов’язуючи відвідувача Instagram із сесією або обліковим записом у вашому зовнішньому застосунку.
* **Персоналізувати шляхи** спрямовуючи користувачів до цільового контенту або певних функцій у вашому обліковому записі Instagram.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcc5PLfQg8uf4gvxZZ406aRwpoDcBtDJzqbOOthnQ2fjKIQ8UHr8NTFUVl5vkbPN541vIv5lvbRxhEn0n7FSDt-g7NYwodzJg09vzSowpMRTQaSrNwbBf3XTCpYuT2rKbDUAjADeg?key=9cFsqYH0-lPo60eUI7iEQg" alt=""><figcaption><p>Глибоке посилання Instagram</p></figcaption></figure>

Параметр REF\_PARAM передається на сервер через вебхук.

Приклад: <https://ig.me/m/mavibotai?ref=mavi>

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

Посилання має вигляд: <https://ig.me/m/\\>\<account\_login\_instagram> \*

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

Посилання має вигляд: <https://ig.me/m/\\>\<account\_login\_instagram>\*

Додайте параметр до скопійованого посилання:?ref=<ваш параметр>&#x20;

Далі ви можете використовувати посилання з параметром ref, щоб вводити користувачів в Instagram botanic.

Параметр буде передано ЛИШЕ під час самого першого контакту користувача з вашим обліковим записом (ботом).

## UTM-мітки в розділі Analytics

Ви можете переглянути статистику за UTM-мітками в розділі «Analytics»

Перейдіть до розділу «Analytics» і виберіть вкладку «Клієнти».

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

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

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

Поле **Конструктор віджетів** відкриється вікно.

1. Виберіть **UTM-мітки** .
2. Натисніть **«Додати значення»** кнопку.

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

З’являються додаткові налаштування для значень UTM-міток. Натисніть на поле **«Вибрати мітку»**.

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

і виберіть мітку, для якої хочете переглянути статистику.

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

Якщо хочете додати кілька міток або всі, знову натисніть «Додати значення».

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

Не забудьте вказати період та інші налаштування і обов’язково збережіть їх.

Потім додайте потрібну кількість міток і натисніть кнопку «Зберегти».&#x20;

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

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

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

{% hint style="success" %}
Докладніше про роботу з аналітикою читайте в статті "[Аналітика MaviBot](/doc/uk/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/uk/websites/saiti/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.