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

Постбеки и конверсии

Конверсия попадает в 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 и потерянного события».

Как определяется статус

По порядку:

  1. Типы конверсий из Настройки → Типы конверсий — если статус есть в списке значений типа.
  2. Встроенный тип с тем же именем.
  3. Правило <тип>_status=… из самого постбека.
  4. Встроенные алиасы: approved, confirmed, accepted, converted → sale; declined, refused, cancelled, canceled → rejected.
  5. Иначе — 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 (раз в минуту) доставляет их с повторами:

⚠️ Без крона очередь не разбирается. Установщик ставит его сам; проверить и поставить вручную — Настройки → Автоматизация → Очередь постбеков. Обновление через панель тоже восстанавливает пропавший крон.

Лог очереди: ⚙ → Логи → S2S (статус, попытки, следующая попытка, последняя ошибка, HTTP-код).

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

Кнопка на вкладке S2S Postbacks (только администратор) отправляет на этот же сервер настоящий постбек с одноразовым кликом и показывает вердикт по каждому шагу:

Тестовые клик, конверсия и строки очереди после проверки удаляются.

Повторная отправка пропущенных

Кнопка «Переотправить пропущенные конверсии» ставит в очередь конверсии за последние 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
← Назад
Внешние PWA и Telegram-каналы
Вперёд →
Расходы: импорт из рекламных кабинетов
Исходник на GitHub: github.com/fenjo26/Orbitra.link/wiki
Все гайды
Документация

Быстрый старт: первая кампания

Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.

Читать гайд →
Документация

Установка и обновление

Установите 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 и управляйте кампаниями обычными словами.

Читать гайд →