Расходы: импорт из рекламных кабинетов
Orbitra забирает дневной расход из рекламных кабинетов и раскладывает его по кликам, поэтому ROI и прибыль в отчётах считаются по реальным деньгам, а не по ручной стоимости клика.
Подключения — в ⚙ → Интеграции, группа рекламных сетей: Facebook Costs, TikTok Costs, Google Ads Costs. В редакторе кампании на вкладке Интеграции видно, есть ли у кликов кампании ID для привязки, и можно добавить подключение.
Как расход попадает на клик
- Крон
aggregator_cron.php(установщик ставит его раз в 15 минут) проходит по подключениям, у которых подошёл интервал обновления. При каждом проходе перечитываются последние 5 дней, при первом — 30: кабинеты задним числом уточняют расход, а текущий день растёт до полуночи. - Записи складываются в
cost_recordsс обновлением по(connection_id, external_id). Повторная синхронизация того же дня безопасна: расход пересчитывается, а не накапливается. - Для каждой записи ищутся клики того же дня, от точного уровня к общему:
ad_id(такжеcreative_id,creative);adset_id/adgroup_id(такжеadgroup,adgroupid,ad_group_id);campaign_id(такжеcampaign,campaignid,ad_campaign_id).
- Расход дня делится поровну между найденными кликами.
- Расход конвертируется в валюту трекера (курсы
open.er-api.com, кэш 12 часов; свои курсы — настройкаfx_rates_manual_json, единиц за 1 USD).
Главное условие: ссылка в объявлении должна передавать ID объявления, группы или кампании в трекер. Проще всего выбрать в кампании источник трафика из шаблона (Facebook, TikTok, Google Ads) — шаблон сам добавит нужные макросы.
Записи, которые не нашли кликов, пробуют привязаться заново при каждой синхронизации: поздний клик, исправленная ссылка или новый adgroup_id подтянут расход.
«Получено N, привязано 0»
Кнопка Обновить расходы у подключения показывает конкретную причину:
| Код | Что значит |
|---|---|
no_spend | записи пришли, но расход в них нулевой |
no_clicks | в эти дни в Orbitra нет кликов |
no_ids | у кликов нет ID объявления, группы или кампании — ссылка ведёт не прямо на кампанию Orbitra или параметры теряются по пути |
macros | в кликах нераскрытые макросы вида __CID__ — источник не подставил значения |
ids_differ | ID в кликах и в отчёте кабинета не совпадают; показываются оба |
В карточке клика раздел «Параметры» показывает все пойманные параметры, ID рекламных сетей — первыми.
Facebook / Meta
Long-lived User Token или System User Token с ads_read + ID рекламного аккаунта (act_…). Можно указать версию API и прокси. Подробно — Facebook / Meta.
TikTok
Три способа подключения:
| Способ | Что нужно |
|---|---|
| Подключить через TikTok MCP | Только вход в TikTok. Приложение разработчика и токен не нужны — трекер регистрируется сам через официальный MCP-сервер TikTok. Импортирует расход, пиксели не импортирует. Панель должна быть открыта по HTTPS (подойдёт и https:// на голом IP) |
| 1-Click (Войти через TikTok) | App ID и App Secret своего приложения TikTok for Business: переменные окружения ORBITRA_TIKTOK_APP_ID / ORBITRA_TIKTOK_APP_SECRET или поля ручного подключения. Находит кабинеты и пиксели, импортирует пиксели в Pixel Vault |
| Вручную | Токен Marketing API из бесплатного приложения разработчика (Developer Portal → Apps & Agents → Direct Advertiser, права Ads Management и Reporting) + Advertiser ID |
Токен Events Manager для импорта расходов не подходит — он только отправляет события конверсий. Если список кабинетов через MCP не читается, Advertiser ID можно вставить вручную через запятую.
Google Ads
- 1-Click (Войти через Google) — находит прямые аккаунты и дочерние кабинеты MCC, для каждого выбранного создаёт подключение. Нужны Developer Token (из MCC) и OAuth Client ID + Secret (Google Cloud Console, тип «Web application», redirect URI
https://ваш-домен/api.php?action=google_ads_oauth_callback). - Вручную — Customer ID, Developer Token, Client ID, Client Secret, Refresh Token.
Ключи для 1-Click берутся по порядку: переменные окружения ORBITRA_GOOGLE_CLIENT_ID, ORBITRA_GOOGLE_CLIENT_SECRET, ORBITRA_GOOGLE_DEVELOPER_TOKEN → настройки → поля уже сохранённого ручного подключения. Проще всего один раз сохранить ручное подключение — после этого заработает и кнопка 1-Click. Проверить настройку сервера: php check_google_ads_oauth.php.
Переменные окружения читаются из окружения PHP-FPM (
env[ORBITRA_GOOGLE_CLIENT_ID] = …в конфиге пула), а не из файла.env— PHP-код его не загружает..env.example— только список имён.
Google и TikTok не принимают OAuth-редиректы на http://. На голом IP без сертификата используйте ручное подключение.
Расход привязывается по ValueTrack {campaignid} и {creative} — их добавляет шаблон источника Google Ads.
Push и pop сети
Расход из сетей push/pop-трафика — AdMaven, PropellerAds, Kadam, Galaxion, HilltopAds, Adsterra, Clickadu — импортируется тем же кроном и ложится на клики по кампании и, где сеть отдаёт, по зоне (сайту). На этих данных работает Zone Killer, блокирующий сжигающие деньги зоны. См. Push и pop сети.
Dolphin и Fbtool
Эти сервисы умеют отправлять расход только в Keitaro через его Admin API. Orbitra принимает такой же запрос на POST /admin_api/v1/campaigns/<ID>/update_costs. Подробно — Dolphin / Fbtool.
Ручной расход
Кнопка Обновить расходы в меню кампании задаёт расход за период вручную (действие update_costs).
Агрегатор доходов
⚙ → Агрегатор доходов — обратная задача: забрать доход из кабинетов партнёрских программ, которые не шлют постбеки. Движки: ReferOn, Affilka, Generic API. Для каждого подключения задаются сеть, тип сделки, интервал синхронизации и имя параметра, в котором партнёрка хранит click ID Orbitra. Доходы и логи синхронизации — на вкладках той же страницы.
Крон
*/15 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/www/orbitra/var/logs/aggregator.log 2>&1
Интервал проверяется для каждого подключения отдельно, поэтому частый крон дешёвый; для интервалов меньше 15 минут запускайте его чаще. Флаги: --force (игнорировать интервал), --connection=5, --days=30.
Агентства и комиссия
Расход арендованного кабинета выше цифры из кабинета: процент агентства вписывается в каждый импорт (cost_records.fee_amount; clicks.cost несёт расход с комиссией, clicks.fee — долю комиссии) — ROI/CPC честные с первого синка, а смена процента историю не переписывает. Вкладка «Агентства» в разделе подключений управляет ими и сравнивает по расходу/CPC/CPM/ROI; у подключения агентство выбирается в редакторе. В отчётах — колонки «Расход кабинета» и «Комиссия агентства».
Имена объявлений и метрики площадки
Синк расхода собирает и то, что площадка знает о самих объявлениях: имена и статусы в ad_entities (обновляются ежечасно тем же кроном), показы и клики площадки на строки расхода. В отчётах по ad/adset/кампании — имена вместо голых id, чип статуса и колонки площадки: Показы, Клики (платформа), CPM, CTR (платформа) и Потеря кликов = 1 − посетители трекера / клики площадки — цифра, которая сразу показывает проблему с клоакингом или доменом. Баннер над отчётами показывает долю дохода, которую нельзя привязать к id объявления (нераскрытый макрос считается пропуском), с кнопкой «Исправить» в редактор источника.
Быстрый старт: первая кампания
Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.
Читать гайд →ДокументацияУстановка и обновление
Установите 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 и управляйте кампаниями обычными словами.
Читать гайд →