Документація

Зовнішні PWA та Telegram-канали

Два способи розширити воронку за межі власного конструктора PWA Orbitra: сторонні PWA-сервіси як цілі потоків і Telegram-канали як місця призначення офферів з атрибутованими підписниками.

Зовнішні PWA-конструктори

Сторонній сервіс (PWA.Group, TSL.app чи будь-який інший) може бути ціллю потоку точнісінько як лендинг:

  1. Створіть конструктор — ⚙ → Integrations → External PWA. Оберіть сервіс із каталогу (data/external_pwa_services.json: шаблон redirect URL, шаблон постбека, мапа статусів) або заповніть свій; ваші значення перемагають каталогові. Каталогові записи з коробки — це шаблони: перевірте кожен параметр за актуальною документацією сервісу перед запуском трафіку.
  2. Направте сервіс назад: у його налаштуваннях виставте редирект після встановлення на

https://<tracker-domain>/eflow/<campaign-alias>?subid={subid}&eid={eid} (сторінка показує точний вигляд для копіпасту).

  1. Додайте його в потік — у блоці лендингів редактора кампанії, Add external PWA. Зовнішні конструктори їдуть у тому самому зваженому пулі, що й лендинги, тож спліт дає вам A/B «власна PWA проти їхньої» в одній воронці.

Що відбувається на трафіку: клік іде на сервіс із subid = id кліка (clicks.external_pwa_id пам'ятає, який це сервіс). Коли відвідувач повертається на /eflow/<alias>, трекер штампує інстал (external_install_at), зберігає eid сервісу (тримається 7 днів) і продовжує на оффер через власний вибір кампанії — точнісінько як «власна» PWA після інсталу.

Конверсії на тих кліках постбекаться назад на сервіс через ту саму надійну s2s-чергу, що й партнерські постбеки, з subid + eid + статусним словом сервісу (мапиться по сервісах) + payout. Звіти кампаній отримують external installs.

Telegram-канали як оффери

Оффер типу Telegram-канал заводить рекламних відвідувачів у Telegram-канал через funnel-бота і зараховує вступ як конверсію. Funnel-боти — окремо від адмінського бота (Integrations → Telegram): адмінський бот відповідає лише в чатах, які ви підключили, і читає вашу статистику, тож сторонні люди з реклами ніколи не мають до нього дічатися. Панель відмовляє токен адмінського бота як funnel-бота.

Налаштування:

  1. Створіть нового бота в @BotFather і додайте його токен у ⚙ → Integrations → Telegram funnel bots.
  2. Додайте того бота в канал адміном із правом Invite users via link. Канал з'явиться на картці бота сам (або додайте його там за @name, t.me/… чи -100…).
  3. Створіть оффер типу Telegram, оберіть бота і канал, задайте вікно вступу (1–7 днів) і, опційно, привітальний текст.
  4. Покладіть оффер у потік кампанії і гоніть трафік через посилання кампанії. Ніколи не роздавайте пряме посилання на канал — такі вступи неможливо атрибутувати.

Воронка:

  1. Клік → https://t.me/<funnel bot>?start=<subid> — /start прив'язує Telegram-користувача до кліка (tg_start).
  2. Бот відповідає привітальним текстом і запрошенням, що вимагає запиту на вступ (creates_join_request=true, термін життя — вікно оффера).
  3. chat_join_request → бот схвалює лише користувачів, яких сам запросив у межах вікна, і пише конверсію tg_join (з кампанією та оффером) на прив'язаний клік. Запити від будь-кого іншого лишаються модераторам каналу.
  4. Мережа, що знає лише підписника, постить на звичайний postback URL з tg_user_id і channel_id замість subid:

https://<domain>/<postback key>/postback?tg_user_id={tg_user_id}&channel_id=-100…&status=deposit&payout=50 — це розв'язується в клік останнього вступу того користувача в канал протягом 30 днів. Точний URL показує вкладка Integration редактора оффера.

Funnel-боти опитуються через cli/tg_funnel_poll_cron.php (щохвилини, всі боти паралельно, без вебхука — працює без домену). install.sh ставить його в розклад; сторінка ботів показує рядок crontab, коли полер не працює.

← Попередній
Бібліотека креативів
Наступний →
Постбеки та конверсії
Переглянути джерело на GitHub: github.com/fenjo26/Orbitra.link/wiki
Усі гайди
Документація

Швидкий старт: ваша перша кампанія

Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.

Читати гайд →
Документація

Встановлення та оновлення

Встановіть Orbitra на чистий сервер Ubuntu або Debian однією командою та безпечно оновлюйтеся до нових версій.

Читати гайд →
Документація

Міграція з Keitaro

Перенесіть кампанії, оффери, джерела та домени з Keitaro в Orbitra одним імпортом — що переноситься і що перевірити після нього.

Читати гайд →
Документація

Міграція з Binom

Перенесіть кампанії та потоки з Binom у Orbitra через Public API: що переноситься автоматично, а що налаштувати вручну.

Читати гайд →
Документація

Огляд можливостей

Усе, що вміє Orbitra: кампанії та потоки, клоакинг, лендинги, PWA, постбеки, витрати, звіти та інтеграції.

Читати гайд →
Документація

Кампанії та потоки

Повна довідка: налаштування кампаній, типи потоків, схеми, ротація, фільтри, тестові посилання та кожна опція з поясненням.

Читати гайд →
Документація

Клоакинг

Повна довідка з клоакингу: шари детекції, глобальні налаштування, фільтри потоку, вердикти та звіти.

Читати гайд →
Документація

Перевірка браузера

Як JS-перевірка ловить ботів, віртуальні машини та емулятори за суперечностями в браузерному оточенні.

Читати гайд →
Документація

Лендинги

Типи лендингів, макрос {offer}, JS-адаптер, LeadForge та мультиофферні лендинги — повна довідка.

Читати гайд →
Документація

PWA та Web Push

Створюйте встановлювані PWA-застосунки та збирайте push-підписників: налаштування, іконки, події та сповіщення.

Читати гайд →
Документація

PWA-воронка

Воронка візиту на PWA-лендинг: екрани до встановлення, трекінг кожного екрана, статистика показів і матриця переходів.

Читати гайд →
Документація

Конверсійні попапи

Попап із кнопкою оффера на лендингах: вкладка Popup, вертикальні шаблони, тригери показу і метрики показів та CTR.

Читати гайд →
Документація

Записи сесій і теплові карти

Реплеї реальних візитів, теплові карти кліків і скролу, ліміти сховища, приватність і запис цілих сайтів.

Читати гайд →
Документація

Галерея контенту

Повна довідка Галереї: папки, завантаження, MediaPicker у редакторах, контракти розміру, обмеження форматів і відео.

Читати гайд →
Документація

Бібліотека креативів

Креативи з витратами, доходом і ROI: синк файлів з Facebook і TikTok, дедуплікація, звіти і алерт вигорання креативів.

Читати гайд →
Документація

Зовнішні PWA та Telegram-канали

Сторонні PWA-сервіси як цілі потоків (/eflow) і Telegram-канали як оффери: funnel-бот, вступи-конверсії та атрибуція.

Читати гайд →
Документація

Постбеки та конверсії

Вхідні постбеки, статуси й типи конверсій, вихідні S2S-постбеки на джерело, черга доставки, тестер і імпорт конверсій.

Читати гайд →
Документація

Витрати

Імпорт витрат з Facebook, TikTok, Google Ads і push/pop-мереж, розподіл по кліках, агентські комісії та агрегатор доходу.

Читати гайд →
Документація

Push- і pop-мережі

Імпорт витрат із push/pop-мереж і Zone Killer: правила, що знаходять і блокують зони, які палять бюджет.

Читати гайд →
Документація

Facebook / Meta

Імпорт витрат з Meta Ads і Conversions API: токени, мапінг статусів, серверні події з дедуплікацією і діагностика.

Читати гайд →
Документація

Dolphin / Fbtool

Отримуйте витрати Facebook у трекер через API Dolphin (Fbtool) у реальному часі: API-ключ, налаштування сервісів і розподіл витрат по кліках.

Читати гайд →
Документація

Чистильник коментарів FB

Масова модерація коментарів під рекламою Meta за розкладом: набори правил, винятки, сухий прогін, журнал дій і авто-пауза.

Читати гайд →
Документація

Джерела трафіку та партнерські мережі

Два довідники, що налаштовують «краї» воронки: шаблони джерел і мереж, параметри, постбек у джерело та офферні параметри.

Читати гайд →
Документація

Звіти, логи та метрики

Дашборд, список кампаній, конструктор звітів, тренди й когорти, лог трафіку та картка кліка — і як рахується кожна метрика.

Читати гайд →
Документація

Домени та SSL

Додайте домени, наведіть DNS на сервер, отримайте безкоштовний сертифікат Let's Encrypt і розберіться з кожним перемикачем на сторінці Domains.

Читати гайд →
Документація

Cloudflare

Інтеграція з Cloudflare через API: A-записи ставляться автоматично, а з проксі SSL роздає Cloudflare — без certbot і очікування валідації.

Читати гайд →
Документація

Адміністрування

Користувачі, ролі та права по ресурсах, налаштування безпеки, гео-бази, оновлення панелі й розширення Ads Manager.

Читати гайд →
Документація

Telegram-бот

Керуйте трекером із Telegram: статистика, конверсії та сповіщення в чаті, вебхук або поллінг і алерти в канали.

Читати гайд →
Документація

MCP: ШІ-асистент у трекері

Підключіть Claude або будь-який MCP-клієнт до Orbitra й керуйте кампаніями, офферами та доменами звичайними словами.

Читати гайд →