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

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

Усе, що відкривається з меню ⚙ у верхньому правому куті панелі.

Користувачі та доступ

⚙ → Users. Дві вкладки: Users (таблиця акаунтів, видима адміністраторам) і Profile (ваш власний акаунт — для кожного користувача).

Ролі

Є дві ролі: admin (повний доступ) і user (права по ресурсах). Акаунт, створений при встановленні, не можна видалити, як і останнього адміністратора, що залишився. У користувачів є шаблони прав: медіабаєр, відеомонтажер / дизайнер, розробник або власні права.

Права видаються по ресурсах: кампанії, оффери, лендинги, джерела, партнерські мережі, домени, логи, галерея, push. Рівні: full, read-only, no access. Для кампаній є ще own + assigned і assigned only — тоді користувач бачить і редагує лише ці кампанії всюди: у списках, звітах, логах, конверсіях, на дашборді. Фінансові дані можна сховати окремо: витрати, дохід, виплати.

Права перевіряються на сервері. Дії, не приписані жодному ресурсу, — лише для адміністратора (повний список у REST API). Глобально небезпечні операції (очищення статистики, імпорт із Keitaro, імпорт конверсій, ретро-перепризначення) недоступні користувачам із доступом «own + assigned».

Profile

Логін, email, мова інтерфейсу, часовий пояс (близько 250 зон із поточним зсувом UTC), перший день тижня, зміна пароля (потрібен поточний пароль; мінімум 8 символів).

Двофакторна автентифікація — TOTP через застосунок-автентифікатор. Коди одноразові.

API-ключі

Створюються адміністратором для користувача: read — лише читання, write — ще й керування. Ключ передається в заголовку Authorization: Bearer <key> або X-Api-Key. Використовується в MCP, REST API, при отриманні витрат від Dolphin / Fbtool та в розширенні Ads Manager.

Вхід

Ліміти невдалих спроб: 5 за 5 хвилин з одного IP і 20 за 15 хвилин на акаунт (скидаються після успішного входу). Час життя сесії — session_lifetime (доба за замовчуванням, від 5 хвилин до 30 днів; змінна оточення ORBITRA_SESSION_LIFETIME має пріоритет над налаштуванням).

Settings

⚙ → Settings, вкладки:

ВкладкаЩо там
GeneralКлюч постбеків, валюта за замовчуванням, ручний IP сервера, дозвіл на PHP-лендинги (вимкнено за замовчуванням) і їхній таймаут 1–9 с
BotsРежим Browser check (Off / Observe only / Soft / Strict), IP та сигнатури ботів, глобальний список Bot ISP, діапазони датацентрів, VPN ASN як сигнал бота — дивіться Клоакинг
Conversion typesВласні статуси та що вони означають, незіставлені статуси — дивіться Постбеки
Custom metricsВласні формули для звітів
AutomationCrons: черга постбеків, backorder
SystemЗбір статистики ввімк/вимк, ігнорувати prefetch, перевірка нових версій, терміни зберігання логів та архіву, доступ до панелі за IP/підмережами, шлях адмін-панелі
PrivacyЗахист від сканування: що відповідати, коли робоче посилання відкривають напряму без параметрів кампанії — 302 на ваш URL, 404 або порожня сторінка

Шлях панелі

/admin.php — перше, що перевіряє будь-який сканер. У System → Admin panel path можна замінити його на власний (/my-panel), після чого /admin.php починає відповідати 404. Це ховає форму входу, але не замінює пароль. Якщо шлях забувся:

php /var/www/orbitra/cli/admin_path.php          # print the current path
php /var/www/orbitra/cli/admin_path.php reset    # вернуть /admin.php

Доступ до панелі за IP

Список IP і підмереж (IPv4 та IPv6, по одному в рядку). Порожній — панель доступна звідусіль. Заповнений — вхід у панель і авторизовані виклики api.php працюють лише з цих адрес. Заголовки X-Forwarded-For трекер довіряє лише від Cloudflare і приватних проксі. Обережно: можна закрити собі доступ. Щоб зняти обмеження з сервера:

sudo -u www-data php -r '$db = new PDO("sqlite:/var/www/orbitra/orbitra_db.sqlite"); $db->exec("UPDATE settings SET value = \x27\x27 WHERE key = \x27admin_ip_access\x27");'

Терміни зберігання

Поля «Log retention period» і «Archive resource retention period» працюють, лише коли запущений cleanup-cron. Інсталятор його не ставить — додайте вручну:

0 3 * * * php /var/www/orbitra/cli/cleanup_cron.php >> /var/www/orbitra/var/logs/cleanup.log 2>&1

Видалення йде пакетами, щоб база даних не блокувалася.

Personalization

⚙ → Personalization — логотип, назва, світла чи темна тема та палітри: Cobalt, Canary, Parchment, Indigo (у світлому й темному варіантах), Terminal, Aurora. Тема застосовується до першого малювання, тож темна тема темна з самого першого кадру.

Мова інтерфейсу — у профілі: English, Русский, Українська, Español, Deutsch, Français, 中文.

Гео-бази даних

⚙ → Geo Databases. Без гео-бази не працюють фільтри за країною та клоакинг за країною (усі відвідувачі — Unknown); без ASN-бази — шари датацентрів і списків ISP.

БазаКлючДає
Sypex Geo Cityне потрібенКраїна, регіон, місто. Встановлюється інсталятором
MaxMind GeoLite2 City / ASNЛіцензійний ключ MaxMindМісто, ASN і провайдер
IP2Location DB11Токен IP2LocationГео, часовий пояс
IP2Proxy PX12Токен IP2LocationVPN, проксі, TOR, residential, fraud score

Бази оновлюються щомісяця cron-ом cli/geo_update.php (мітка # orbitra-geo; MaxMind та IP2 — лише якщо ключі збережені). Оновлення панелі саме встановлює Sypex, коли баз немає взагалі. Банер на всіх вкладках попереджає, коли баз немає або є лише Sypex.

⚙ → Geo profiles — готові набори країн для фільтрів (EU, CIS тощо) та власні.

Оновлення

⚙ → Update — перевіряє нову версію на GitHub і оновлює кнопкою (git pull від імені web-користувача). Перевірка кешується на годину, при помилці — на 10 хвилин; вимикається в System → Notify about new versions.

Після оновлення панель сама:

Зміни, що потребують root (правила sudo, SSL-хелпери), кнопкою зробити не можна — панель показує банер із командою cli/server_setup.sh (Встановлення та оновлення).

Якщо на хостингу вимкнено exec, сторінка показує команди для ручного оновлення через Git.

Різне

Пункт менюЩо робить
ArchiveВидалені кампанії, оффери, лендинги, джерела, партнерські мережі: відновити або стерти назавжди
Clear statisticsВидалити кліки та конверсії за період або всі
MigrationsВерсія схеми бази даних, імпорт із Keitaro (Міграція з Keitaro)
StatusДиск, CPU, RAM, розмір бази даних
LogsТрафік, постбеки, S2S, system, audit (Звіти та логи)
GalleryМедіатека для PWA, лендингів та офферів (Галерея контенту)
AI / MCPПідключення ШІ-асистента (MCP)
Support and feedbackКонтакти та блок партнерів

Розширення Ads Manager

Розширення для Chrome та Chromium-подібних антидетект-браузерів показує метрики Orbitra поруч із рядками кампаній, груп оголошень та оголошень у Facebook Ads Manager (оновлення кожні 30 секунд), а по кліку — розбивку за три дні: історія по днях, лендинги та оффери, точність доставки Pixel / CAPI.

  1. ⚙ → Integrations → Chrome & Antidetect Extension — завантажте архів і розпакуйте його.
  2. Завантажте папку як unpacked extension (або ZIP, де це підтримується).
  3. У попапі розширення вставте URL трекера і виділений ключ читання, який показує Orbitra.

Розширенню потрібен лише ключ читання. Хіти безпечних сторінок виключаються так само, як у звітах.

← Попередній
Cloudflare
Наступний →
Telegram-бот
Переглянути джерело на 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 й керуйте кампаніями, офферами та доменами звичайними словами.

Читати гайд →