Витрати
Orbitra тягне поденні витрати з рекламних кабінетів і розподіляє їх по кліках, тож ROI та прибуток у звітах рахуються з реальних грошей, а не з ручної ціни за клік.
З'єднання — у ⚙ → Integrations, у групі рекламних мереж: Facebook Costs, TikTok Costs, Google Ads Costs. Вкладка Integrations редактора кампанії показує, чи несуть кліки кампанії ID для матчингу, і дозволяє додати з'єднання.
Як витрати лягають на клік
- Cron
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»
Кнопка Refresh costs на з'єднанні показує конкретну причину:
| Код | Значення |
|---|---|
no_spend | записи прийшли, але витрати в них нульові |
no_clicks | у Orbitra немає кліків у ті дні |
no_ids | кліки не несуть ID оголошення, групи чи кампанії — посилання не веде прямо на кампанію Orbitra або параметри губляться по дорозі |
macros | кліки містять незамінені макроси типу __CID__ — джерело не підставило значень |
ids_differ | ID у кліках і у звіті рекламного кабінету не збігаються; показано обидва |
У картці кліка секція «Parameters» показує всі захоплені параметри, спершу 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 (Sign in with TikTok) | App ID і App Secret вашого власного застосунку TikTok for Business: змінні середовища ORBITRA_TIKTOK_APP_ID / ORBITRA_TIKTOK_APP_SECRET або поля ручного з'єднання. Знаходить рекламні кабінети та піксели, імпортує піксели в Pixel Vault |
| Manual | Токен Marketing API з безкоштовного девелоперського застосунку (Developer Portal → Apps & Agents → права Direct Advertiser, Ads Management і Reporting) + Advertiser ID |
Токен Events Manager не працює для імпорту витрат — він лише шле події конверсій. Якщо список рекламних кабінетів не читається через MCP, можна вставити Advertiser ID вручну, через кому.
Google Ads
- 1-Click (Sign in with Google) — знаходить прямі кабінети та дочірні кабінети MCC, створюючи з'єднання для кожного обраного. Потрібні Developer Token (з MCC) і OAuth Client ID + Secret (Google Cloud Console, тип «Web application», redirect URI
https://your-domain/api.php?action=google_ads_oauth_callback). - Manual — 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 — імпортуються тим самим cron і лягають на кліки по кампаніях, а де мережа звітує — і по зонах (сайтах). Zone Killer, який блокує зони, що палять гроші, працює з цих даних. Дивіться Push & pop networks.
Dolphin і Fbtool
Ці сервіси вміють слати витрати лише в Keitaro через її Admin API. Orbitra приймає той самий запит на POST /admin_api/v1/campaigns/<ID>/update_costs. Деталі — у розділі Dolphin / Fbtool.
Ручні витрати
Кнопка Refresh costs у меню кампанії виставляє витрати за період вручну (action update_costs).
Агрегатор доходу
⚙ → Revenue Aggregator — обернена задача: тягнути дохід з кабінетів партнерських програм, які не шлють постбеки. Двигуни: ReferOn, Affilka, Generic API. Для кожного з'єднання ви задаєте мережу, тип угоди, інтервал синку і назву параметра, в якому партнерська програма зберігає ID кліка Orbitra. Доходи і журнали синків — на вкладках тієї самої сторінки.
Агентства і комісія
Орендовані рекламні кабінети коштують дорожче, ніж звітує сам кабінет: відсоток агентства записується в кожен імпорт (cost_records.fee_amount; clicks.cost несе витрати з комісією, clicks.fee — частку комісії), тож ROI/CPC чесні з того ж моменту, коли витрати лягли, а зміна відсотка пізніше ніколи не переписує історію.
- Вкладка Agencies секції агрегатора керує агентствами (назва, відсоток комісії, контакти, умови оплати, нотатки) і порівнює їх за витратами, CPC, CPM і ROI за період.
- Кожне з'єднання витрат обирає своє агентство в редакторі.
- Звіти отримують колонки Spend (cabinet) і Agency fee; кожне групування розбиває обидві.
Назви оголошень, статуси, платформені метрики
Синк витрат збирає ще й те, що платформа знає про самі оголошення: назви та статуси — у ad_entities (статуси освіжаються щогодини, у тому самому проході cron), покази й власні лічильники кліків платформи — на рядки витрат. У звітах кампаній з групуванням за ad / adset / campaign ви отримуєте назви замість голих id, чіп статусу і платформені колонки: Impressions, Clicks (platform), CPM, CTR (platform) та Click loss = 1 − відвідувачі трекера / кліки платформи — число, яке миттю викриває проблему клоакинга чи домену, чого немає в adset.pro.
Верхній банер у звітах показує частку доходу, яку не вдається прив'язати до id оголошення (незамінений макрос __CID__ / {{ad.id}} рахується відсутнім), і стрибає в редактор винного джерела.
Cron
*/15 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/www/orbitra/var/logs/aggregator.log 2>&1
Інтервал перевіряється по кожному з'єднанню, тож частий cron дешевий; для інтервалів менших за 15 хвилин запускайте його частіше. Прапорці: --force (ігнорувати інтервал), --connection=5, --days=30.
Швидкий старт: ваша перша кампанія
Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.
Читати гайд →ДокументаціяВстановлення та оновлення
Встановіть 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 й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →