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

Лендинги

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

ТипДе живеПосилання на оффер
Localзавантажений ZIP, віддається трекером{offer} або /?_lp=1
Redirectваш власний хостинг, інший домен/?_lp=1 + JS-адаптер
Preloadпідтягується трекером, показується під вашим доменом{offer}
Actionнічого не показується; трекер щось робить—

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

Архів розпаковується у landings/<landing id>/. Точка входу — index.html, або index.php, якщо PHP-лендинги увімкнені.

Вимоги

На відміну від Keitaro, Orbitra не додає тег <base> і не переписує вашу розмітку. Сторінка віддається байт у байт так, як ви її завантажили, а її файли розв'язуються відносно лендинга, який вам показали. Два наслідки, які варто знати:

Посилання на оффер

Найпростіша форма, і саме до неї варто тягнутися:

<a href="{offer}">Buy</a>

{offer} замінюється на підписаний перехід лендинг→оффер (з 1.6.14, як у Keitaro): клік проходить через трекер, тож воронка рахується, а макроси оффера підставляються при редиректі. До 1.6.14 він вбудовував пряме посилання рекламодавця, яке оминало трекер — потоки з «offer selection: before» показували нуль кліків.

З кількома офферами на одній сторінці працює будь-яка форма — явна в кожній версії:

<a href="/?_lp=1&offer_id=10">Offer 10</a>
<a href="{offer}&offer_id=22">Offer 22</a>

Додавання &offer_id= до {offer} перемикає оффер (з 1.6.14): {offer} розгортається у підписане посилання переходу, тож трекер читає параметр і перерозподіляє клік — конверсія потрапляє на названий вами оффер. До 1.6.14 {offer} розгортався у пряме посилання рекламодавця, і параметр просто передавався йому; явна форма /?_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: сторінка, яку ніхто не проклацав далі, за старою метрикою не повідомляє нічого, і саме таку сторінку варто знайти.

Що він міряє, і що свідомо не міряє:

flush, коли сторінку сховано або розвантажено, тож закрита вкладка все одно лишає число.

Де воно з'являється: колонка Time on LP у Logs (значення менші за 5 секунд підсвічуються) і в деталях кліка, а у звітах — метрики Time on LP, LP bounce rate, LP scroll depth і LP measured visits плюс розріз Time on LP (bucket). Візит, який ніколи не прозвітував — redirect-лендинг на чужому домені без трекінг-скрипта, бот, що не виконує JS, — групується як Unknown, а не рахується як візит на нуль секунд.

Для лендингу на іншому хостингу той самий таймер їде всередині tracking.js / kclient.js; PHP-сторінка робить echo $client->timerScript() (див. Tracking Client (PHP)).

Запис сесій і теплова карта

Вкладка Session recording редактора лендинга вмикає записи у стилі Clarity для цього лендинга: частка відвідувачів (5–100 %), скільки записувати і спільні ліміти сховища. Записи програваться у ⚙ → Logs → Session recordings; та сама вкладка відкриває теплову карту кліків і карту скролу лендинга. Локальним лендингам і «Show HTML» нічого додаткового не потрібно; зовнішні сторінки записуються через tracking.js / kclient.js / kclient.php. Поля форм маскуються у браузері відвідувача. → Session recordings and click heatmaps

Макроси

Підставляються в 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 template literals, синтаксис Vue і Angular усе виживає.

Якщо на потоці немає оффера, {offer} стає непідписаним посиланням переходу, яке при кліку показує пояснення помилки налаштування замість того, щоб мовчки перезавантажувати сторінку.


Редирект-лендинги (зовнішні)

Лендинг лежить на вашому власному хостингу. Трекер відправляє відвідувача туди і додає два параметри:

https://your-landing.example/promo?_subid=<click id>&_token=<signed token>

Токен — це те, що взагалі змушує посилання на оффер працювати. Лендинг на іншому домені не може читати куки трекера, тож без нього трекер не має способу зрозуміти, з яким кліком повертається відвідувач. Він підписаний HMAC-SHA256 і протікає через 24 години; голий _subid з URL сам по собі не приймається, бо це дозволило б комусь приписати візит будь-якому click id на свій смак. Локальний або preload-лендинг натомість відновлює клік з куки, тож токен йому не потрібен.

{offer} всередині власного URL лендинга стає тим самим переходом, абсолютним (http://your-tracker/index.php?_lp=1&_token=…), тож лендинг, що бере свій CTA з query-параметра, теж отримує робоче посилання. Обидві поведінки потребують v1.6.14; до неї пара взагалі не доходила, а {offer} вбудовував пряме посилання рекламодавця.

Встановіть JS-адаптер і посилайте на оффер так:

<a href="/?_lp=1">Buy</a>

Адаптер переписує це в абсолютне посилання на трекер і додає _subid і _token.


Preload-лендинги

Трекер підтягує вашу сторінку серверно, інжектує <base href>, щоб її зображення і стилі досі завантажувалися з оригінального хоста, застосовує макроси і віддає результат під вашим доменом — без редиректу. Для посилання на оффер використовуйте {offer}.


Лендинги-дії (Action)

Нічого не показується. Оберіть, що відбувається:

ДіяРезультат
Send to campaignпередає відвідувача іншій кампанії; клік рахується в обох
Show a 404 errorпорожня сторінка, статус 404
Show as textвведений вами текст, як text/plain
Show as HTMLвведений вами HTML
Do nothingпорожня відповідь; відвідувач залишається там, де є

{offer}, {clickid} і параметри кліка підставляються у варіантах text і HTML.

Keitaro передає відвідувача іншій кампанії без редиректу. Orbitra використовує редирект: повторний вхід у трекер в одному запиті означав би двічі включити його вхідний скрипт, чого PHP не може. Клік і так записується в обох кампаніях — відвідувач просто робить один зайвий стрибок.


JS-адаптер

<script src="https://your-tracker/js/orbitra-adapter.js"
        data-postback="https://your-tracker/POSTBACK_KEY/postback"></script>

Вставте його в <head> на кожній сторінці. Панель показує сніпет із підставленим вашим ключем, у налаштуваннях лендинга.

Обов'язковий для redirect-лендинга. Необов'язковий, але корисний для локального з кількома сторінками: він несе клік на внутрішні сторінки і форми, тож друга сторінка теж знає, хто відвідувач.

Він свідомо не чіпає те, що переписує адаптер Keitaro: посилання #anchors, mailto:, tel: і javascript: лишаються недоторканими, а посилання на сторонні домени ніколи не отримують ваш click id.

Повідомлення про конверсію зі сторінки

<a href="{offer}" onclick="orbitraPostback(this, event, 'lead', 10)">Buy</a>

Аргументи: елемент, подія, статус конверсії, опціональна виплата і опціональний transaction 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 — read-only. Щоб записати конверсію, надішліть постбек.

Скан — не пісочниця. Він читає завантажений вихідний код власним токенайзером 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 через 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 й керуйте кампаніями, офферами та доменами звичайними словами.

Читати гайд →