Кампанії та потоки
Кампанія — це посилання, на яке приходить трафік, плюс набір потоків, які вирішують, куди піде кожен відвідувач. Розділ Campaigns — у верхньому меню.
Редактор кампанії
Редактор відкривається на весь екран. На широкому екрані (від 1280px) він поділений на дві панелі: налаштування кампанії зліва, потоки справа; на вужчому екрані він стає однією колонкою.
Вкладки налаштувань
| Вкладка | Що там |
|---|---|
| General | Назва, аліас (6 символів, генерується автоматично), посилання кампанії, домен, група, джерело трафіку, стан, тестове посилання; нижче на вкладці — картка прев'ю посилання в соцмережах і правило Zone Killer |
| Finance | Модель витрат, унікальність, тип ротації потоків |
| Parameters | Які параметри посилання трекер зберігає в клік (keyword, cost, external_id, creative_id, ad_campaign_id, source, sub_id_1 … sub_id_30) і з яких параметрів джерела їх брати |
| Integrations | Пікселі (Facebook / TikTok тощо, див. Facebook / Meta) і підключення синхронізації витрат (Витрати) |
| Tracking | Генератор інтеграційного коду: трекінг-скрипт, kclient.js, kclient.php, піксель, банери (script / iframe), плагін WordPress, віджети (таймер зворотного відліку, «кнопка назад», exit-intent). Доступно після першого збереження — код містить токен кампанії |
| Popup | Власний конверсійний попап кампанії: увімк/вимк (крапка на вкладці, поки увімкнено), живий прев'ю, чотири кроки і секція Advanced |
| S2S Postbacks | Вихідні постбеки до джерела трафіку, тестер постбеків, повторне надсилання пропущених конверсій — див. Постбеки та конверсії |
| Notes | Вільний текст |
Моделі витрат
CPC, CPV, CPuC (за унікальний клік), CPM, CPA, CPS, RevShare. Ручна вартість перезаписується імпортом витрат, якщо він підключений (Витрати).
Унікальність
- Метод: IP, IP + User-Agent або Cookies.
- Період: у годинах.
- Унікальність рахується в трьох розрізах — по кампанії, по потоку і глобально; усі три видимі у звітах.
Стан кампанії
Зупинена кампанія (paused / disabled) відповідає 503, заархівована — 404. Це стосується URL аліаса, click.php і Click API.
Прев'ю посилання в соцмережах
Картка на вкладці General редактора. Коли увімкнено, соціальний або месенджер-бот прев'ю, що відкриває посилання кампанії — facebookexternalhit, telegrambot, whatsapp, twitterbot та інші link-preview фетчери — отримує мінімальну картку og:* з вашою назвою, описом і зображенням замість клікового потоку. Кожна людина роутиться точно як завжди: без затримки, без іншої сторінки.
Пошукові краулери (googlebot & co) навмисно продовжують бачити справжню відповідь кампанії — це лише фетчери прев'ю месенджерів; повна робота з ботами — це завдання клоакингу. Одноразовий дисклеймер фіксує, що правила платформ щодо власних прев'ю — відповідальність оператора.
Потоки
Потік — це правило роутингу: фільтри (кого він забирає) + схема (що показувати).
Типи та порядок
- Intercepting — перевіряється першим. Підходить для ботів, білих сторінок, винятків.
- Regular — основний трафік. Обирається за позицією або за вагою (тип ротації на вкладці «Finance»).
- Default — коли нічого з вищого не підійшло.
Збереження кампанії не перестворює її потоки: кожен потік тримає стабільний ID, тож історія кліків не розбрізається по старих номерах. Нові потоки називаються «Stream 1», «Stream 2»… Шеврон на картці згортає потік; стан запам'ятовується по кожній кампанії.
Кожна картка потоку показує візити, уніки, ботів і частку трафіку кампанії за сьогодні / учора / 7 / 30 днів. Це дозволяє легко бачити, скільки трафіку пішло на білий потік, а скільки — на грошовий.
Фільтри
| Фільтр | Як працює |
|---|---|
| Country | Список країн або гео-профіль (EU, CIS…). Якщо країну визначити не вдалося і увімкнено режим «include», фільтр не пропускає відвідувача — але лише коли встановлена гео-база; без неї фільтр утримується |
| Device | Desktop / mobile / tablets |
| Operating system, Browser | Значення обираються зі списку, який трекер реально розпізнає, включно з in-app браузерами (TikTok, Facebook, Instagram, Telegram, WebView). Можна ввести власне значення і натиснути Enter |
| Browser language | en — будь-яка англійська, en-IN — англійська (Індія). Враховується весь Accept-Language, а не лише перша мова |
| Bot | Детектор ботів на максимальній чутливості (той самий, що використовується в клоакингу) |
| IP address | Адреси та CIDR, IPv4 і IPv6 |
| Provider (ISP) | Звіряється з ISP і ASN відвідувача (потрібна база ASN) |
| Connection type | З даних гео-бази |
| Referer, Keyword | Звіряється зі значенням кліка |
| URL parameter | Будь-який параметр посилання за ім'ям. Точний збіг без урахування регістру, * — будь-які символи, «Empty» — параметр відсутній або порожній |
| Day of week, Time | За локальним часом відвідувача (часовий пояс із гео-бази; без неї — серверний час) |
Фільтри потоку поєднуються через AND (мають зійтися всі) або OR (достатньо одного). Фільтр, який не може дійти рішення (немає гео-бази, немає даних ISP), не голосує: за «AND» він не блокує потік, за «OR» — не відкриває його.
Трюк проти модерації TikTok через «URL parameter»: додайте xxx=__PLACEMENT__ до посилання кампанії; на intercepting-потоці з білою сторінкою задайте фільтр «URL parameter» на xxx зі значеннями __PLACEMENT__ і «Empty». У реальному кліку мережа підставляє значення макроса, а модератор, що відкрив голе посилання, приходить з __PLACEMENT__ або без параметра.
Схеми
| Схема | Що відбувається |
|---|---|
| Direct redirect to offer | Редирект на оффер з каталогу (кілька офферів ротуються за вагами) або на пряме посилання. Кожен такий перехід — це клік |
| Landing + Offer | Показує лендинг, з якого відвідувач іде далі на оффер. Оффер необов'язковий |
| Action | Нічого не робити, 404, показати текст, показати HTML, відправити в іншу кампанію (клік пишеться в обидві) |
| Cloaking | Ділить трафік між безпечною сторінкою і грошовою — див. Клоакинг |
Offer selection у схемі «Landing + Offer»:
- After the click (за замовчуванням для нових потоків) — оффер обирається, коли відвідувач реально йде з лендинга. LP clicks, LP CTR і час до оффера чесні.
- Before the click — кожен перегляд лендинга рахується як клік на оффер (легаси-поведінка, LP CTR близько 100%).
Як збудувати посилання на оффер на самому лендингу ({offer}, /?_lp=1, передача sub_id_N на оффер) — описано в Лендинги.
Типи редиректу на оффер
Задається на оффері. Макроси і SSRF-перевірка однакові для всіх типів.
| Тип | Поведінка |
|---|---|
| HTTP redirect | 302, за замовчуванням |
| JS redirect | HTML-сторінка, яка переходить через JavaScript |
| Meta Refresh | Тег <meta http-equiv="refresh"> |
| Iframe | Оффер у повноекранному iframe на вашому домені |
| Form Submit | Автовідправлювана POST-форма: трекінг-дані в тілі запиту |
| curl proxy | Сторінка оффера, яку віддає ваш сервер, з тегом <base> |
Ротація з автооптимізацією
Перемикач Auto біля списку офферів або лендингів потоку вмикає автоматичний перерахунок ваг за метрикою: підтверджені продажі, CR, EPV, EPC або ROI (для ROI потрібні витрати). Налаштовується: вікно в днях, мінімальна кількість продажів, перш ніж елемент бере участь у спліті, нижня і верхня межі частки та інтервал перерахунку. Перерахунок виконує cron rotation_optimiser_cron.php; журнал рішень видно на картці потоку. Поки «Auto» увімкнено, ручне введення ваг заблоковане.
Інші налаштування потоку
- Collect clicks — коли вимкнено, відвідувач усе одно отримує напрямок, але клік не записується (немає чого прикріпити конверсію до).
Bot Challenge — налаштування кампанії, а не потоку: перевірка «людяності» (reCAPTCHA v2/v3 або ваш власний код) до вибору потоку.
Тестове посилання
Рядок Test link на вкладці «General» дає посилання кампанії, підписане ?_t=<id>:<hmac>. По ньому працює справжній роутинг — потоки, фільтри, ротація, лендинги, оффери — але клік не записується, тож статистика лишається чистою.
&_geo=DE— підмінити країну відвідувача: тестуйте гео-потоки без VPN.&_dbg=1— замість редиректу сторінка трасування: кожен потік з його типом, схемою і голосом кожного фільтра (matched / не зійшовся / утримався і чому), обраний потік і фінальний URL з підставленими макросами.
Підпис виводиться з ключа постбека установки, тож переживає зміну токена кампанії; зміна ключа постбека відкликає всі тестові посилання. Невірний або чужий підпис перетворює запит на звичайний клік.
Симуляція трафіку
⚙ → Traffic simulation: задайте IP, User-Agent, країну, пристрій, мову і параметри URL — панель покаже, який потік спрацював і чому, нічого не записуючи.
Click API і токени кампаній
У кожної кампанії є токен (32 hex-символи). Інтеграційні скрипти (click.php, kclient.php, tracking.js, Click API v3 /click_api/v3) звертаються до кампанії за токеном, а не за ID. Токени переносяться при імпорті з Keitaro, тож уже встановлені скрипти продовжують працювати. Токен можна перевипустити в редакторі. Деталі про PHP-клієнт — у Tracking Client (PHP).
Захист від дублів
- Повторний клік від того самого відвідувача (кампанія + IP + User-Agent) протягом 2 секунд не пишеться другим рядком; редирект отримує ID уже записаного кліка.
- Запити prefetch/prerender браузера обслуговуються, але не записуються.
- Якщо база зайнята (
database is locked), клік іде уvar/spool/clicks.log, і croncli/click_spool_cron.phpзаписує його протягом хвилини.
Масові операції
Копіювання кампаній, масове видалення, імпорт, перенесення групи кампаній на інший домен (bulk_set_campaign_domain, також у MCP), перейменування груп прямо у списку.
Швидкий старт: ваша перша кампанія
Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.
Читати гайд →ДокументаціяВстановлення та оновлення
Встановіть 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 й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →