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

Бібліотека креативів

Вкладка Creatives Галереї контенту відповідає на одне питання: які креативи реально заробляють. Вона виростає з наявної галереї — файли, синхронізовані з платформ (зображення та відео Facebook, обкладинки TikTok), живуть поруч із вашими власними завантаженнями, кожен креатив несе spend/revenue/ROI, а чернетка, яку ви завантажили вручну, підхоплює метрики того ж моменту, коли реклама починає її крутити.

Як приходять дані

Нічого не налаштовується руками. Ланцюжок такий:

  1. Cost sync (aggregator cron або Sync now) тягне рядки витрат із Facebook/TikTok. Кожен рядок тепер несе ще назви ad/adset/campaign і власні лічильники показів/кліків платформи (cost_records.impressions, cost_records.platform_clicks) та апсертить їх у ad_entities.
  2. Creative metadata pass (core/CreativeSync.php, не частіше одного проходу на 3 години на з'єднання) питає в платформи, що містять ті оголошення: хеш зображення / id відео / текст оголошення креатива. Прив'язки лягають у creative_usages, задачі скачування — у creative_fetch_queue.
  3. File worker (cli/creative_fetch_cron.php, у розклад його ставить install.sh кожні 5 хвилин) скачує самі файли: оригінали з Facebook (/act_X/adimages за хешем, джерело відео + обкладинка), обкладинки та превью з TikTok (/file/video/ad/info/, /file/image/ad/info/). Дедуплікація точна, за sha256; майже-дублікати матчаться за 64-бітним dHash із порогом Хеммінга ≤6 — це і є ланка «чернетка вийшла в ротацію»: ваша вручну завантажена чернетка прив'язується до копії платформи замість того, щоб плодити дублікат.
  4. Daily aggregate (core/CreativeStats.php::rebuildWindow) перебудовує creative_daily після кожного cost sync: spend (з агентською комісією), покази, кліки платформи, кліки/відвідувачі трекера, інстали, реєстрації, FTD і дохід — метрики трекера розкладаються по днях у таймзоні самого рекламного кабінету через індексовану колонку clicks.ad_ref.

Воркер валідує скачування за сигнатурою (mp4 ftyp / webm EBML для відео, getimagesize для зображень), тримає ліміти розміру (10 MB зображення, 100 MB відео), обриваючи передачу на середині потоку, і ходить через проксі з'єднання. Банер у вкладці підкаже, коли файли в черзі, а воркер ще не запускався.

Вкладка

Де креативи ще з'являються

Банер здоров'я атрибуції

Верхній банер звіту («Revenue linked to ads: 62%») походить з action=revenue_attribution_health: дохід рахується прив'язаним, коли хоч один параметр кліка рівня оголошення несе справжній id платформи — незамінений макрос __CID__ / {{ad.id}} рахується відсутнім, те саме правило, яким користуються діагностики імпортера витрат. Кнопка Fix стрибає в редактор винного джерела з підсвіченою вкладкою параметрів.

Нотатки

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

Читати гайд →