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)Партнерські мережі та офери Офери Посилання на офер