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

07.02.2026

На цій сторінці

Такі платформи, як 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&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.