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

Витрати

Orbitra тягне поденні витрати з рекламних кабінетів і розподіляє їх по кліках, тож ROI та прибуток у звітах рахуються з реальних грошей, а не з ручної ціни за клік.

З'єднання — у ⚙ → Integrations, у групі рекламних мереж: Facebook Costs, TikTok Costs, Google Ads Costs. Вкладка Integrations редактора кампанії показує, чи несуть кліки кампанії ID для матчингу, і дозволяє додати з'єднання.

Як витрати лягають на клік

  1. Cron 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»

Кнопка Refresh costs на з'єднанні показує конкретну причину:

КодЗначення
no_spendзаписи прийшли, але витрати в них нульові
no_clicksу Orbitra немає кліків у ті дні
no_idsкліки не несуть ID оголошення, групи чи кампанії — посилання не веде прямо на кампанію Orbitra або параметри губляться по дорозі
macrosкліки містять незамінені макроси типу __CID__ — джерело не підставило значень
ids_differID у кліках і у звіті рекламного кабінету не збігаються; показано обидва

У картці кліка секція «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 вручну, через кому.

Ключі для 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 чесні з того ж моменту, коли витрати лягли, а зміна відсотка пізніше ніколи не переписує історію.

Назви оголошень, статуси, платформені метрики

Синк витрат збирає ще й те, що платформа знає про самі оголошення: назви та статуси — у 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.

← Попередній
Постбеки та конверсії
Наступний →
Push- і pop-мережі
Переглянути джерело на GitHub: github.com/fenjo26/Orbitra.link/wiki
Усі гайди
Документація

Швидкий старт: ваша перша кампанія

Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.

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

Встановлення та оновлення

Встановіть 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 й керуйте кампаніями, офферами та доменами звичайними словами.

Читати гайд →