Клоакинг
Схема потоку 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 / proxy | IP2Proxy PX12 (VPN, TOR, residential, threat, fraud score ≥ 80), список VPN-ASN | IP2Proxy PX12 / база ASN |
| Bot blacklists | IP і сигнатури 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):
- Countries — allow або block списку. Якщо країну визначити не вдалося, причина записується як
geo_unknown, а неgeo_country. Без гео-бази кожен відвідувач —Unknown, і фільтр країни відправить 100% трафіку на safe page; редактор попереджає про це. - Device types — лише обрані, або всі, крім обраних.
- Block bots and data-center providers — ISP і ASN відвідувача звіряються зі списком: локальним списком потоку або, якщо він порожній, глобальним зі Settings → Bots.
Перевірка 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
- Bot IP addresses — IP і CIDR, IPv4 та IPv6. Кожен запис має джерело (вручну або з фіда); чистка може видаляти записи лише одного джерела.
- Signatures (User-Agent) — підрядки.
- Global Bot ISP blacklist — один провайдер на рядок. Занадто короткі і занадто загальні рядки (
Inc,LLC) ігноруються: вони збіглися б майже з кожним ISP. - Data-center and crawler IP ranges — опубліковані діапазони AWS, Google Cloud і Googlebot, Bing, Azure, Oracle, DigitalOcean, Facebook, Telegram, OpenAI, Cloudflare, Apple Private Relay та інших із lord-alfred/ipranges. Оновлюються щодня cron'ом
ipranges_cron.php(вручну кнопкою «Update now» абоphp ipranges_cron.php --force), зберігаються уvar/ipranges/. Поки списки не завантажені, шар неактивний. - Browser check — Off / Observe only / Soft / Strict: ботів, VM і емулятори ловлять за суперечностями в браузері. → Перевірка браузера
- Treat VPN ASN as a bot signal — увімкнено за замовчуванням. Вимкніть, якщо ваша аудиторія масово сидить за комерційним VPN.
Діагностика
- Картка клоакинга в редакторі — скільки хітів пішло на money і на safe за обраний період, топ-причини і посилання в журнал кліків з тим самим вікном. Якщо майже весь трафік іде на safe page, картка попереджає.
- Журнал кліків — колонки «Route» і «Reason» з'являються автоматично, коли на сторінці є кліки клоакинга, з фільтром за маршрутом і причиною. Картка кліка показує вердикт і причини, але лише для кліків, які клоакинг реально судив.
- Тестове посилання з
_dbg=1— трасування роутингу без запису кліку;_geo=XXпідмінює країну (Кампанії та потоки). - PHP-лог — рядки виду
Orbitra cloak [campaign=12 stream=34]: stage=PASSIVE_SAFE ... reasons=[crawler_or_tool_ua].
Вердикти та причини
Вердикти: money, passive_safe, targeting_safe, js_safe. Причини пишуться у clicks.cloak_reasons; основні:
| Код | Значення |
|---|---|
geo_country / geo_unknown | країни немає у списку / країну не вдалося визначити |
device_type | тип пристрою не дозволений |
bot_isp, isp_blocklist | ISP у списку ботів і дата-центрів |
datacenter_asn, asn_datacenter | дата-центровий або хостинговий ASN |
vpn_proxy_asn | ASN VPN- або proxy-провайдера |
iprange_datacenter | IP в опублікованому хмарному або краулерному діапазоні |
hosting_isp | ключове слово хостингу в назві ISP |
ip2proxy_* | сигнал IP2Proxy: vpn_proxy, datacenter, residential, tor, bot, threat, high_fraud |
bot_blocklist | IP у бот-лісті |
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-потік |
Швидкий старт: ваша перша кампанія
Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.
Читати гайд →ДокументаціяВстановлення та оновлення
Встановіть 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 й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →