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

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). Без макроса зони витрати все одно ляжуть — але лише по кампанії, ніколи без розбивки по зонах.

Матчинг, від найточнішого рівня до найширшого:

  1. campaign × zone — рядок зони атрибуціюється лише клікам того самого дня, що несуть і id зони, і id кампанії мережі. Голого id зони мало: id зон не унікальні між мережами.
  2. campaign — рядок зони, чия зона не зматчила жодного кліка, сумується на кліки кампанії без зони (він ніколи не залізає на кліки, вже оцінені власними рядками зон — кілька незматчених зон додаються, а не перезаписують одна одну).

Ключі параметрів кліка, які рахуються «зоною»: zone, zone_id, zoneid, sub_source_id.

Якщо синк відповідає «записи отримано, але жоден не прикріплився до кліків», найімовірніше кампанія не використовує шаблон джерела цієї мережі — посилання не приносить id кампанії для матчингу. Діагностика «Отримано N, зматчено 0» з розділу Витрати застосовна й тут.

Zone Killer

Картка на вкладці General редактора кампанії (кампанію треба спершу зберегти). Правило прив'язує кампанію до одного з'єднання витрат push/pop і визначає, які зони стають кандидатами:

Кандидати рахуються з clicks.cost / clicks.revenue по зонах — ті самі розподілені числа, що показують звіти, з тими самими ключами зон, за якими матчився імпорт витрат, тож правило ніколи не судить зону, яку імпортер оцінив інакше.

Блокування йде через 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.

← Попередній
Витрати
Наступний →
Facebook / Meta
Переглянути джерело на 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 й керуйте кампаніями, офферами та доменами звичайними словами.

Читати гайд →