Home/Трекер/Атрибуция трафика в Telegram-каналы

Атрибуция трафика в Telegram-каналы

1. Обзор

Атрибуция трафика в Telegram-каналы — это отслеживание вступлений пользователей в закрытые Telegram-каналы и группы, пришедших из ваших рекламных кампаний. Трафик направляется через Telegram-бота, который контролирует вступление и точно фиксирует конверсию, привязывая каждое вступление к конкретному клику, кампании, источнику и креативу.

Это решает главную проблему трафика на Telegram: обычно после перехода в мессенджер клик «теряется», и невозможно понять, из какой связки пришёл подписчик. Бот-посредник восстанавливает эту связь и превращает вступление в измеримую конверсию.

Что позволяет функция:

✅ Привязывать вступление в канал к клику, кампании, источнику трафика и креативу
✅ Строить воронку «клик → запуск бота → вступление» с процентами конверсии
✅ Работать с закрытыми каналами и группами через заявки на вступление
✅ Автоматически одобрять заявки после атрибуции
✅ Передавать конверсии в партнёрскую сеть (CPA) и принимать постбэки со статусами (депозит, регистрация, отклонён и т.д.)

⚠️ Не путайте с пикселем «Telegram Bot — отбивка конверсий». Это две разные функции, которые используют Telegram-ботов, но решают противоположные задачи:

Функция	Направление	Назначение
Атрибуция Telegram-каналов (эта статья)	Трафик из рекламы в ваш канал	Отследить, из какой связки пришёл подписчик, и зафиксировать конверсию вступления
Пиксель «Telegram Bot»	Уведомления в ваш рабочий чат	Присылать команде уведомления о конверсиях (депозиты, регистрации) в реальном времени

Подробнее о пикселе уведомлений — в статье Telegram Bot — отбивка конверсий в Telegram-канал.

2. Как это работает

Полный путь пользователя от клика по рекламе до вступления в канал:

Пользователь кликает по объявлению → открывается ваша трекинговая ссылка. Трекер фиксирует клик (SOURCE_CLICK) и присваивает ему уникальный clickId.
Трекер автоматически перенаправляет пользователя в бота по ссылке вида t.me/<botUsername>?start=<clickId>.
Пользователь нажимает Start в боте → бот запоминает связку «клик ↔ Telegram-пользователь», отправляет приветственное сообщение и ссылку-приглашение в канал. Фиксируется событие TG старт (TG_START).
Пользователь нажимает ссылку-приглашение → создаётся заявка на вступление → бот автоматически одобряет её и фиксирует конверсию TG вступление (TG_JOIN). Пользователь оказывается в канале.

Реклама
   │
   ▼
Трекинговая ссылка (клик, clickId)
   │
   ▼
Бот: /start  →  TG старт  (welcome + ссылка-приглашение)
   │
   ▼
Заявка на вступление  →  бот одобряет  →  TG вступление (конверсия)
   │
   ▼
(опционально) CPA-постбэк: депозит / регистрация / отклонён …

Окно атрибуции. После запуска бота у пользователя есть 1–7 дней (настраивается, по умолчанию 2 дня), чтобы вступить в канал — если он не вступил, связка автоматически удаляется. После вступления связка хранится ещё 30 дней, чтобы CPA-сеть успела прислать постбэки со статусами конверсии.

3. Предварительные требования (в Telegram)

Перед настройкой в платформе подготовьте бота и канал в самом Telegram:

Создайте бота у @BotFather. Отправьте команду /newbot, задайте имя и username, получите токен вида 123456:ABC-DEF1234ghIkl....
Добавьте бота в целевой канал/группу и назначьте его администратором. Боту необходимы права на управление пригласительными ссылками и одобрение заявок на вступление — без них атрибуция работать не будет.

💡 Совет: username бота (@...) вводить в платформе не нужно — система определит его автоматически по токену.

4. Шаг 1. Создание бота (Tracker → Telegram Bots)

Перейдите в раздел Tracker → Telegram Bots (в меню — пункт с иконкой Telegram).

[Вставить скриншот: раздел Telegram Bots с таблицей ботов]

Доступ к разделу: Owner, Team Lead, Tech и администраторы. Роли Buyer раздел управления ботами недоступен (баер работает уже с готовыми ссылками офферов).

4.1. Добавление бота

Нажмите «Добавить бота» и заполните форму:

Поле	Описание	Обязательное
Имя бота	Понятное название для идентификации бота в платформе (напр. «Мой бот для атрибуции»)	✅ Да
Токен бота	Токен, полученный у @BotFather. При редактировании оставьте поле пустым, чтобы сохранить текущий токен	✅ Да (при создании)

После сохранения платформа проверит токен и автоматически подтянет username бота. Если токен недействителен, бот не будет создан.

4.2. Настройка Webhook

Чтобы бот начал получать события от Telegram (нажатия Start, заявки на вступление), нужно настроить webhook:

В строке бота откройте меню действий (⋮).
Выберите «Setup Webhook» и подтвердите.
Статус в колонке Webhook изменится на Active.

Чтобы временно отключить приём событий, используйте «Remove Webhook».

⚠️ Важно: без настроенного webhook бот не будет реагировать на команду /start и на заявки на вступление — атрибуция не заработает.

4.3. Таблица ботов

В таблице отображаются все ваши боты со статусами:

Колонка	Описание
Name	Название бота в платформе
Bot Username	Username бота (`@...`) — ссылка ведёт на бота в Telegram
Status	Активность бота: Active / Inactive
Webhook	Состояние webhook: Active (настроен) / Inactive (не настроен)
Channels	Список каналов/групп, где бот является администратором
Owner / Team	Владелец и команда (столбец Team виден только администраторам)
Created	Дата создания

5. Шаг 2. Подключение каналов

Чтобы бот мог направлять трафик в канал, канал должен быть в его списке. Есть два способа добавить канал — оба в меню действий бота (⋮).

5.1. Обновить каналы (автоматически)

Если вы уже добавили бота администратором в канал/группу, просто нажмите «Refresh Channels» (Обновить каналы). Платформа опросит Telegram, найдёт все каналы, где бот админ, и обновит список. В уведомлении будет указано, сколько каналов найдено.

При обновлении каналы, где бот больше не является администратором, автоматически удаляются из списка.

5.2. Добавить канал вручную

Выберите «Add Channel» (Добавить канал) и укажите канал:

Поле	Описание
Chat ID or @username	Числовой ID чата (напр. `-1001234567890`) или `@username` канала/группы, где бот является администратором

Платформа проверит, что бот действительно администратор указанного канала, подтянет его название и добавит в список. Подключённые каналы отображаются в колонке Channels.

6. Шаг 3. Создание Offer Link (потока) с типом Telegram

Теперь создайте ссылку оффера (Offer Link), которая будет направлять трафик в канал. Перейдите в Tracker → Offer Links и создайте/отредактируйте ссылку. Основы работы со ссылками офферов описаны в статье Ссылки на оффер.

В поле Type (тип хостинга) выберите «Telegram channel» (Телеграм канал). Поле URL скроется, и появится блок настроек Telegram:

[Вставить скриншот: блок настроек Telegram в форме Offer Link]

Поле	Описание	Обязательное
Telegram Bot	Бот, через которого пойдёт атрибуция. Список — из раздела Telegram Bots	✅ Да
Channel (Канал)	Канал/группа, куда направляется пользователь. Выбирается из каналов бота или вводится вручную (`-100XXXXXXXXXX`)	✅ Да
Attribution Window (Окно атрибуции, дни)	Сколько дней ждать вступления после запуска бота. Диапазон 1–7, по умолчанию 2	❌ Нет
Welcome Message (Приветственное сообщение)	Текст, который бот отправит пользователю при `/start`. Поддерживает HTML-разметку	❌ Нет
Invite Link (Ссылка-приглашение)	Долгоживущая ссылка на вступление. Можно оставить пустой — бот создаст её автоматически при первом `/start`	❌ Нет

Пример настройки:

Offer Link:        CryptoChannel Telegram
Type:              Telegram channel
Telegram Bot:      @my_attribution_bot
Channel:           Crypto Signals VIP (-1001234567890)
Attribution Window: 2 дня
Welcome Message:   Добро пожаловать! Нажмите ссылку ниже, чтобы вступить в канал 👇

7. Шаг 4. Запуск и распространение ссылки

Прикрепите созданную Offer Link к кампании/потоку так же, как обычную ссылку оффера. В рекламе вы используете обычную трекинговую ссылку вашей кампании или источника.

Deep link в бота (t.me/<botUsername>?start=<clickId>) формируется автоматически в момент перехода, с уникальным clickId для каждого пользователя. Поэтому в интерфейсе нет статичной «готовой» ссылки на бота — и не должно быть.

⚠️ Важно: не давайте пользователям прямую ссылку на канал в обход бота. Вступления, сделанные напрямую (не через /start и ссылку-приглашение бота), не будут атрибутированы.

8. Аналитика: воронка Telegram

В Конструкторе отчётов доступны метрики категории Telegram. Они позволяют увидеть всю воронку от клика до вступления:

Метрика	Что показывает
TG старты	Количество запусков бота (нажатий Start) — событие TG_START
TG вступления	Количество вступлений в канал — конверсия TG_JOIN
Клик в старт	Конверсия «клик → запуск бота», %
Клик в вступление	Конверсия «клик → вступление в канал», %

Воронка читается так: Клики → TG старты → TG вступления. Метрики можно группировать по кампаниям, источникам, креативам и другим измерениям, как и остальные показатели трекера.

9. CPA-постбэки по Telegram-подписчику

Если оффер оплачивается по статусам (депозит, регистрация, отклонён и т.д.), CPA-сеть или владелец канала могут присылать постбэки прямо по Telegram-подписчику — без знания clickId. Достаточно ID пользователя Telegram и ID канала.

Эндпоинт:

GET https://<ваш-домен>/postback/tg

Параметр	Обязательный	Описание
`tg_user_id`	Да	Telegram user ID подписчика
`channel_id`	Да	ID канала/группы (`-100XXXXXXXXXX`)
`status`	Да	Статус конверсии из CPA-оффера (например `approved`, `hold`, `decline`)
`revenue` / `amount`	Нет	Выплата за конверсию (по умолчанию 0)
`currency`	Нет	Валюта выплаты (по умолчанию USD)
`external_id`	Нет	Внешний ID конверсии на стороне CPA
`accept_status`, `hold_status`, `decline_status`, `trash_status`, `redep_status`	Нет	Свои значения статусов для маппинга (переопределяют настройки CPA)

Пример запроса:

GET https://your-domain.com/postback/tg?tg_user_id=123456789&channel_id=-1001234567890&status=approved&revenue=5&currency=USD

Платформа найдёт последнее вступление этого подписчика в указанный канал, восстановит связку с кликом и зарегистрирует конверсию с нужным статусом (депозит, hold и т.д.). Запись доступна для постбэков в течение 30 дней после вступления.

Общие принципы работы постбэков и статусов описаны в статье Конверсии (Postback). Историю входящих постбэков можно посмотреть в логах постбэков.

10. Частые вопросы (FAQ)

Бот не реагирует на Start — что проверить?
Убедитесь, что для бота настроен webhook (колонка Webhook = Active) и бот активен (Status = Active).

Вступления не засчитываются как конверсии.
Проверьте, что: (1) бот является администратором канала с правом одобрять заявки; (2) пользователи вступают именно по ссылке-приглашению от бота, а не по вашей прямой ссылке на канал; (3) вступление произошло в пределах окна атрибуции (1–7 дней после старта).

Канал не появляется в списке при создании Offer Link.
Добавьте бота администратором в канал и нажмите «Refresh Channels» в разделе Telegram Bots, либо добавьте канал вручную по его ID.

Нужно ли вводить username бота?
Нет. Платформа определяет username автоматически по токену при создании бота.

Можно ли использовать один бот для нескольких каналов?
Да. Один бот может обслуживать несколько каналов/групп; в Offer Link вы выбираете конкретный канал.

Что происходит, если пользователь не вступил в канал?
Связка «клик ↔ пользователь» удаляется по истечении окна атрибуции, и вступление после этого срока уже не будет атрибутировано.

11. Важные особенности и ограничения

100% контроль вступлений. Ссылка-приглашение создаётся с обязательной заявкой на вступление — пользователь не входит напрямую, а его заявку одобряет бот. Это обеспечивает точную атрибуцию каждого вступления.
Бот обязательно должен быть администратором целевого канала/группы с правами на управление приглашениями и одобрение заявок.
Окно атрибуции — 1–7 дней (по умолчанию 2). После вступления связка живёт ещё 30 дней для приёма CPA-постбэков.
Ссылка-приглашение кэшируется. Она создаётся один раз при первом /start и переиспользуется — можно задать и свою.
Токен хранится в зашифрованном виде. Платформа не показывает его повторно; при редактировании можно оставить поле пустым, чтобы не менять токен.
Раздел Telegram Bots недоступен роли Buyer — управление ботами ведут Owner, Team Lead, Tech и администраторы.

Кампании и потоки Автоправила Aff. Networks (Партнёрские сети)Партнерские сети и Офферы Офферы Ссылки на оффер