Постбеки та конверсії
Конверсія приходить в 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 і загубленої події».
Як визначається статус
За порядком:
- Типи конверсій з Settings → Conversion Types — якщо статус є у списку значень типу.
- Вбудований тип із такою самою назвою.
- Правило
<type>_status=…із самого постбека. - Вбудовані аліаси:
approved,confirmed,accepted,converted→sale;declined,refused,cancelled,canceled→rejected. - Інакше —
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 (раз на хвилину) доставляє їх із повторами:
- успіх — HTTP 2xx–3xx;
- повтори: 60 с → 5 хв → 30 хв → 2 год → 24 год, після чого рядок позначається
failed; - перевірка SSRF при постановці в чергу і перед відправкою: адреса в приватній мережі одразу отримує
failed; - рядок, покинутий у
in_flightвпалим воркером, повертається в чергу через 10 хвилин.
⚠️ Без cron черга ніколи не обробляється. Інсталятор його ставить; перевірити чи додати вручну — Settings → Automation → Postback Queue. Оновлення через панель теж відновлює загублений cron.
Журнал черги: ⚙ → Logs → S2S (статус, спроби, наступна спроба, остання помилка, HTTP-код).
Тестер постбеків
Кнопка на вкладці S2S Postbacks (лише для адміна) шле справжній постбек на цей самий сервер з одноразовим кліком і показує вердикт по кожному кроку:
- з яким статусом записалася конверсія;
- чи пропускає її фільтр статусів кожного S2S-постбека — і чому: за внутрішнім статусом, за словом мережі чи за легасі-чіпом;
- пробну доставку джерелу: HTTP-код і таймінги;
- макроси, які не розв'яжуться і підуть джерелу як простий текст (
{external_id},{sub_id_N}); - плейсхолдери з шаблону джерела (
bbg=xxx,[YOUR_…]); - чи живий воркер черги і чи встановлений cron.
Тестові клік, конверсія і рядки черги видаляються після перевірки.
Повторна відправка пропущених конверсій
Кнопка «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
Швидкий старт: ваша перша кампанія
Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.
Читати гайд →ДокументаціяВстановлення та оновлення
Встановіть 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 й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →