Push- і pop-мережі
Імпорт витрат від рекламних мереж push і pop трафіку, плюс Zone Killer — правила, які знаходять (а якщо ви дозволите — блокують) зони, що палять гроші. Все живе в одному місці: картка Push/Pop networks у ⚙ → Integrations, у групі рекламних мереж поруч із витратами Facebook / TikTok / Google.
Мережі
| Мережа | Рівень витрат | API-ключ |
|---|---|---|
| AdMaven | кампанія × зона | Рекламний кабінет → розділ API → API token |
| PropellerAds | кампанія × зона | SSP → Profile → API token |
| Kadam | кампанія × зона | Кабінет рекламодавця → розділ API → API token |
| Galaxion | кампанія × зона | E-mail + пароль кабінету (трекер добуде токен сам), або готовий API token |
| HilltopAds | лише кампанія | My Account → вкладка API → API key |
| Adsterra | лише кампанія | Settings → вкладка API → Generate new token (працює лише найновіший токен) |
| Clickadu | лише кампанія | Кабінет рекламодавця → розділ API → API key |
Мережі з позначкою лише кампанія мають розбивку по зонах в API, але її рядки не несуть id кампанії — зону там не прив'язати до кампанії, чий трафік вона купила. Їхні витрати розмазуються по кліках кампанії, і картка з'єднання попереджає про це ще до підключення.
Підключення
Оберіть плитку мережі, вставте ключ, натисніть Check connection — вона покаже реальний баланс кабінету — потім збережіть. У кожного з'єднання свій інтервал оновлення; кнопки в списку: Update spend (зараз), пауза, редагування, видалення. Вже імпортовані витрати лишаються у звітах після видалення.
Синк бігає в тому самому проході aggregator_cron.php, що й інші з'єднання витрат (дивіться Витрати): кожен прохід перечитує останні 5 днів, перший — 30. Повторний синк дня безпечний — витрати перераховуються, а не накопичуються.
Як витрати лягають на клік
Головна вимога та сама, що й для Facebook чи TikTok: кампанія має використовувати шаблон джерела трафіку цієї мережі, тож посилання передає id кампанії мережі (у ad_campaign_id) і id зони (шаблони джерел Keitaro пишуть його в source, вбудований шаблон PropellerAds — у zone). Без макроса зони витрати все одно ляжуть — але лише по кампанії, ніколи без розбивки по зонах.
Матчинг, від найточнішого рівня до найширшого:
- campaign × zone — рядок зони атрибуціюється лише клікам того самого дня, що несуть і id зони, і id кампанії мережі. Голого id зони мало: id зон не унікальні між мережами.
- campaign — рядок зони, чия зона не зматчила жодного кліка, сумується на кліки кампанії без зони (він ніколи не залізає на кліки, вже оцінені власними рядками зон — кілька незматчених зон додаються, а не перезаписують одна одну).
Ключі параметрів кліка, які рахуються «зоною»: zone, zone_id, zoneid, sub_source_id.
Якщо синк відповідає «записи отримано, але жоден не прикріплився до кліків», найімовірніше кампанія не використовує шаблон джерела цієї мережі — посилання не приносить id кампанії для матчингу. Діагностика «Отримано N, зматчено 0» з розділу Витрати застосовна й тут.
Zone Killer
Картка на вкладці General редактора кампанії (кампанію треба спершу зберегти). Правило прив'язує кампанію до одного з'єднання витрат push/pop і визначає, які зони стають кандидатами:
- window — на скільки днів назад судити (витрати і конверсії сумуються по зонах за вікно);
- min spend — зона, що витратила менше, не варта дотику;
- zero conversions та/або max ROI — умови вбивства;
- mode —
dry_run(типово) абоautoз лімітом блокувань на прохід.
Кандидати рахуються з clicks.cost / clicks.revenue по зонах — ті самі розподілені числа, що показують звіти, з тими самими ключами зон, за якими матчився імпорт витрат, тож правило ніколи не судить зону, яку імпортер оцінив інакше.
- Dry-run перелічує кандидатів; ви обираєте і тиснете Block selected.
- Auto дозволяє
zone_rules_cron.phpвиконати кандидатів самостійно (з лімітом на прохід) і шле сповіщення в Telegram про те, що він заблокував.
Блокування йде через write API мережі для AdMaven, HilltopAds, PropellerAds, Kadam і Galaxion. У Adsterra і Clickadu придатного write API по зонах немає: їхні правила лишаються dry-run, а картка копіює id обраних зон, щоб ви вручну вставили їх у блеклист мережі.
Кожне блокування і розблокування — ручне чи автоматичне — лягає в append-only журнал з метриками, що стояли за рішенням; поточний заблокований набір — це зона, чиє останнє успішне дія — «block». Журнал рендериться під правилом.
Для мереж лише кампанія (HilltopAds, Adsterra, Clickadu) Zone Killer судить зони приблизно — за їхньою часткою кліків кампанії, бо API не дає витрат по зонах. Тримайте їхні правила в dry-run і перевіряйте список перед блокуванням.
Cron
*/15 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/www/orbitra/var/logs/aggregator.log 2>&1
*/30 * * * * php /var/www/orbitra/zone_rules_cron.php >> /var/www/orbitra/var/logs/zone_rules.log 2>&1
Перший рядок — cron, який інсталятор додає для синку витрат. Другий — виконавець Zone Killer — його додаєте ви самі, і лише якщо користуєтесь правилами auto; прохід дешевий (правило без кандидатів — один GROUP BY по кліках кампанії). Прапорці: --campaign=12 (одна кампанія), --quiet.
Швидкий старт: ваша перша кампанія
Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.
Читати гайд →ДокументаціяВстановлення та оновлення
Встановіть 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 й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →