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

Лендинги

Лендинг — страница, которую посетитель видит на пути к офферу. В Orbitra их четыре типа, и различия между ними сводятся по большей части к одному вопросу: как кнопка покупки добирается до оффера.

ТипГде живётСсылка на оффер
Локальныйзагруженный ZIP, отдаётся трекером{offer} или /?_lp=1
Редиректваш хостинг, другой домен/?_lp=1 + JS-адаптер
Предзагрузкаподгружается трекером, показывается под вашим доменом{offer}
Действиеничего не показывается; трекер что-то делает—

Локальные лендинги

Архив распаковывается в landings/<id лендинга>/. Точка входа — index.html, либо index.php, если включены PHP-лендинги.

Требования

В отличие от Keitaro, Orbitra не добавляет тег <base> и не переписывает вашу разметку. Страница отдаётся байт в байт так, как вы её загрузили, а её файлы резолвятся относительно показанного лендинга. Два следствия, о которых стоит знать:

Ссылка на оффер

Простейший вариант, и пользоваться стоит именно им:

<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: страница, с которой никто не ушёл на оффер, по старой метрике не сообщает ничего — и именно такую страницу стоит найти.

Что он меряет, а чего сознательно не меряет:

отправка, когда страница скрыта или выгружена, — даже закрытая вкладка оставляет цифру.

Где это видно: колонка 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.

Требования

  1. Входная страница — index.php.
  2. Эти вызовы отклоняются при загрузке: 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.
  3. Подключайте другие файлы по абсолютному пути:
   require_once dirname(__FILE__) . '/src/lib.php';   // right
   require_once 'src/lib.php';                        // wrong
  1. Держите выполнение в пределах таймаута (по умолчанию 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 движок для анализа, чистки и пересадки пакетов лендингов на целевые партнёрские сети.

Режимы интеграции

Валидация телефонов по 150 гео и клиентский адаптер (orbitra_adapter.js)

При включении LeadForge вшивает orbitra_adapter.js, который даёт:

Универсальный CPA-мост заказов (order.php)

Генерирует самостоятельный обработчик заказов «всё в одном» с поддержкой 10 CPA-сетей:


Устранение неполадок

Картинки и видео не грузятся. Используйте относительные пути. Если пути верные, а страница всё равно открывается «голой», проверьте, что вы открываете 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». Фича выключена; см. выше.

← Назад
Проверка браузера
Вперёд →
PWA-лендинги и Web Push
Исходник на 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 и управляйте кампаниями обычными словами.

Читать гайд →