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

Клоакинг

Схема потоку Cloaking ділить трафік на дві гілки: підозрілі відвідувачі (боти, модератори, дата-центри, VPN) бачать safe page (безпечну сторінку), реальні люди — money page (грошову). Один модуль (core/CloakDetector.php) ухвалює рішення для всіх точок входу: URL кампанії (index.php), click.php і Click API v3.

Детальний технічний розбір англійською: How the Orbitra Cloaker Works.

Налаштування потоку

Safe page

Вбудований HTML, зовнішній URL, локальний лендинг або локальний оффер. Лендинги та оффери в списку згруповані за групами, з пошуком.

Money page

Працює як схема «Landing + Offer», включно з вибором оффера «before the click / after the click».

Чисті відвідувачі в наступний потік

Чекбокс «Send clean visitors to the next stream» перетворює клоакинг на вхідний фільтр. Підозрілі відвідувачі отримують safe page, а чисті продовжують вниз по списку потоків — гео, пристрої та мови розподіляються regular-потоками. Money page цього потоку в цьому режимі не використовується. Поставте такий потік першим або зробіть його intercepting, щоб кожен відвідувач проходив перевірку.

Шари детекції

ШарДжерелоНе працює без
Data centers / hostingБлоклист ASN (core/data/asn_blocklist.json), опубліковані хмарні та краулерні діапазони, ключові слова хостингів у назві ISPБаза ASN (GeoLite2-ASN)
VPN / proxyIP2Proxy PX12 (VPN, TOR, residential, threat, fraud score ≥ 80), список VPN-ASNIP2Proxy PX12 / база ASN
Bot blacklistsIP і сигнатури User-Agent зі Settings → Bots—
User-Agent heuristicsКраулери та інструменти (facebookexternalhit, meta-externalagent, curl, python, headless…), порожній User-Agent, відсутній Accept-Language—

Якщо потрібної бази немає, редактор кампанії показує попередження прямо в картці клоакинга.

Чутливість

Сигнали бувають жорсткі (явне спрацювання в блоклисті або базі репутації) та м'які (поодинокі шумні евристики).

РівеньSafe page, коли
Lowлише жорсткий сигнал
Medium (за замовчуванням)жорсткий сигнал або два м'які
Highбудь-який один сигнал

Таргетинг-фільтри

Застосовуються після пасивних шарів; неспівпадіння означає safe page (TARGETING_SAFE):

Перевірка JavaScript

Вимкнена за замовчуванням. Відвідувач спершу отримує safe page і переходить на money page через одноразове підписане посилання (TTL 5 хвилин) лише після виконання JS. navigator.webdriver = true залишається на safe page. Так само і все, що не виконує JS. Ціна — один зайвий перехід для кожного живого відвідувача.

З увімкненою перевіркою браузера (Settings → Bots) той самий крок також збирає сигнали браузера: у режимі Soft або Strict віртуальна машина, емулятор або підмінений телефон отримує тут safe page з причиною bc_. Поле Browser check* потоку може вимкнути це лише для цього потоку.

Preloader. Поки виконується JS-крок (частка секунди), відвідувач бачить сторінку завантаження, налаштовувану по кожному потоку у JS Challenge Preloader: вбудована сторінка або ваш власний HTML з живим прев'ю. Історично цей крок перевикористовував HTML safe page — та розмітка досі показується, коли preloader не налаштовано, тож наявні кампанії зберігають вигляд; оберіть Custom HTML, щоб перекрити її. Перевірочний probe інжектиться у ваш HTML автоматично — не додавайте власних redirect-скриптів, вони змагатимуться з підписаним посиланням.

Запис і звіти

НалаштуванняЗа замовчуваннямЩо робить
Record Safe Page clicksувімкненоХіти safe page пишуться з is_safe_page = 1. Вимкніть — і вони не дійдуть до бази
Exclude Safe Page clicks from reportsувімкненоХіти лишаються в журналі кліків, але випадають з кожної метрики звітів — кліки, візити, уніки, боти, порожні referer, витрати, CPV. Хіт safe page все одно є візитом на посилання кампанії, тож із вимкненою галкою він рахується і в «Clicks» (з 1.8.5 кліки рахують кожен візит)

Навіть коли хіти не пишуться, лічильник придушених хітів (cloak_suppressed_stats) рахує їх по кампанії, потоку, дню і вердикту — «нуль кліків» не сховає реальний трафік.

Глобальні налаштування: Settings → Bots

Діагностика

Вердикти та причини

Вердикти: money, passive_safe, targeting_safe, js_safe. Причини пишуться у clicks.cloak_reasons; основні:

КодЗначення
geo_country / geo_unknownкраїни немає у списку / країну не вдалося визначити
device_typeтип пристрою не дозволений
bot_isp, isp_blocklistISP у списку ботів і дата-центрів
datacenter_asn, asn_datacenterдата-центровий або хостинговий ASN
vpn_proxy_asnASN VPN- або proxy-провайдера
iprange_datacenterIP в опублікованому хмарному або краулерному діапазоні
hosting_ispключове слово хостингу в назві ISP
ip2proxy_*сигнал IP2Proxy: vpn_proxy, datacenter, residential, tor, bot, threat, high_fraud
bot_blocklistIP у бот-лісті
crawler_or_tool_ua, suspicious_ua, no_user_agent, missing_accept_languageевристики User-Agent і заголовків
webdriver, js_missing, js_fingerprintперевірка JavaScript

Типові проблеми

СимптомЩо перевірити
Кабінет реклами показує кліки, трекер — нульЧи не вимкнено запис кліків Safe Page; лічильник придушених хітів
100% трафіку на safe pageЧи встановлена гео-база (⚙ → Geo databases); причини geo_unknown у журналі кліків
Живі мобільні користувачі на safe pageПричина ip2proxy_vpn_proxy — приберіть шар VPN/proxy (це жорсткий сигнал; низька чутливість його не скасує)
Рев'юери Meta або Telegram доходять до оффераЇхні мережі не позначені як дата-центри по ASN; одне спрацювання діапазону на середній чутливості — лише м'який сигнал. Підніміть чутливість або додайте фільтр «Bot» на intercepting-потік
← Попередній
Кампанії та потоки
Наступний →
Перевірка браузера
Переглянути джерело на 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 й керуйте кампаніями, офферами та доменами звичайними словами.

Читати гайд →