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

Постбеки та конверсії

Конверсія приходить в Orbitra постбеками від партнерської мережі і прикріплюється до кліка за його ID (subid). Далі трекер може переслати її джерелу трафіку (вихідний S2S-постбек) і в Conversions API рекламної платформи.

Вхідний постбек

Адреса постбека — ⚙ → Postback URL. Виглядає так:

https://your-domain/<postback_key>/postback

postback_key — секретний ключ установки (захист від фейкових конверсій). Якщо він досі дорівнює публічному значенню за замовчуванням із репозиторію, панель вас попередить; згенеруйте новий на тій самій сторінці або через php cli/generate_postback_key.php. Інсталятор генерує власний ключ.

Параметри

ПараметрОбов'язковийЗначення
subidтакID кліка трекера — те, що мережа отримала в {subid} / {clickid}
statusніСтатус конверсії: lead, sale, rejected, registration, deposit, trash або будь-який свій
payoutніСума виплати
currencyніВалюта виплати
tidніID транзакції — для повторних конверсій на тому самому кліку
sub_id_NніДодаткові значення
<type>_statusніМапити статуси прямо в URL: sale_status=approved,confirmed

Приклади:

…/postback?subid={subid}&status=lead
…/postback?subid={subid}&status=sale&payout={payout}
…/postback?subid={subid}&status=sale&payout={payout}&tid={transaction_id}
…/postback?subid={subid}&status={status}&sale_status=approved,confirmed

Якщо мережа називає свої параметри інакше, налаштуйте аліаси параметрів на тій самій сторінці.

Відповіді

200 — конверсію записано. 4xx — запит відхилено (невірний ключ, невідомий клік). 500 / 503 — помилка запису; мережі варто повторити постбек. Конверсія, її лічильники і події Conversions API пишуться однією транзакцією: помилка ніколи не дасть «200 і загубленої події».

Як визначається статус

За порядком:

  1. Типи конверсій з Settings → Conversion Types — якщо статус є у списку значень типу.
  2. Вбудований тип із такою самою назвою.
  3. Правило <type>_status=… із самого постбека.
  4. Вбудовані аліаси: approved, confirmed, accepted, converted → sale; declined, refused, cancelled, canceled → rejected.
  5. Інакше — custom.

Статуси, що не зійшлися з жодним типом, перелічені в Settings → Conversion Types → Unmapped statuses: там можна прив'язати їх до типу, і вже записані конверсії перекласифікуються.

Типи конверсій

Кожен тип має: назву, список статусів від мережі, колір мітки і чотири прапорці — зараховується в «Conversions», зараховується в «Profit», слати S2S джерелу, зараховується в Cap оффера. Тип Revshare є з коробки (статус revshare іде лише в прибуток: ні нової конверсії, ні S2S, ні Cap).

Виплати в іншій валюті

Виплата конвертується в базову валюту трекера (курси в core/CurrencyRates.php). Оригінальна сума, валюта і курс зберігаються на кліку. Макроси вихідного постбека {payout} / {currency} несуть значення в базовій валюті; оригінальні — {fx_orig_payout} / {fx_orig_currency}. Невідома валютна пара записується як є.

Журнал вхідних постбеків

⚙ → Logs → Postbacks — кожен вхідний запит з його результатом: чи знайшовся клік, який статус вийшов, яка сума. ID кліка відкриває картку кліка.

Вихідні S2S-постбеки (на джерело трафіку)

Налаштовуються в кампанії, на вкладці S2S Postbacks. Кожен постбек — картка: URL, метод GET або POST, чіпи статусів (sale, lead, rejected, registration, deposit, trash плюс кастомні). Меню «вставити макрос» вставляє макрос у позицію курсора.

Якщо в обраного джерела трафіку заданий postback_url, кампанія з порожнім списком отримує його автоматично. Якщо постбеки вже налаштовані, угорі вкладки з'являється підказка з кнопкою «додати».

Фільтр статусів пропускає конверсію, якщо зійшовся внутрішній статус (sale), власне слово мережі (approved) чи легасі-чіп custom для слів, які тепер розпізнаються аліасами.

Макроси

{subid} (також {clickid}, {click_id}), {status}, {payout} (також {conversion_revenue}), {currency}, {tid} (також {external_id}), {campaign_id}, {offer_id}, {cost}, {revenue}, {profit} і будь-який збережений параметр кліка за назвою: {sub_id_1} … {sub_id_30}, {fx_orig_payout}, {fx_orig_currency} тощо.

{status} несе внутрішній статус (sale), а не оригінальне слово мережі. Щоб перекласти його на словник джерела, використайте перетворення в стилі Keitaro: {status: sale=purchase lead=lead} — статус, якого немає в списку, проходить без змін.

Черга доставки

Вихідні постбеки не відправляються в момент конверсії — вони йдуть у чергу s2s_postbacks_log, і cron postback_queue_cron.php (раз на хвилину) доставляє їх із повторами:

⚠️ Без cron черга ніколи не обробляється. Інсталятор його ставить; перевірити чи додати вручну — Settings → Automation → Postback Queue. Оновлення через панель теж відновлює загублений cron.

Журнал черги: ⚙ → Logs → S2S (статус, спроби, наступна спроба, остання помилка, HTTP-код).

Тестер постбеків

Кнопка на вкладці S2S Postbacks (лише для адміна) шле справжній постбек на цей самий сервер з одноразовим кліком і показує вердикт по кожному кроку:

Тестові клік, конверсія і рядки черги видаляються після перевірки.

Повторна відправка пропущених конверсій

Кнопка «Re-send missed conversions» ставить у чергу конверсії за останні 72 години, які проходять поточний фільтр, але так і не потрапили в чергу. Повторне натискання нічого не дублює.

Імпорт конверсій

⚙ → Conversion Import — завантажте файл або вставте список ID кліків, коли мережа не може слати постбеки або коли їх треба відновити.

Conversions API

Відправка конверсій на сервери Meta і TikTok налаштовується у профілі піксела і в кампанії (вкладка «Integrations»). Деталі по Meta — у розділі Facebook / Meta. Події ставляться в чергу разом із конверсією і доставляються з підтвердженням: успіх — лише на відповіді 2xx, де events_received збігається з розміром пачки.

Моніторинг

conversion_monitor_cron.php рахує частку невдалих постбеків за вікно (типово 60 хвилин) і, коли перевищено поріг (10%), пише алерт у var/logs/conversion_alerts.log; відправка алерту в Telegram поки не зроблена. Інсталятор цей cron не ставить — додайте за потреби:

*/5 * * * * php /var/www/orbitra/conversion_monitor_cron.php --quiet
← Попередній
Зовнішні PWA та Telegram-канали
Наступний →
Витрати
Переглянути джерело на 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 й керуйте кампаніями, офферами та доменами звичайними словами.

Читати гайд →