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

Клоакинг

Схема потока 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-ASNIP2Proxy PX12 / база ASN
Чёрные списки ботовIP и сигнатуры User-Agent из Настройки → Боты—
Эвристика User-AgentКраулеры и инструменты (facebookexternalhit, meta-externalagent, curl, python, headless…), пустой User-Agent, нет Accept-Language—

Если нужной базы нет, редактор кампании показывает предупреждение прямо в карточке клоаки.

Чувствительность

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

УровеньБелая страница при
Низкаятолько жёстком сигнале
Средняя (по умолчанию)жёстком сигнале или двух мягких
Высокаялюбом одном сигнале

Фильтры таргетинга

Применяются после пассивных слоёв, несовпадение — белая страница (TARGETING_SAFE):

Проверка 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) считает их по кампании, потоку, дню и вердикту — «ноль кликов» не спрячет реальный трафик.

Глобальные настройки: Настройки → Боты

Диагностика

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

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

КодЗначение
geo_country / geo_unknownстрана не в списке / страну не удалось определить
device_typeтип устройства не разрешён
bot_isp, isp_blocklistISP в списке ботов и дата-центров
datacenter_asn, asn_datacenterASN дата-центра или хостинга
vpn_proxy_asnASN VPN- или прокси-провайдера
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% трафика на белой страницеУстановлена ли гео-база (⚙ → Гео базы); причины geo_unknown в логе кликов
Живые мобильные пользователи на белойПричина ip2proxy_vpn_proxy — снимите слой VPN/прокси (это жёсткий сигнал, низкая чувствительность его не отменит)
Проверяющие Meta или Telegram доходят до оффераИх сети не помечены как дата-центры по ASN; одно попадание в диапазон на средней чувствительности — только мягкий сигнал. Поднимите чувствительность или добавьте фильтр «Бот» на перехватывающий поток
← Назад
Кампании и потоки
Вперёд →
Проверка браузера
Исходник на GitHub: github.com/fenjo26/Orbitra.link/wiki
Все гайды
Документация

Быстрый старт: первая кампания

Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.

Читать гайд →
Документация

Установка и обновление

Установите 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 и управляйте кампаниями обычными словами.

Читать гайд →