> For the complete documentation index, see [llms.txt](https://docs.graspil.com/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.graspil.com/ru/app/landings.md). # Лендинги c переадресацией ### 1. Что это и зачем Когда вы запускаете рекламу, ведущую в Telegram-бота или канал, обычная ссылка вида `t.me/your_bot` не позволяет: * посчитать, сколько людей реально перешло по рекламе, до того как они нажали «Запустить» в Telegram; * передать UTM-метки рекламной кампании в сервисы аналитики (Google Analytics, Яндекс.Метрика) — Telegram их «обрезает»; * показать пользователю что-то промежуточное: логотип, выбор мессенджера, предупреждение про блокировку Telegram. **Лендинг** решает эти задачи. Это короткая ссылка вида `tlin.cc/your_alias`, на которую вы ставите рекламу вместо прямой ссылки на бота. Когда пользователь кликает по ней: 1. Открывается страница-посредник (или происходит мгновенный редирект — зависит от настроек). 2. Сохраняются переданные метки и параметры, они привязываются к пользователю при входе в бота/канал. 3. На сервера аналитики (если они подключены) уходит информация о переходе. 4. Пользователя перенаправляют в Telegram (или в любой другой мессенджер/сайт через кнопку). {% hint style="info" %} Можно создать **несколько лендингов на один ресурс** (бота или канал) — например, отдельный лендинг под каждую рекламную кампанию или площадку. {% endhint %} **Что можно делать с помощью лендингов:** * **Переносить UTM-метки** из рекламной ссылки в бота или канал — источник трафика не теряется. * **Подключать сквозную аналитику** — Google Analytics, Яндекс.Метрику, а также свои скрипты. * **Проверять, доступен ли Telegram** у пользователя, и предлагать альтернативу (WhatsApp, сайт и т.д.), если он заблокирован. * **Настраивать внешний вид** страницы: логотип, текста, тему (светлая/тёмная), кнопки. * **Собирать дополнительные данные** о переходе: часовой пояс, реферер, язык браузера и свои поля. {% hint style="warning" %} Лендинги — платная функция, доступна на платном тарифе. {% endhint %} *** ### 2. Основные понятия | Термин | Что значит | | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | **Лендинг** | Одна короткая ссылка на `tlin.cc` со своими настройками: адрес, оформление, кнопки и т.д. | | **Адрес (slug, alias)** | Часть ссылки после `tlin.cc/` — то, что идёт после слэша, например `tlin.cc/`**`promo1`** | | **Страница-посредник** | Промежуточная страница с логотипом, текстом и (опционально) кнопками выбора мессенджера, которую видит пользователь перед переходом | | **Прямой редирект** | Режим без страницы-посредника: пользователь сразу попадает в Telegram, без какой-либо аналитики и оформления | | **Ресурс** | Бот или канал, к которому привязан лендинг | *** ### 3. Где находится и как создать лендинг Раздел находится в личном кабинете: **Лендинги** (в меню настроек). 1. Откройте раздел **Лендинги** и нажмите **«Создать лендинг»**. 2. Если у вас несколько ботов/каналов — выберите, к какому **ресурсу** относится новый лендинг. 3. Выберите **адрес ссылки**: * **Подтверждённый username** — если у бота/канала есть подтверждённое публичное имя, можно использовать его как адрес (тогда ссылка совпадает с username). * **Случайный** — система сама сгенерирует короткий случайный адрес.

Адрес нельзя ввести произвольным текстом — это сделано, чтобы избежать путаницы и подделки ссылок. Доступны только подтверждённый username ресурса или сгенерированный системой код.

4. Включите или выключите переключатель **«Показывать страницу-лендинг»**: * **Включено** — пользователь увидит оформленную страницу-посредник (с аналитикой, кнопками и т.д.). * **Выключено** — мгновенный редирект в Telegram без страницы и без аналитики. 5. Настройте оформление и поведение страницы (см. ниже). 6. Нажмите **«Создать»**. Готовая ссылка появится карточкой в списке — её можно скопировать кнопкой **«Копировать»** и сразу использовать в рекламе. *** ### 4. Настройка страницы-посредника Если включена **«Показывать страницу-лендинг»**, доступны следующие настройки. #### Логотип Загрузите картинку (PNG/JPG/WEBP/GIF, до 2 МБ), которая будет показана в верхней части страницы. Если логотип не загружен — он просто не отображается. #### Поведение **Переадресация** — как именно происходит переход в Telegram: * **Автоматически** — пользователь перенаправляется сразу после загрузки страницы, без лишних действий. * **По кнопке** — страница показывает кнопки (Telegram и, при наличии, другие мессенджеры/сайты), и пользователь сам решает, куда перейти. **Тема** — внешний вид страницы: **тёмная**, **светлая** или **авто** (подстраивается под настройки устройства пользователя). **Проверка доступности Telegram** — перед переходом страница в фоне проверяет, открывается ли Telegram у пользователя. {% hint style="info" %} **Зачем это нужно:** в некоторых странах и сетях Telegram заблокирован. Если проверка показывает, что он недоступен — вместо «битого» перехода пользователю показывается подсказка включить VPN и альтернативные кнопки (например, WhatsApp). Если Telegram доступен — в режиме «Автоматически» происходит обычный переход, а в режиме «По кнопке» пользователь всё равно видит кнопки выбора, но без подсказки про VPN. {% endhint %} #### Аналитика и скрипты Чтобы передавать данные о переходах в сервисы аналитики, укажите: * **ID Яндекс.Метрики** * **ID Google Analytics** Если счётчики указаны, на сервер дополнительно передаются идентификаторы клиента (`ym_uid`/`ga_uid`) — это нужно для сквозной аналитики (чтобы связать клик по рекламе с конкретными действиями пользователя). Также можно вставить **свои скрипты** — произвольный код для `` и `` страницы. Это пригодится, если вы используете другой аналитический сервис или пиксель. #### Дополнительные поля Можно включить сбор дополнительных данных о переходе: * **Часовой пояс** пользователя; * **Источник перехода** (referrer) — откуда пришёл пользователь; * **Язык браузера**. Также можно задать **статические поля** — пары «ключ → значение», которые будут добавляться к каждому переходу по этому лендингу (например, чтобы помечать, с какой именно площадки или баннера идёт реклама). #### Кнопки мессенджеров Если включён режим **«По кнопке»** (или просто нужны дополнительные варианты связи), можно добавить кнопки: * **Тип** — Telegram, WhatsApp, Max, Viber, VK, сайт или «другое» (произвольная ссылка). * **Подпись** — текст кнопки. * **Описание** — короткая подсказка под подписью. * **Иконка** — для типа «другое» можно выбрать иконку из готового набора или загрузить свою картинку. {% hint style="info" %} Кнопка Telegram добавляется автоматически — отдельно создавать её не нужно, ссылка для неё берётся из самого редиректа. {% endhint %} #### Предпросмотр В редакторе есть живой предпросмотр — он показывает страницу именно так, как её увидит пользователь, с учётом всех текущих настроек (логотип, тема, кнопки, тексты). Сам переход и аналитика в предпросмотре не выполняются. #### Тексты Все подписи на странице (заголовок, подсказки, текст кнопок) можно переопределить под нужный язык — выберите язык в выпадающем списке и впишите свой текст. Если поле оставить пустым — используется стандартный перевод. {% hint style="info" %} Чтобы переопределить текст конкретной кнопки, кнопку нужно сначала сохранить (после первого сохранения у неё появляется свой идентификатор, и в разделе «Тексты» можно задавать перевод именно для неё). {% endhint %} *** ### 5. Встраивание на свой сайт #### Для чего это нужно Если у вас уже есть собственный сайт-лендинг (например, на конструкторе сайтов или написанный программистом) и вы хотите сохранить свой дизайн, но получить ту же логику переадресации, что и на странице `tlin.cc` — её можно встроить прямо на свою страницу. Это удобно, когда: * у вас уже готов яркий дизайн страницы и переделывать его на `tlin.cc` не хочется; * нужен собственный домен в адресной строке (своя страница вместо `tlin.cc/...`); * лендинг — часть более крупной страницы (например, есть и другой контент, не только переход в Telegram). #### Как это работает Технически переадресация работает в виде небольшого виджета — кусочка кода на JavaScript, который выполняет ту же работу, что и страница на `tlin.cc`: 1. Загружает скрипт `tlin.js`. 2. Запускает виджет в указанном месте страницы. 3. При необходимости проверяет, доступен ли Telegram у пользователя. 4. Обращается на сервер tlin (по адресу, заданному в коде) и узнаёт, куда именно нужно перенаправить пользователя — этот адрес формируется на основе настроек вашего лендинга (с учётом UTM-меток и других параметров). 5. Перенаправляет пользователя — автоматически или после нажатия кнопки, в зависимости от выбранного режима. #### Как использовать 1. Откройте редактор нужного лендинга и перейдите в раздел **«Встроить на свой сайт»**. 2. Скопируйте готовый код кнопкой **«Копировать»**. 3. Вставьте этот код в HTML-код вашей страницы, в то место, где должен появиться блок переадресации. Код выглядит примерно так: {% code title="Пример кода для вставки" overflow="wrap" %} ```html
``` {% endcode %} * `
` — это место на странице, куда виджет выведет свою разметку (например, кнопки, если включён режим «По кнопке»). Если используется режим «Автоматически» без кнопок — этот блок может остаться пустым, видимым его делать не обязательно. * Сам код `Tlin.init({...})` — это и есть настройки, которые вставляются автоматически на основе вашего лендинга: адрес лендинга (`username`), адрес сервера tlin (`apiBase`), режим переадресации (`mode`) и тема (`theme`). Если включена проверка доступности Telegram — в код добавится ещё и `telegramCheck`. {% hint style="info" %} Код нужно скопировать заново, если вы поменяли режим переадресации, тему или включили/выключили проверку Telegram в редакторе лендинга — старый код эти изменения не подхватит сам. {% endhint %} #### Что переносится в код, а что — нет В готовый код автоматически попадают: **адрес лендинга**, **режим переадресации** (авто/по кнопке), **тема** и **проверка доступности Telegram**. {% hint style="warning" %} Логотип, текстовые подписи, аналитика (Яндекс.Метрика/Google Analytics, свои скрипты) и кнопки мессенджеров, настроенные в редакторе, **в готовый код автоматически не попадают** — они применяются только на странице `tlin.cc`. Это сделано специально: на своём сайте у вас уже есть свой дизайн и, скорее всего, своя аналитика, поэтому переносить оформление со страницы `tlin.cc` не требуется. {% endhint %} Если вам нужны и логотип, и кнопки, и переопределённые тексты именно на встроенном виджете — их можно дописать вручную в код `Tlin.init({...})` (тем же способом, каким они хранятся в настройках лендинга). Это уже требует базовых знаний JavaScript/HTML — если такой задачи нет, обратитесь к своему разработчику или в поддержку. *** ### Частые вопросы **Можно ли сделать несколько разных ссылок для разных рекламных кампаний?**\ Да, можно создать сколько угодно лендингов на один и тот же бот или канал — у каждого будет свой адрес и свои настройки. **Что будет, если выключить показ страницы-лендинга?**\ Ссылка превратится в мгновенный технический редирект — без оформления, кнопок и аналитики. Подходит, если вам не нужна страница-посредник, а важна только сама ссылка. **Можно ли использовать свой домен вместо tlin.cc?**\ Сейчас нет, но вы можете встроить виджет переадресации на свой сайт через готовый код (раздел «Встроить на свой сайт»). **Лендинги доступны бесплатно?**\ Нет, это функция платных тарифов.