Постбеки и конверсии
Конверсия попадает в Orbitra постбеком от партнёрской сети и привязывается к клику по его ID (subid). Дальше трекер может переслать её в источник трафика (исходящий S2S-постбек) и в Conversions API рекламной платформы.
Входящий постбек
Адрес постбека — ⚙ → Postback URL. Он выглядит так:
https://ваш-домен/<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 | нет | Дополнительные значения |
<тип>_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 и потерянного события».
Как определяется статус
По порядку:
- Типы конверсий из Настройки → Типы конверсий — если статус есть в списке значений типа.
- Встроенный тип с тем же именем.
- Правило
<тип>_status=…из самого постбека. - Встроенные алиасы:
approved,confirmed,accepted,converted→sale;declined,refused,cancelled,canceled→rejected. - Иначе —
custom.
Статусы, не попавшие ни в один тип, видны в Настройки → Типы конверсий → Несмапленные статусы: оттуда их можно смапить в тип, и уже записанные конверсии переклассифицируются.
Типы конверсий
У каждого типа: название, список статусов от сети, цвет метки и четыре флага — влияет на «Конверсии», влияет на «Профит», отправлять S2S в источник, учитывается в Cap оффера. Из коробки есть тип Revshare (статус revshare идёт только в профит: без новой конверсии, без S2S, без Cap).
Выплаты в другой валюте
Выплата конвертируется в базовую валюту трекера (курсы — core/CurrencyRates.php). Исходная сумма, валюта и курс сохраняются в клике. Макросы исходящих постбеков {payout} / {currency} несут значение в базовой валюте, исходные — {fx_orig_payout} / {fx_orig_currency}. Неизвестная пара валют записывается как есть.
Журнал входящих постбеков
⚙ → Логи → Постбеки — каждый входящий запрос с результатом: найден ли клик, какой статус получился, сумма. 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, и крон postback_queue_cron.php (раз в минуту) доставляет их с повторами:
- успех — HTTP 2xx–3xx;
- повторы: 60 с → 5 мин → 30 мин → 2 ч → 24 ч, потом строка помечается
failed; - SSRF-проверка при постановке и перед отправкой: адрес в приватной сети — сразу
failed; - строка, брошенная упавшим воркером в
in_flight, через 10 минут возвращается в очередь.
⚠️ Без крона очередь не разбирается. Установщик ставит его сам; проверить и поставить вручную — Настройки → Автоматизация → Очередь постбеков. Обновление через панель тоже восстанавливает пропавший крон.
Лог очереди: ⚙ → Логи → S2S (статус, попытки, следующая попытка, последняя ошибка, HTTP-код).
Тестер постбеков
Кнопка на вкладке S2S Postbacks (только администратор) отправляет на этот же сервер настоящий постбек с одноразовым кликом и показывает вердикт по каждому шагу:
- с каким статусом записалась конверсия;
- пропускает ли её фильтр статусов каждого S2S-постбека — и почему: по внутреннему статусу, по слову сети или по старому чипу;
- пробная доставка в источник: HTTP-код и время;
- макросы, которые не подставились бы и ушли бы в источник текстом (
{external_id},{sub_id_N}); - заглушки из шаблона источника (
bbg=xxx,[YOUR_…]); - жив ли воркер очереди и стоит ли крон.
Тестовые клик, конверсия и строки очереди после проверки удаляются.
Повторная отправка пропущенных
Кнопка «Переотправить пропущенные конверсии» ставит в очередь конверсии за последние 72 часа, которые проходят текущий фильтр, но не попали в очередь. Повторное нажатие ничего не дублирует.
Импорт конверсий
⚙ → Импорт конверсий — загрузка из файла или вставка списка click ID, если сеть не умеет постбеки или их нужно восстановить.
Conversions API
Отправка конверсий на сервер Meta и TikTok настраивается в профиле пикселя и в кампании (вкладка «Интеграции»). Подробно про Meta — Facebook / Meta. События ставятся в очередь вместе с конверсией и доставляются с подтверждением: успех — только ответ 2xx, где events_received совпало с размером пачки.
Мониторинг
conversion_monitor_cron.php считает долю неудачных постбеков за окно (по умолчанию 60 минут) и при превышении порога (10%) пишет алерт в var/logs/conversion_alerts.log; отправка алерта в Telegram пока не реализована. Установщик этот крон не ставит, при необходимости добавьте:
*/5 * * * * php /var/www/orbitra/conversion_monitor_cron.php --quiet
Быстрый старт: первая кампания
Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.
Читать гайд →ДокументацияУстановка и обновление
Установите 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 и управляйте кампаниями обычными словами.
Читать гайд →