Лендинги
Лендинг — страница, которую посетитель видит на пути к офферу. В Orbitra их четыре типа, и различия между ними сводятся по большей части к одному вопросу: как кнопка покупки добирается до оффера.
| Тип | Где живёт | Ссылка на оффер |
|---|---|---|
| Локальный | загруженный ZIP, отдаётся трекером | {offer} или /?_lp=1 |
| Редирект | ваш хостинг, другой домен | /?_lp=1 + JS-адаптер |
| Предзагрузка | подгружается трекером, показывается под вашим доменом | {offer} |
| Действие | ничего не показывается; трекер что-то делает | — |
Локальные лендинги
Архив распаковывается в landings/<id лендинга>/. Точка входа — index.html, либо index.php, если включены PHP-лендинги.
Требования
- Входная страница должна называться
index.html(илиindex.php). - Используйте относительные пути:
img/hero.jpg, а не/img/hero.jpg. Работают оба варианта, но относительные срабатывают и при локальном открытии архива. - Никаких внутренних редиректов на
index.html— посетитель уйдёт с отслеживаемого URL.
В отличие от Keitaro, Orbitra не добавляет тег <base> и не переписывает вашу разметку. Страница отдаётся байт в байт так, как вы её загрузили, а её файлы резолвятся относительно показанного лендинга. Два следствия, о которых стоит знать:
- Собственный тег
<base>остаётся нетронутым. - Якорные ссылки (
href="#form"), скрипты попапов и плавный скролл продолжают работать. В Keitaro они ломаются, потому что там переписывается каждыйhref.
Ссылка на оффер
Простейший вариант, и пользоваться стоит именно им:
<a href="{offer}">Buy</a>
{offer} заменяется на подписанный переход лендинг → оффер (с 1.6.14, как в Keitaro): клик проходит через трекер, поэтому воронка засчитывается, а макросы оффера подставляются при редиректе. До 1.6.14 макрос вставлял прямой URL рекламодателя в обход трекера — в потоках с «offer selection: before» кликов было ноль.
Несколько офферов на одной странице — работает любая из форм, явная во всех версиях:
<a href="/?_lp=1&offer_id=10">Offer 10</a>
<a href="{offer}&offer_id=22">Offer 22</a>
Дописанный к {offer} параметр &offer_id= переключает оффер (с 1.6.14): {offer} разворачивается в подписанную ссылку перехода, поэтому трекер читает параметр и переатрибутирует клик — конверсия ляжет на указанный вами оффер. До 1.6.14 {offer} разворачивался в прямой URL рекламодателя, и параметр просто уходил туда; явная форма /?_lp=1&offer_id=N работает во всех версиях.
Передача выбора, сделанного на лендинге (продукт, тариф или ответ квиза), работает как в Keitaro: добавьте sub_id_1 … sub_id_30 к ссылке перехода — они обновят клик.
<a href="/?_lp=1&sub_id_5=Blue%20Watch&sub_id_6=https%3A%2F%2Fcdn.example%2Fblue.jpg">Buy the blue one</a>
URL оффера подхватит их как {sub_id_5} / {sub_id_6}, например https://network.example/?sub1={clickid}&product={sub_id_5}&image={sub_id_6}. Значения записываются и в клик, так что отчёты и постбеки видят то же самое. Принимаются только ключи sub_id_N, пустые значения никогда не затирают то, что прислал источник трафика, а каждое значение ограничено 512 байтами. На лендинге, размещённом не у вас, допишите их к подписанной ссылке: {lp_url}&sub_id_5=….
С 1.6.14 работает и {offer}&sub_id_5=… — макрос и есть ссылка перехода, поэтому трекер читает то, что вы к ней дописали. Если значение известно ещё до клика (один продукт на кампанию), пропустите шаг с лендингом вовсе и впишите ?sub_id_5=… прямо в ссылку кампании.
Время на лендинге
На страницу не нужно ничего добавлять: каждый лендинг, который отдаёт трекер, получает небольшой таймер, вставляемый перед </body>. Он сообщает, сколько времени посетитель провёл на странице — нажал ли он вообще кнопку оффера или нет, и в этом разница с Time to offer: страница, с которой никто не ушёл на оффер, по старой метрике не сообщает ничего — и именно такую страницу стоит найти.
Что он меряет, а чего сознательно не меряет:
- только видимое время — фоновая вкладка ничего не накапливает;
- глубину скролла, до которой докрутили, 0-100 %, в паре с секундами;
- контрольные точки на 5, 15, 30 и 60 секундах и далее каждую минуту, плюс финальная
отправка, когда страница скрыта или выгружена, — даже закрытая вкладка оставляет цифру.
Где это видно: колонка Time on LP в Logs (значения меньше 5 секунд подсвечиваются) и в деталях клика, а в отчётах — метрики Time on LP, LP bounce rate, LP scroll depth и LP measured visits плюс измерение Time on LP (bucket). Визит, который так и не отчитался — редиректный лендинг на чужом домене без трекинг-скрипта, бот, не исполняющий JS, — группируется как Unknown, а не считается визитом с нулевым временем.
Для лендинга на чужом хостинге тот же таймер едет внутри tracking.js / kclient.js; PHP-страница выводит $client->timerScript() (см. Tracking Client (PHP)).
Записи сессий и карта кликов
Вкладка Session recording в редакторе лендинга включает записи в стиле Clarity для этого лендинга: доля посетителей (5–100 %), длительность записи и общие лимиты хранилища. Записи проигрываются в ⚙ → Logs → Session recordings; та же вкладка открывает карту кликов и карту скролла лендинга. Локальным лендингам и «Show HTML» ничего дополнительно не нужно; внешние страницы пишутся через tracking.js / kclient.js / kclient.php. Поля форм маскируются в браузере посетителя. → Записи сессий и карты кликов
Макросы
Подставляются в HTML локального лендинга:
| Макрос | Значение |
|---|---|
{offer} | подписанный переход лендинг → оффер (/index.php?_lp=1&_token=…, с 1.6.14 — клик проходит через трекер, поэтому воронка засчитывается, а дописанные параметры &offer_id= / &sub_id_N доезжают до него; то же значение, что у {lp_url}) |
{lp_url} | тот же подписанный переход, в написании для внешних лендингов |
{offer_id} | id привязанного оффера |
{clickid}, {subid} | id клика |
{token} | подписанный токен, его использует JS-адаптер |
{keyword}, {sub_id_1} … {sub_id_30} | параметры клика, пойманные от источника трафика |
Значения, взятые из URL, экранируются HTML. Всё остальное не трогается — {unknown}, шаблонные литералы JS, синтаксис Vue и Angular остаются как есть.
Если на потоке нет оффера, {offer} превращается в неподписанную ссылку перехода, которая при клике наглядно покажет ошибку конфигурации, а не молча перезагрузит страницу.
Редиректные (внешние) лендинги
Лендинг лежит на вашем хостинге. Трекер отправляет посетителя туда и дописывает два параметра:
https://your-landing.example/promo?_subid=<click id>&_token=<signed token>
Именно токен делает ссылку на оффер рабочей в принципе. Лендинг на другом домене не может читать куки трекера, поэтому без токена трекеру неоткуда понять, какой клик вернулся. Токен подписан HMAC-SHA256 и живёт 24 часа; голый _subid из URL сам по себе не принимается — иначе каждый мог бы атрибутировать визит любому click id по вкусу. Локальный лендинг или лендинг предзагрузки восстанавливает клик из куки, поэтому токен ему не нужен.
{offer} внутри самого URL лендинга разворачивается в тот же переход, в абсолютной форме (http://your-tracker/index.php?_lp=1&_token=…), поэтому лендинг, берущий CTA из query-параметра, тоже получает рабочую ссылку. Оба поведения требуют v1.6.14; до неё эта пара фактически не доезжала, а {offer} вставлял прямой URL рекламодателя.
Поставьте JS-адаптер и ведите на оффер так:
<a href="/?_lp=1">Buy</a>
Адаптер перепишет это в абсолютную ссылку на трекер и добавит _subid и _token.
Лендинги предзагрузки
Трекер подгружает вашу страницу на своей стороне, вставляет <base href>, чтобы картинки и стили продолжали грузиться с исходного хоста, применяет макросы и отдаёт результат под вашим доменом — без редиректа. Для ссылки на оффер используйте {offer}.
Лендинги-действия
Ничего не показывается. Выберите, что произойдёт:
| Действие | Результат |
|---|---|
| Send to campaign | передаёт посетителя в другую кампанию; клик засчитывается в обеих |
| Show a 404 error | пустая страница, статус 404 |
| Show as text | введённый текст, как text/plain |
| Show as HTML | введённый HTML |
| Do nothing | пустой ответ; посетитель остаётся на месте |
{offer}, {clickid} и параметры клика подставляются в вариантах с текстом и HTML.
Keitaro передаёт посетителя в другую кампанию без редиректа. Orbitra использует редирект: повторный вход в трекер в рамках того же запроса означал бы двойное подключение его входного скрипта, чего PHP не умеет. Клик и так, и так записывается в обеих кампаниях — посетитель просто делает один лишний хоп.
JS-адаптер
<script src="https://your-tracker/js/orbitra-adapter.js"
data-postback="https://your-tracker/POSTBACK_KEY/postback"></script>
Вставьте его в <head> на каждой странице. Панель показывает сниппет с уже подставленным вашим ключом — в настройках лендинга.
Обязателен для редиректного лендинга. Необязателен, но полезен для локального с несколькими страницами: он несёт клик на внутренние страницы и формы, так что вторая страница по-прежнему знает, кто посетитель.
Он сознательно не трогает то, что переписывает адаптер Keitaro: ссылки #anchors, mailto:, tel: и javascript: остаются нетронутыми, а ссылки на сторонние домены никогда не получают ваш click id.
Отправка конверсии со страницы
<a href="{offer}" onclick="orbitraPostback(this, event, 'lead', 10)">Buy</a>
Аргументы: элемент, событие, статус конверсии, опциональный payout и опциональный id транзакции. Переход состоится, даже если постбек не ушёл — терять продажу из-за сбоя при отправке было бы худшей сделкой.
Для обработчика формы проще на PHP:
file_get_contents('https://your-tracker/POSTBACK_KEY/postback?subid=' . urlencode($_COOKIE['subid']) . '&status=lead');
PHP-лендинги
По умолчанию выключены. Включайте в Settings → General → Allow PHP landings, и только для лендингов с кодом, которому вы доверяете: PHP-лендинг исполняется внутри трекера, в web root.
Требования
- Входная страница —
index.php. - Эти вызовы отклоняются при загрузке:
exec,system,shell_exec,passthru,proc_open,popen,pcntl_exec,pcntl_fork,dl,eval,assert,create_function,symlink,link,set_time_limit,ini_set,ini_alter. - Подключайте другие файлы по абсолютному пути:
require_once dirname(__FILE__) . '/src/lib.php'; // right
require_once 'src/lib.php'; // wrong
- Держите выполнение в пределах таймаута (по умолчанию 3 секунды, максимум 9). Ставьте таймауты на каждом вызове curl:
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3);
curl_setopt($ch, CURLOPT_TIMEOUT, 3);
Чтение клика
<?php
$clickId = $rawClick->get('click_id');
$keyword = $rawClick->get('keyword');
$offer = $rawClick->get('offer'); // the offer URL, same as {offer}
$rawClick — только на чтение. Чтобы записать конверсию, отправьте постбек.
Скан — не песочница. Он читает загруженный исходник собственным токенайзером PHP, поэтому видит реальные вызовы, а не слова в комментариях — но
$f = 'sys' . 'tem'; $f();его обходит, как обходит и эквивалентную проверку в любом другом трекере. Риск на самом деле сдержит то, что фича выключена по умолчанию, что включить её может только админ и чтоdisable_functionsиopen_basedirиз вашегоphp.iniдействуют на лендинг ровно так же, как на всё остальное. Настройте их.
LeadForge 2.0 (анализатор лендингов, JS-валидация и мост между сетями)
LeadForge 2.0 — встроенный в Orbitra движок для анализа, чистки и пересадки пакетов лендингов на целевые партнёрские сети.
Режимы интеграции
- Auto Mode: автоматически определяет сеть-источник по сигнатурам кода и направляет отправки форм в целевую сеть.
- Cross-Network Mode: удаляет штатные обработчики заказов исходной сети (
send.php,order.php,api.php), вычищает чужие трекинг-пиксели и скрипты и ставит универсальный мост между сетями. - Raw Mode (Clone Patch): срезает чужие счётчики и скрипты, вшивает мост ClickID/SubID и макросы
{offer}, не генерируя серверных обработчиков.
Валидация телефонов по 150 гео и клиентский адаптер (orbitra_adapter.js)
При включении LeadForge вшивает orbitra_adapter.js, который даёт:
- Правила для 150 стран: точные regex-паттерны национальных и международных форматов, проверка префиксов мобильных операторов и ограничения мин/макс длины.
- Динамическое переключение страны: автоматически обновляет правила валидации, лимиты длины и хелперы счётчика, когда пользователь меняет
<select name="country">. - Живые бейджи ввода: счётчик в реальном времени показывает, сколько цифр введено и сколько осталось (например, «3 cifre inserite, 7 mancanti» → «Numero complete»).
- Строгая валидация имён в Unicode: фильтрация в реальном времени не пускает цифры и спам-символы в имена клиентов.
- Тактильная вибрация: мобильное устройство вибрирует при попытке ввести телефон в неверном формате.
- Мост ClickID / SubID: ловит все входящие трекинг-параметры (
subid,click_id,sub1..sub5,utm_*,fbp,fbcи т.д.) и заполняет поля форм по всей многостраничной воронке.
Универсальный CPA-мост заказов (order.php)
Генерирует самостоятельный обработчик заказов «всё в одном» с поддержкой 10 CPA-сетей:
- Dr.Cash, Webvork (с фолбэком SuperClient), Lucky.online, KMA.biz, TerraLeads (с проверкой контрольной суммы SHA1), Leadbit, LemonAD, Everad, Ezaff и Custom Webhooks.
- Автоматическая нормализация E.164: приводит локальные номера к международному формату со сверкой кода страны.
- Двойная запись в CRM: одновременно отправляет лид в партнёрскую сеть и пишет полный «сырой» снимок лида в Orbitra CRM Vault (
orbitraCrmRecordLead//crm-ingest). - Отказоустойчивый локальный лог: лиды дописываются в
leadforge.leads.logиorbitra_leads_backup.log.
Устранение неполадок
Картинки и видео не грузятся. Используйте относительные пути. Если пути верные, а страница всё равно открывается «голой», проверьте, что вы открываете URL кампании, а не landings/<id>/index.html напрямую.
Кнопка покупки никуда не ведёт. Скорее всего, лендинг всё ещё смотрит напрямую на рекламодателя — лендинг, скопированный из чужой воронки, сохраняет их партнёрскую ссылку. Замените эти href на {offer}.
Landing transition failed: original click not found. Лендинг на другом домене без JS-адаптера — либо посетитель с отключёнными куки и без _token в URL.
no offer attached to this stream. У потока есть лендинг, но нет оффера. Добавьте оффер — либо оставьте лендинг финальной страницей и уберите ссылку на оффер.
PHP-лендинг показывает «disabled on this tracker». Фича выключена; см. выше.
Быстрый старт: первая кампания
Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.
Читать гайд →ДокументацияУстановка и обновление
Установите 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 и управляйте кампаниями обычными словами.
Читать гайд →