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

Расходы: импорт из рекламных кабинетов

Orbitra забирает дневной расход из рекламных кабинетов и раскладывает его по кликам, поэтому ROI и прибыль в отчётах считаются по реальным деньгам, а не по ручной стоимости клика.

Подключения — в ⚙ → Интеграции, группа рекламных сетей: Facebook Costs, TikTok Costs, Google Ads Costs. В редакторе кампании на вкладке Интеграции видно, есть ли у кликов кампании ID для привязки, и можно добавить подключение.

Как расход попадает на клик

  1. Крон aggregator_cron.php (установщик ставит его раз в 15 минут) проходит по подключениям, у которых подошёл интервал обновления. При каждом проходе перечитываются последние 5 дней, при первом — 30: кабинеты задним числом уточняют расход, а текущий день растёт до полуночи.
  2. Записи складываются в cost_records с обновлением по (connection_id, external_id). Повторная синхронизация того же дня безопасна: расход пересчитывается, а не накапливается.
  3. Для каждой записи ищутся клики того же дня, от точного уровня к общему:
    1. ad_id (также creative_id, creative);
    2. adset_id / adgroup_id (также adgroup, adgroupid, ad_group_id);
    3. campaign_id (также campaign, campaignid, ad_campaign_id).
  1. Расход дня делится поровну между найденными кликами.
  2. Расход конвертируется в валюту трекера (курсы 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_differID в кликах и в отчёте кабинета не совпадают; показываются оба

В карточке клика раздел «Параметры» показывает все пойманные параметры, 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 можно вставить вручную через запятую.

Ключи для 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 объявления (нераскрытый макрос считается пропуском), с кнопкой «Исправить» в редактор источника.

← Назад
Постбеки и конверсии
Вперёд →
Push и pop сети
Исходник на 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 и управляйте кампаниями обычными словами.

Читать гайд →