Tracker

🚀 Створити TikTok-кампанію

Один потік: назва + pixel → готовий /go/ URL з лендингом і всіма параметрами.

⚡

Це одна точка створення нової кампанії — заповнюєш 3 поля → отримуєш ВСЕ одразу:
✅ Канал у БД · ✅ invite-link через Telegram API · ✅ Лендинг з шаблону · ✅ Pixel + Access Token прив'язані · ✅ /go/-URL з UTM-параметрами
Коли НЕ сюди: якщо канал вже є і потрібен лише новий URL під іншу TT-кампанію → 📝 Посилання (швидше).

📝 Крок 1 — Назва і канал

Назва кампанії

Стане частиною /go/-URL (slug). Латиниця, цифри, _.

Telegram канал

@testlepo_bot має бути адміном цього каналу (з правом invite users).

💡 Префікси для welcome-воронки: бот направляє нових юзерів у різні welcome-сценарії залежно від назви креативу. Іменуй назву так:

sport_* — спортивні креативи (футбол, типи на матчі)
money_* — money-креативи (банк-нотифікації, "виграла X PLN")
Будь-що інше → fallback на загальну гілку all

🎯 Крок 2 — TikTok Pixel

TikTok Pixel ID

З TT-кабінету: Tools → Events → Web events → Pixel ID

TikTok Access Token

З TT-кабінету: налаштування цього pixel → Events API → Access Token

🪄 Крок 3 — Що буде створено автоматично

✅ Новий invite-link у вибраному TG-каналі (через Telegram API)
✅ Лендинг з шаблону vipkupony з вашими pixel + invite
✅ Pixel ID + Access Token прив'язано до кампанії (для server-side Events)
✅ /go/-URL з UTM-параметрами для TT-реклами
✅ TG Subscribe events автоматично fire-яться при join каналу
✅ hello3vip-бот автоматично skip-не цих юзерів (бо source=tiktok)

Статистика

Завантаження...

📊

Що тут видно — повний funnel: клік → join → bot → реєстрація → депозит. KPI оновлюються 1×/хв.
Фільтри: Канал — вкладки зверху-справа · Період — на панелі нижче (Сьогодні / 7д / 30д / custom).
Шукаєш URL? → 📝 Посилання · Новий pixel/канал? → 🚀 Створити кампанію

📅 Період

→

🎯 Кліки

—

/go/ — TT-реклама

🟢 Приєднались

—

click → join: —%

🟡 Активували бота

—

join → bot: —%

📝 Зареєстровані

—

bot → reg: —%

💰 Перші депи (FTD)

—

reg → dep: —%

✅ Кваліфіковані

—

dep → qual: —%

🚫 Не активували бота

—

join без message/callback

📉 Відписались

—

left / kicked

💵 Revenue

—

сума депозитів

📊 Overall CR

—

join → deposit

Приєднання по днях (останні 14 днів)

Розбивка по кампаніях / ads / invite-link

Source	Invite link	Кампанія	Ad	Приєднались	Бот	Зареєстр.	Деп.	CR
Завантаження...

Звіт баєра

Кліки + конверсії по кампаніях

📈

Зведення по кампаніях — одна таблиця: кліки → join → mini-app → реєстрація → перші депи → кваліфікації. Кліки беруться з /go/, конверсії атрибутуються до кампанії через членство в каналі (tg_user → campaign).
CR клік→рег показує якість трафіку кампанії; (unattributed) — конверсії без прив'язки до кампанії (видно лише адміну).

🎯 Кліки

—

усі кампанії

🟢 Join

—

приєднались до каналу

📱 Mini-app

—

відкрили mini-app

📝 Реєстрації

—

casino reg

💰 Перші депи

—

FTD (унік. депозитори)

✅ Кваліфікації

—

qualified

💵 Revenue

—

сума депозитів

Розбивка по кампаніях

Кампанія	Кліки	Унік.	Join	Mini-app	Реєстр.	Перші депи	Кваліф.	Revenue	CR клік→рег	CR рег→деп
Завантаження...

Трекінг посилання

Готові лінки для TikTok Ads

📝

Коли сюди йти — у тебе вже є канал і pixel, треба URL під нову TT-кампанію на ньому. Заповни 4 поля → клік → URL в буфері.
Макроси __CALLBACK__ та __CLICKID__ залиш як є — TikTok сам підставить click_id.
Потрібен новий pixel/канал? → 🚀 Створити кампанію (там за 1 клік усе одночасно: новий канал + invite + landing + pixel + URL)

🪄 Згенерувати посилання під TT-кампанію

Заповни 4 поля → клік → готовий URL з UTM-параметрами, скопіюється у буфер. Вставляй у TT-ad.

💡 Працюєш з TT-рекламою? Натисни TT auto-fill — заповнить поля макросами __CAMPAIGN_NAME__ / __AID_NAME__, щоб TikTok сам підставляв реальні назви для кожного ad.

Канал

Source

Назва кампанії (або __CAMPAIGN_NAME__ для auto)

Назва оголошення (ad) (або __AID_NAME__)

⚠️ ВАЖЛИВО — конвенція назв оголошень для welcome-воронки:
Бот аналізує назву ad-а і направляє юзера у відповідну welcome-гілку. Тому ad-и треба іменувати з префіксом:

sport_* — спортивні креативи (Лєвандовскі, футбол, типи на матчі) → юзер отримає sport-welcome з типами на сьогодні
money_* — money-креативи (банк-нотифікації, "виграла X PLN", дівчата) → юзер отримає money-welcome з акцентом на бонусах
Будь-яка інша назва → fallback на загальну гілку all

Приклади правильних назв: sport_lewandowski_v1, sport_match_polska_v2, money_brunetka_mbank, money_winner_39200.

Альтернатива: вказати __AID_NAME__ — тоді TT сам підставить назву кампанії; конвенція має бути на стороні TT-кабінету (іменуй adgroup-и з префіксом).

URL для TT-ad (скопійовано):

📖 TT макроси — довідка

TikTok має свій формат макросів (інакший за FB/Google). Якщо встромиш FB-стиль ({{ttclid}}) — TT його НЕ підставить, атрибуція зламається.

Макрос	Що повертає	Важливість
`__CALLBACK__`	Click ID для постбек-атрибуції	обов'язково
`__CAMPAIGN_NAME__`	Назва кампанії	бажано
`__CAMPAIGN_ID__`	ID кампанії	бажано
`__AID_NAME__`	Назва adgroup	бажано
`__AID__`	ID adgroup	опційно
`__CID_NAME__`	Назва креативу	опційно
`__CID__`	ID креативу	опційно
`__PLACEMENT__`	Placement (TikTok/TopBuzz)	опційно

❌ НЕ використовувати: {{ttclid}} (FB-style), {click_id} (Google-style), __FB_CLICKID__ — TT їх не підставить, у БД прилетить буквальний рядок.

Воронка

Кроки після підписки на канал

Користувачі

Управління доступом

Логін	Роль	Доступ до каналів	Створено
Завантаження...

Лендінги

Завантаження ZIP-архівів лендінгів

Завантажити лендінг

Канал

ZIP-файл

Активні лендінги

🚀 Деплой з шаблону

📁

Авто-редірект при завантаженні

Назва	Канал	URL
Завантаження...

Запрошення (invite links)

Створи джерело-теговані invite linki. Бот фільтрує по них — TikTok тільки до нашого, інші до retention бота.

➕ Створити нове запрошення

Назва (для тебе)

Source tag

Канал

Термін дії (дні, 0 = ніколи)

Через ChatJoinRequest (бот approve — потрібно для фільтрації)

Активні запрошення

Назва	Source	URL	Канал	Режим	Members	Створено
Завантаження...

Анкета — онбординг TikTok-юзерів

Адаптивна анкета (Q1 → гілка), статистика відповідей і розподіл по гілках воронки.

Усього юзерів

—

Завершили анкету

—

Пропустили

—

Не відповіли

—

Гілки воронки

Conversion rate анкети

Розподіл відповідей по питаннях

📖 Як працює трекер

Покрокова інструкція для медіа-баєра. Що за чим робити, що редагується через UI, що — через код.

🎯 Що робить цей трекер

Веде юзера від кліку на TikTok-рекламу до депозиту на GGBet і фіксує кожен крок: клік → лендінг → join Telegram-каналу → welcome-бот → mini-app → реєстрація → депозит. Кожен крок прив'язується до click_id (TikTok ttclid), тому ти бачиш реальну атрибуцію між креативом і конверсією.

🔄 Повний шлях юзера (E2E)

1. TikTok ad → клік → URL вигляду https://tracker.goldbe.fun/go/channel_1?ttclid=XXX

2. Тракер логує клік, fire ViewContent у TikTok Events API, robi redirect на лендінг

3. На лендінгу — preview каналу + кнопка "VIEW IN TELEGRAM" → юзер тисне → join request у канал

4. Бот @testlepo_bot отримує chat_join_request, перевіряє source через invite_link → source_tag

5. Якщо tiktok — бот approve + DM-ить юзеру анкету (Q1)

6. Юзер проходить анкету (1-5 питань залежно від досвіду), система визначає гілку: novice/interested/advanced

7. Бот шле welcome-пости — тільки ті, що мають його гілку (з /admin → канал → пости)

8. Юзер тисне кнопку → mini-app або Keitaro → GGBet

9. GGPartners шле postback при реєстрації/депозиті → тракер фіксує статус юзера

🗂 Що робить кожна вкладка

📊 Статистика
Кліки, унікальні кліки, конверсії, CR%, бекдаун по UTM+source, графік по днях. Фільтри по каналу.

🔗 Посилання
Готові /go/-URL для копіювання у TikTok-ads. Сюди вставляєш кожне в окрему рекламну кампанію.

🎯 Воронка
Кроки воронки + CR між ними. Видно де юзер дропає (клік→лендінг→join→reg→deposit).

👥 Користувачі (admin)
Аккаунти для логіну в дашборд. Можна створити role=buyer з обмеженим доступом до 1 каналу.

📦 Лендінги (admin)
2 шляхи: (а) ZIP-завантаження готового лендінгу, (б) Деплой з шаблону. При виборі каналу автоматично підтягуються дефолти (TG link, аватарка, опис, pixel). Кожен лендінг живе за http://tracker.goldbe.fun/l/<slug>/.

🎰 GGBet (admin)
Постбеки з GGPartners. Видно тих, хто зареєструвався, депозитував, кваліфікувався. Якщо постбеки не йдуть — перевір secret + URL у GGPartners панелі.

🔗 Запрошення (admin)
Створюєш invite-link у канал з тегом source (tiktok/fb/organic). Бот фільтрує по тегу — тільки tiktok-юзери йдуть у нашу воронку, інші джерела (organic, retention) — обробляються окремим ботом.

📝 Анкета (admin)
Статистика проходження анкети: розподіл по гілках, CR анкети, відповіді на кожне питання. Видно який % новачків vs досвідчених.

📡 Канали (admin)
Редагуй або додавай нові канали через форму ➕ — кожен канал = власний /go/<key> + власний TikTok pixel + access token + landing_url + дефолти для лендінгу. Можна тримати багато pixel-ів для одного Telegram-каналу (різні TT-кампанії). Зміни — миттєво, без рестарту.

⚡ Quick-start: запуск нової кампанії на існуючому каналі (DarmowyVIP)

Зайди 📡 Канали → переконайся що landing_url, pixel_id, access_token заповнені для DarmowyVIP. Якщо дефолти лендінгу (аватарка, опис) — теж постав.
Зайди 🔗 Запрошення → створи новий invite з source_tag=tiktok. Скопіюй URL виду https://t.me/+... — це буде ваш entry-point.
Зайди 📦 Лендінги → "Деплой з шаблону" → вибери канал DarmowyVIP → у поле "TG link" встав invite з кроку 2 → решта auto-fill → 🚀 Деплоїти. Запам'ятай URL лендінгу.
Зайди 📡 Канали → постав landing_url = свій новий лендінг (або згенерований TikTok-генератор). Це визначає куди веде /go/channel_1.
Зайди 🔗 Посилання → скопіюй URL виду /go/channel_1?utm=... → встав у TikTok ad creative.
Запусти кампанію. Дивись результат у 📊 Статистика + 📝 Анкета + 🎰 GGBet.

🆕 Як додати НОВИЙ pixel для каналу (новий /go/-URL)

Цей сценарій підходить коли ти запускаєш другу TT-кампанію (або A/B-тест), але хочеш окрему статистику і окремий TikTok pixel. Telegram-канал залишається той самий — змінюється тільки точка входу і pixel.

📡 Канали → зверху форма "➕ Додати новий канал (новий pixel)"
Заповни:
- key: slug, напр. tt_pixel_2 або darmowyvip_v2 (тільки a-z, 0-9, _, -)
- Назва: видна тобі в дашборді, напр. DarmowyVIP TT2
- Landing URL: куди вестиме /go/tt_pixel_2 (твій новий генератор або новий лендінг)
- TG invite: https://t.me/+... — те саме що для DarmowyVIP (юзери йдуть в той самий канал)
- TikTok Pixel ID: НОВИЙ pixel ID з TT-кабінету
- TikTok Access Token: НОВИЙ access token цього pixel-a
- Аватарка, опис, subscribers — опціонально, можна продублювати з DarmowyVIP
- Telegram TG ID — порожньо (не обов'язково для трекінгу)
Натисни ➕ Створити канал → внизу з'явиться картка з бейджем створено в UI
Скопіюй новий URL і встав у TT-ad: https://tracker.goldbe.fun/go/tt_pixel_2?ttclid=__CALLBACK__&clickid=__CLICKID__
У TT-кабінеті в налаштуваннях кампанії прив'яжи той самий новий pixel (для front-end fire). Server-side fire трекер зробить сам через access_token.
Запусти кампанію. У 📊 Статистика фільтр по каналу → побачиш окремо channel_1 (стара) і tt_pixel_2 (нова).

Важливо: старий /go/channel_1 продовжує працювати зі старим pixel. Створення нового каналу не зачіпає старі. Юзери з обох /go/ потрапляють у той самий Telegram (якщо TG invite однаковий) і обробляються ботом однаково.

📌 Видалити UI-канал: у його картці кнопка 🗑 Видалити. Канали з config.py (channel_1, channel_2) видалити неможливо — тільки 🔄 Reset до дефолтів.

✅ Що редагується через UI (без рестарту)

Додавати нові канали + pixel-и — 📡 Канали → ➕ Додати новий канал
Усі поля каналу (landing_url, pixel, token, дефолти лендінгу) — 📡 Канали
Invite links + auto/manual режим — 🔗 Запрошення
Лендінги (створити/редагувати/видалити) — 📦 Лендінги
Юзери дашборду — 👥 Користувачі
Welcome-пости бота (тексти, фото, кнопки, гілки) — у самому боті: /admin
Тексти анкети — у боті /admin → 🎯 Редактор анкети
Preview анкети — у боті /preview_survey (адмін)

⚠ Що НЕ редагується через UI (потребує scp+restart)

Структура анкети (порядок питань, скільки в гілці) — логіка _next_question
Додати нову гілку (наприклад "vip") — захардкоджено в коді
Шаблон лендінгу (HTML/CSS) — файли у landing_template/
BOT_TOKEN, MONGO_URI, інші секрети — у config.py / bot/settings.py

🔧 Troubleshooting (часті кейси)

«Клік у статистиці є, але юзер не отримав welcome»
Перевір: чи invite має source_tag=tiktok? Якщо source невідомий боту → той ігнорує join. У 🔗 Запрошення натисни на invite — переконайся в тегу.

«TikTok pixel не отримує події»
Перевір 2 речі: (1) pixel_id прописаний у HTML лендінгу — глянь View Source. (2) access_token у 📡 Канали — server-side fire потребує його. Тест: відкрий /go/channel_1 + 30 сек глянь у TikTok Events Manager.

«GGPartners postback не приходить»
У GGPartners панелі перевір URL постбеку (має містити поточний secret) + статус "Active". Можливий fallback через Keitaro S2S-проксі.

«Юзер пройшов анкету але не отримав welcome»
Перевір що у /admin створені пости з потрібною гілкою. Якщо всі пости тільки з branches=["all"] — нові гілки нічого не побачать (тоді all-пости йдуть і їм). Якщо є пости з branches=["novice"] — піде тільки новачкам.

«Анкета не з'являється у юзера»
Перевір, що бот approve-нув join (логи). Якщо approve був, але DM не дійшов — юзер заблокував бота або в нього privacy=only contacts. Це нормально, fallback через 2 хв шле default welcome.

📚 Корисні URL-шаблони

Клік-трекер для TikTok ad:  https://tracker.goldbe.fun/go/<channel_key>?ttclid=__CALLBACK__&clickid=__CLICKID__
↑ Підтримуються обидва макроси (TT підставить той, який знає; зайвий — фільтрується автоматично)
Лендінг:  http://tracker.goldbe.fun/l/<slug>/
API статистики:  GET /api/stats?channel=<key>
Анкета stats:  GET /api/survey/stats
Канали settings:  GET /api/channel_settings
Tracker dashboard:  https://tracker.goldbe.fun/

Учасники каналу

Lifecycle кожного юзера: приєднався → активував бота → можливо відписався + статус GGBet постбеку.

👥

Кожен рядок = один юзер у каналі. Колонки: TG-id, ім'я, країна, OS, source (звідки прийшов), кампанія/ad, дати кроків, статус постбеку, депозити.
Фільтри: source · статус · період. 📥 Імпорт історичних — для одноразового підтягування підписок з MongoDB (бот) у нашу БД.
Хочеш агреговану funnel-статистику? → 📊 Статистика

📅 Період

→

Приєдналось

—

Активних

—

Активували бота

—

З постбеком

—

Відписались

—

TG ID	Ім'я / @user	Країна	OS	Source	Кампанія / Ad	Приєднався	Бот	Відписався	Постбек	Депозитів
Завантаження...

Постбеки

Audit log усіх вхідних запитів на /postback + симулятор для тестування ланцюга.

🔁

Журнал ВСІХ запитів на наш /postback — і прийнятих, і відхилених. KPI вгорі (24h, accept/reject). Колонка note показує особливості: simulated · duplicate · matched_via_miniapp_fallback.
🧪 Симулятор — fake-постбек на свій же /postback щоб тестити чейн без реального юзера. Не забуй що симульовані рядки потім бажано вичистити, щоб не псувати статистику.
Підсумкові цифри по конверсіях → 💰 GGBet · Funnel → 📊 Статистика

За 24 год

—

Прийняті

—

Відхилені

—

За 7 днів — топ event

—

Тільки відхилені

Час	IP	Метод	Path	Secret	Event	TG ID	Click ID	Сума	HTTP	Status after	Note
Завантаження...

Налаштування каналів

Редагуй або додавай канали. Кожен канал = власний /go/-URL + TikTok pixel. Зміни — миттєво, без рестарту.

➕ Додати новий канал (новий pixel)

Key — slug (a-z, 0-9, _, -). Стане частиною URL: https://tracker.goldbe.fun/go/<key>. Можна тримати багато pixel-ів для одного Telegram-каналу.

Завантаження...

GGBet — користувачі та постбеки

Реальні дані з GGPartners (Registration / Lead Hold / Lead Approval / Lead Reject)

Всього

—

Зареєстровані

—

З депозитом

—

Кваліфіковані

—

Відхилені (lead_reject)

—

CR в депозит

—

CR в кваліфікацію

—

📱 Відкриття mini-app

—

📱 Унікальні користувачі mini-app

—

🤖 Bot users всього

—

🤖 Bot users активні

—

Користувачі

TG ID	Статус	Депозитів	Сума	Реєстрація	1й депозит	Кваліф.	Оновлено
Завантаження...

Останні події (постбеки)

#	Час	Подія	TG ID	Click ID	Сума	pb_id
Завантаження...