Як працює редирект у Leeloo та як передавати джерело трафіку й UTM-мітки

UA	US	RU

UA	US	RU

1 Як отримати пряме посилання для редиректу в Leeloo.Ai?
2 Як передати UTM-мітки через свій сайт у Leeloo.Ai?
3 Як передати дані через свій сайт у Leeloo.Ai?

Що таке редирект у Leeloo?

Редирект у Leeloo дозволяє перенаправити підписника за потрібним посиланням у конкретного Telegram-бота через відповідний LGT (міні-лендінг). При цьому в посилання можна передати додаткові параметри: джерело трафіку, кастомні поля, UTM-мітки та інші значення.

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

Формат посилання на редирект

https://app.leeloo.ai/telegram/messenger-redirect/джерело_трафіку?параметри

Пояснення:

джерело_трафіку — унікальний ідентифікатор, пов’язаний із певним міні-лендінгом (LGT), ботом і потоком.
?параметри — будь-які значення, які ви хочете передати, наприклад: bonus=100, utm_source=facebook.

Як отримати пряме посилання для редиректу в Leeloo.Ai?

Відкрийте потрібний LGT (міні-лендінг), створений у Leeloo.

Перейдіть на вкладку Traffic.

Знайдіть потрібне джерело трафіку в таблиці.

Скопіюйте посилання, наприклад:

https://leel.me/ss7t7u?traffic_mark=7fnutr

Із цього посилання вам потрібен лише параметр traffic_mark, тобто частина після знака =:

7fnutr

Припустимо, ваш traffic_mark — це 7fnutr. Тоді робоче посилання виглядатиме так:

https://app.leeloo.ai/telegram/messenger-redirect/lcm4oz

Що важливо враховувати?

Щоб кастомні поля зберігались у картці підписника, їх потрібно попередньо створити в Leeloo (у розділі "Налаштування" → "Поля").
Усі параметри, передані після знака ?, автоматично зберігаються в картці підписника як значення відповідних кастомних полів, якщо такі поля вже існують.
Використовуйте унікальні значення traffic_mark для різних джерел трафіку. Це дозволить точно відстежити, звідки прийшов кожен підписник, і забезпечити коректну аналітику.
Назви параметрів не повинні містити пробілів, кирилиці чи спеціальних символів. Рекомендується використовувати лише латиницю, цифри та символ підкреслення _.

Як передати UTM-мітки через свій сайт у Leeloo.Ai?

Сформуйте редирект у http://leeloo.ai за кнопкою на вашому сайті.
Замініть traffic_mark у коді.
Після того як ви отримаєте traffic_mark, відкрийте код і замініть частину traffic_mark у базовому посиланні.

<script>
    document.addEventListener("DOMContentLoaded", function() {
        // Получаем все параметры из URL текущей страницы
        var urlParams = new URLSearchParams(window.location.search);
        var utmParams = urlParams.toString();
        
        // Базовая ссылка на вашего Telegram-бота (замените на ваш traffic_mark)
        var baseLink = "https://app.leeloo.ai/telegram/messenger-redirect/traffic_mark";
        
        // Проверяем, есть ли UTM-метки
        if (utmParams) {
            // Добавляем параметры к ссылке
            var finalLink = baseLink + "?" + utmParams;
        } else {
            // Если UTM-меток нет, используем базовую ссылку
            var finalLink = baseLink;
        }
        
        // Находим все элементы с классом кнопки или ссылкой, указывающие на вашего бота
        var telegramLinks = document.querySelectorAll('a[href*="ref"]');
        
        // Обновляем каждую ссылку
        telegramLinks.forEach(function(link) {
            link.setAttribute("href", finalLink);
        });
    });
</script>

Замініть traffic_mark на реальний ідентифікатор вашого трафіку.

Замінити в полі href*="ref"
У рядку:

var telegramLinks = document.querySelectorAll('a[href*="ref"]');

Замініть "ref" на клас вашої кнопки або посилання. Наприклад, якщо у вас посилання з класом leeloo-redirect-btn, оновіть рядок так:

var telegramLinks = document.querySelectorAll('a.leeloo-redirect-btn');

Вставити код у верстку сайту

Тепер, коли ви оновили код із потрібним traffic_mark і класом кнопки, вставте його у верстку вашого сайту в те місце, де потрібно буде використати редирект.

Таким чином, коли відвідувач перейде за посиланням, UTM-мітки будуть передані та використані для відстеження трафіку і персоналізації повідомлень у Leeloo.

Як передати дані через свій сайт у Leeloo.Ai?

Налаштуйте редирект на http://leeloo.ai при натисканні кнопки на вашому сайті.
Створіть необхідні поля в особистому кабінеті http://Leeloo.Ai .
У наведеній нижче інструкції замініть посилання на редирект у рядку 5 на ваше власне.

const baseUrl = "https://app.leeloo.ai/telegram/messenger-redirect/lwizsr";

У рядку 6 вкажіть назву змінної, що відповідає полю, яке ви раніше створили в http://Leeloo.Ai.

const finalUrl = `${baseUrl}?variable=${country}`;

<script>
    function goToLink() {
      const country = encodeURIComponent(document.getElementById('countryInput').value.trim());
      if (country) {
        const baseUrl = "https://app.leeloo.ai/telegram/messenger-redirect/lwizsr";
        const finalUrl = ${baseUrl}?variable=${country};
        window.location.href = finalUrl;
      } else {
        alert("Please enter a country.");
      }
    }
  </script>