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

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

Кампанія — це посилання, на яке приходить трафік, плюс набір потоків, які вирішують, куди піде кожен відвідувач. Розділ 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. Ручна вартість перезаписується імпортом витрат, якщо він підключений (Витрати).

Унікальність

Стан кампанії

Зупинена кампанія (paused / disabled) відповідає 503, заархівована — 404. Це стосується URL аліаса, click.php і Click API.

Прев'ю посилання в соцмережах

Картка на вкладці General редактора. Коли увімкнено, соціальний або месенджер-бот прев'ю, що відкриває посилання кампанії — facebookexternalhit, telegrambot, whatsapp, twitterbot та інші link-preview фетчери — отримує мінімальну картку og:* з вашою назвою, описом і зображенням замість клікового потоку. Кожна людина роутиться точно як завжди: без затримки, без іншої сторінки.

Пошукові краулери (googlebot & co) навмисно продовжують бачити справжню відповідь кампанії — це лише фетчери прев'ю месенджерів; повна робота з ботами — це завдання клоакингу. Одноразовий дисклеймер фіксує, що правила платформ щодо власних прев'ю — відповідальність оператора.

Потоки

Потік — це правило роутингу: фільтри (кого він забирає) + схема (що показувати).

Типи та порядок

  1. Intercepting — перевіряється першим. Підходить для ботів, білих сторінок, винятків.
  2. Regular — основний трафік. Обирається за позицією або за вагою (тип ротації на вкладці «Finance»).
  3. Default — коли нічого з вищого не підійшло.

Збереження кампанії не перестворює її потоки: кожен потік тримає стабільний ID, тож історія кліків не розбрізається по старих номерах. Нові потоки називаються «Stream 1», «Stream 2»… Шеврон на картці згортає потік; стан запам'ятовується по кожній кампанії.

Кожна картка потоку показує візити, уніки, ботів і частку трафіку кампанії за сьогодні / учора / 7 / 30 днів. Це дозволяє легко бачити, скільки трафіку пішло на білий потік, а скільки — на грошовий.

Фільтри

ФільтрЯк працює
CountryСписок країн або гео-профіль (EU, CIS…). Якщо країну визначити не вдалося і увімкнено режим «include», фільтр не пропускає відвідувача — але лише коли встановлена гео-база; без неї фільтр утримується
DeviceDesktop / mobile / tablets
Operating system, BrowserЗначення обираються зі списку, який трекер реально розпізнає, включно з in-app браузерами (TikTok, Facebook, Instagram, Telegram, WebView). Можна ввести власне значення і натиснути Enter
Browser languageen — будь-яка англійська, 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»:

Як збудувати посилання на оффер на самому лендингу ({offer}, /?_lp=1, передача sub_id_N на оффер) — описано в Лендинги.

Типи редиректу на оффер

Задається на оффері. Макроси і SSRF-перевірка однакові для всіх типів.

ТипПоведінка
HTTP redirect302, за замовчуванням
JS redirectHTML-сторінка, яка переходить через 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» увімкнено, ручне введення ваг заблоковане.

Інші налаштування потоку

Bot Challenge — налаштування кампанії, а не потоку: перевірка «людяності» (reCAPTCHA v2/v3 або ваш власний код) до вибору потоку.

Тестове посилання

Рядок Test link на вкладці «General» дає посилання кампанії, підписане ?_t=<id>:<hmac>. По ньому працює справжній роутинг — потоки, фільтри, ротація, лендинги, оффери — але клік не записується, тож статистика лишається чистою.

Підпис виводиться з ключа постбека установки, тож переживає зміну токена кампанії; зміна ключа постбека відкликає всі тестові посилання. Невірний або чужий підпис перетворює запит на звичайний клік.

Симуляція трафіку

⚙ → 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).

Захист від дублів

Масові операції

Копіювання кампаній, масове видалення, імпорт, перенесення групи кампаній на інший домен (bulk_set_campaign_domain, також у MCP), перейменування груп прямо у списку.

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

Читати гайд →