Клоакинг
Схема потока Cloaking делит трафик на две ветки: подозрительные посетители (боты, модераторы, дата-центры, VPN) видят белую страницу, реальные люди — денежную. Решение принимает один модуль (core/CloakDetector.php) для всех точек входа: ссылка кампании (index.php), click.php и Click API v3.
Подробный технический разбор на английском — How the Orbitra Cloaker Works.
Настройка потока
Белая страница
Встроенный HTML, внешний URL, локальный лендинг или локальный оффер. Лендинги и офферы в списке сгруппированы по группам, есть поиск.
Денежная страница
Работает как схема «Лендинг + Оффер», включая выбор оффера «перед кликом / после клика».
Чистых — в следующий поток
Галочка «Направлять чистых посетителей в следующий поток» превращает клоаку в фильтр на входе. Подозрительные получают белую страницу, а чистые идут дальше по списку потоков — гео, устройства и языки разводятся обычными потоками. Денежная страница этого потока при этом не используется. Поставьте такой поток первым или сделайте перехватывающим, чтобы проверку проходил каждый посетитель.
Слои определения
| Слой | Источник | Без чего не работает |
|---|---|---|
| Дата-центры / хостинги | Блок-лист ASN (core/data/asn_blocklist.json), опубликованные диапазоны облаков и краулеров, ключевые слова хостинга в названии ISP | База ASN (GeoLite2-ASN) |
| VPN / прокси | IP2Proxy PX12 (VPN, TOR, residential, threat, fraud-скор ≥ 80), список VPN-ASN | IP2Proxy PX12 / база ASN |
| Чёрные списки ботов | IP и сигнатуры User-Agent из Настройки → Боты | — |
| Эвристика User-Agent | Краулеры и инструменты (facebookexternalhit, meta-externalagent, curl, python, headless…), пустой User-Agent, нет Accept-Language | — |
Если нужной базы нет, редактор кампании показывает предупреждение прямо в карточке клоаки.
Чувствительность
Сигналы бывают жёсткие (явное попадание в блок-лист или репутационную базу) и мягкие (отдельно шумные эвристики).
| Уровень | Белая страница при |
|---|---|
| Низкая | только жёстком сигнале |
| Средняя (по умолчанию) | жёстком сигнале или двух мягких |
| Высокая | любом одном сигнале |
Фильтры таргетинга
Применяются после пассивных слоёв, несовпадение — белая страница (TARGETING_SAFE):
- Страны — разрешить или заблокировать список. Если страну определить нельзя, причина пишется как
geo_unknown, а неgeo_country. Без гео-базы каждый посетитель —Unknown, и фильтр стран отправит на белую 100% трафика; редактор об этом предупреждает. - Типы устройств — только выбранные или все, кроме выбранных.
- Блокировать ботов и провайдеров дата-центров — сравнение ISP и ASN посетителя со списком. Локальный список потока или, если он пуст, глобальный из Настройки → Боты.
Проверка JavaScript
Выключена по умолчанию. Посетитель сначала получает белую страницу, а на денежную переходит по одноразовой подписанной ссылке (TTL 5 минут) только после выполнения JS. navigator.webdriver = true остаётся на белой. Всё, что не исполняет JS, — тоже. Цена — лишний переход для каждого живого посетителя.
Если включена проверка браузера (Настройки → Боты), тот же шаг собирает и сигналы браузера: в мягком или строгом режиме виртуалка, эмулятор или подделанный телефон получают здесь safe-страницу с причиной bc_*. Поле потока «Проверка браузера» может выключить её только для этого потока.
Прелоадер. Пока идёт JS-шаг (долю секунды), посетитель видит страницу загрузки — у неё своя настройка потока «Прелоадер JS-проверки»: встроенная страница или свой HTML с живым превью. Исторически этот шаг показывал HTML белой страницы — он по-прежнему показывается, если прелоадер не настроен, поэтому старые кампании не меняют вид; выберите «Свой HTML», чтобы заменить. Пробник проверки вставляется в ваш HTML автоматически — не добавляйте собственных скриптов с редиректом: они соревнуются с подписанной ссылкой.
Запись и отчёты
| Настройка | По умолчанию | Что делает |
|---|---|---|
| Записывать клики на Safe Page | вкл. | Хиты белой страницы пишутся с is_safe_page = 1. Выключите — они не попадут в базу |
| Исключить клики Safe Page из отчётов | вкл. | Хиты остаются в логе кликов, но уходят из всех метрик отчёта — кликов, визитов, уникальных, ботов, пустых рефереров, расхода, CPV. Safe-хит — это всё равно визит по ссылке кампании, поэтому без галочки он попадает и в «Клики» (с 1.8.5 клики считают каждый визит) |
Даже если хиты не пишутся, счётчик подавленных хитов (cloak_suppressed_stats) считает их по кампании, потоку, дню и вердикту — «ноль кликов» не спрячет реальный трафик.
Глобальные настройки: Настройки → Боты
- Проверка браузера — Выключена / Только отмечать / Мягкий / Строгий: боты, виртуалки и эмуляторы по противоречиям в браузере. → Проверка браузера
- IP-адреса ботов — IP и CIDR, IPv4 и IPv6. У каждой записи есть источник (вручную или из фида), очистка может удалить только записи одного источника.
- Сигнатуры (User-Agent) — подстроки.
- Глобальный чёрный список Bot ISP — один провайдер на строку. Слишком короткие и общие строки (
Inc,LLC) игнорируются: они совпали бы почти с каждым ISP. - Диапазоны IP дата-центров и краулеров — опубликованные диапазоны AWS, Google Cloud и Googlebot, Bing, Azure, Oracle, DigitalOcean, Facebook, Telegram, OpenAI, Cloudflare, Apple Private Relay и других из lord-alfred/ipranges. Обновляются ежедневно кроном
ipranges_cron.php(вручную — кнопка «Обновить сейчас» илиphp ipranges_cron.php --force), хранятся вvar/ipranges/. Пока списки не скачаны, слой неактивен. - Считать VPN-ASN сигналом бота — по умолчанию включено. Выключите, если ваша аудитория массово сидит за коммерческим VPN.
Диагностика
- Карточка клоаки в редакторе — сколько хитов ушло на деньги и на белую за выбранный период, топ причин и ссылка в лог кликов с тем же окном. Если почти весь трафик уходит на белую, карточка предупреждает.
- Лог кликов — колонки «Маршрут» и «Причина» появляются автоматически, когда на странице есть клики клоаки; фильтр по маршруту и причине. В карточке клика — вердикт и причины, но только для кликов, которые клоака действительно судила.
- Тестовая ссылка с
_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- или прокси-провайдера |
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% трафика на белой странице | Установлена ли гео-база (⚙ → Гео базы); причины geo_unknown в логе кликов |
| Живые мобильные пользователи на белой | Причина ip2proxy_vpn_proxy — снимите слой VPN/прокси (это жёсткий сигнал, низкая чувствительность его не отменит) |
| Проверяющие Meta или Telegram доходят до оффера | Их сети не помечены как дата-центры по ASN; одно попадание в диапазон на средней чувствительности — только мягкий сигнал. Поднимите чувствительность или добавьте фильтр «Бот» на перехватывающий поток |
Быстрый старт: первая кампания
Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.
Читать гайд →ДокументацияУстановка и обновление
Установите Orbitra на чистый сервер Ubuntu или Debian одной командой и безопасно обновляйтесь до новых версий.
Читать гайд →ДокументацияМиграция из Keitaro
Перенесите кампании, офферы, источники и домены из Keitaro в Orbitra в один клик — что переносится и что проверить.
Читать гайд →ДокументацияМиграция из Binom
Перенесите кампании и потоки из Binom в Orbitra: что переносится автоматически, а что настроить вручную.
Читать гайд →ДокументацияВозможности Orbitra
Всё, что умеет Orbitra: кампании и потоки, клоакинг, лендинги, PWA, постбеки, расходы, отчёты и интеграции.
Читать гайд →ДокументацияКампании и потоки
Полный справочник: настройки кампаний, типы потоков, схемы, ротация, фильтры, тестовые ссылки и каждый параметр.
Читать гайд →ДокументацияКлоакинг
Полный справочник по клоакингу: уровни детекции, глобальные настройки, фильтры потоков, вердикты и отчёты.
Читать гайд →ДокументацияПроверка браузера
Как JS-проверка ловит ботов, виртуальные машины и эмуляторы через противоречия в окружении браузера.
Читать гайд →ДокументацияЛендинги
Типы лендингов, макрос {offer}, JS-адаптер, LeadForge и мульти-оффер лендинги — полный справочник.
Читать гайд →ДокументацияPWA-лендинги и Web Push
Собирайте устанавливаемые PWA-приложения и собирайте push-подписчиков: настройки, иконки, события и уведомления.
Читать гайд →ДокументацияPWA-воронка
Многошаговая PWA-воронка: приглашения к установке, отслеживание событий и возвратные уведомления.
Читать гайд →ДокументацияКонверсионные попапы
Показывайте реальные конверсии как попапы на странице: настройка, триггеры и размещение.
Читать гайд →ДокументацияЗаписи сессий и карта кликов
Воспроизводите реальные визиты, смотрите карты кликов и скроллов. Лимиты хранения и приватность.
Читать гайд →ДокументацияГалерея контента
Центральное хранилище иконок, скриншотов и креативов для PWA и лендингов.
Читать гайд →ДокументацияБиблиотека креативов
Храните креативы с отслеживанием по subid и тестируйте их в разных кампаниях.
Читать гайд →ДокументацияВнешние PWA и Telegram-каналы
Публикуйте PWA на внешних доменах и используйте Telegram-каналы как источник трафика.
Читать гайд →ДокументацияПостбеки и конверсии
Входящие постбеки, статусы и типы конверсий, исходящие S2S-постбеки в источник трафика.
Читать гайд →ДокументацияРасходы: импорт из рекламных кабинетов
Импорт расходов из Facebook, TikTok и Google Ads, обновление через API и крон — и как работает агрегатор доходов.
Читать гайд →ДокументацияPush и pop сети
Работа с пуш и поп источниками трафика: фиды, оптимизация зон и zone killer.
Читать гайд →ДокументацияFacebook / Meta integration
Импорт расходов из Meta Ads и Conversions API: серверные события с дедупликацией.
Читать гайд →ДокументацияDolphin / Fbtool — приём расходов (Keitaro Admin API)
Получайте расходы Facebook через API Dolphin (Fbtool) в реальном времени.
Читать гайд →ДокументацияЧистилка комментариев FB
Массовая модерация комментариев под рекламой Meta: скрывать, удалять и фильтровать по ключевым словам.
Читать гайд →ДокументацияИсточники трафика и партнёрские сети
Каталог 50+ источников трафика и 440+ сетей: шаблоны, параметры и адреса постбеков.
Читать гайд →ДокументацияОтчёты, логи и метрики
Конструктор отчётов, сохранённые отчёты, логи кликов и каждая метрика с пояснением.
Читать гайд →ДокументацияДомены и SSL
Добавление доменов, DNS, бесплатные сертификаты Let's Encrypt, редиректы, парковка и каждый переключатель на странице.
Читать гайд →ДокументацияCloudflare — DNS и SSL доменов
Как запускать домены кампаний через Cloudflare: DNS, режимы SSL и что отключить.
Читать гайд →ДокументацияАдминистрирование
Пользователи, роли и права, настройки безопасности, гео-базы, обновления и состояние системы.
Читать гайд →ДокументацияTelegram-бот
Управляйте трекером из Telegram: статистика, конверсии и алерты в чате.
Читать гайд →ДокументацияMCP-сервер: работа с трекером через нейросеть
Подключите Claude или любой MCP-клиент к Orbitra и управляйте кампаниями обычными словами.
Читать гайд →