Лендинги
Лендинг — це сторінка, яку відвідувач бачить на шляху до оффера. Orbitra віддає чотири види, і різниця між ними важлива переважно для одного питання: як кнопка купівлі доходить до оффера.
| Тип | Де живе | Посилання на оффер |
|---|---|---|
| Local | завантажений ZIP, віддається трекером | {offer} або /?_lp=1 |
| Redirect | ваш власний хостинг, інший домен | /?_lp=1 + JS-адаптер |
| Preload | підтягується трекером, показується під вашим доменом | {offer} |
| Action | нічого не показується; трекер щось робить | — |
Локальні лендинги
Архів розпаковується у landings/<landing 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 він вбудовував пряме посилання рекламодавця, яке оминало трекер — потоки з «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: сторінка, яку ніхто не проклацав далі, за старою метрикою не повідомляє нічого, і саме таку сторінку варто знайти.
Що він міряє, і що свідомо не міряє:
- лише видимий час — вкладка, залишена у фоні, не накопичує;
- найглибший скрол, досягнутий від 0 до 100 %, поруч із секундами;
- контрольні точки на 5, 15, 30 і 60 секундах і щохвилини далі, плюс фінальний
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.
Вимоги
- Вхідна сторінка —
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 — read-only. Щоб записати конверсію, надішліть постбек.
Скан — не пісочниця. Він читає завантажений вихідний код власним токенайзером 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 (з fallback SuperClient), Lucky.online, KMA.biz, TerraLeads (з перевіркою контрольної суми SHA1), Leadbit, LemonAD, Everad, Ezaff та Custom Webhooks.
- Автоматична нормалізація E.164: стандартизує локальні номери телефонів до міжнародного формату з узгодженням префікса країни.
- Подвійний запис у CRM: одночасно відправляє лід у партнерську мережу і записує повний сирий снапшот ліда у CRM Vault Orbitra (
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 через 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 й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →