Бібліотека креативів
Вкладка Creatives Галереї контенту відповідає на одне питання: які креативи реально заробляють. Вона виростає з наявної галереї — файли, синхронізовані з платформ (зображення та відео Facebook, обкладинки TikTok), живуть поруч із вашими власними завантаженнями, кожен креатив несе spend/revenue/ROI, а чернетка, яку ви завантажили вручну, підхоплює метрики того ж моменту, коли реклама починає її крутити.
Як приходять дані
Нічого не налаштовується руками. Ланцюжок такий:
- Cost sync (aggregator cron або Sync now) тягне рядки витрат із Facebook/TikTok. Кожен рядок тепер несе ще назви ad/adset/campaign і власні лічильники показів/кліків платформи (
cost_records.impressions,cost_records.platform_clicks) та апсертить їх уad_entities. - Creative metadata pass (
core/CreativeSync.php, не частіше одного проходу на 3 години на з'єднання) питає в платформи, що містять ті оголошення: хеш зображення / id відео / текст оголошення креатива. Прив'язки лягають уcreative_usages, задачі скачування — уcreative_fetch_queue. - 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 — це і є ланка «чернетка вийшла в ротацію»: ваша вручну завантажена чернетка прив'язується до копії платформи замість того, щоб плодити дублікат. - Daily aggregate (
core/CreativeStats.php::rebuildWindow) перебудовуєcreative_dailyпісля кожного cost sync: spend (з агентською комісією), покази, кліки платформи, кліки/відвідувачі трекера, інстали, реєстрації, FTD і дохід — метрики трекера розкладаються по днях у таймзоні самого рекламного кабінету через індексовану колонкуclicks.ad_ref.
Воркер валідує скачування за сигнатурою (mp4 ftyp / webm EBML для відео, getimagesize для зображень), тримає ліміти розміру (10 MB зображення, 100 MB відео), обриваючи передачу на середині потоку, і ходить через проксі з'єднання. Банер у вкладці підкаже, коли файли в черзі, а воркер ще не запускався.
Вкладка
- Фільтри: період (типово останні 7 днів), платформа, формат, тег, пошук, active only (креативи, чиї оголошення ще крутяться), сортування за spend/revenue/ROI/кліками.
- Картки KPI по унікальних асетах — карусель із 3 зображень це один креатив, і його витрати за день діляться порівну на три файли.
- ROI без доходу — тире, а не −100%: креатив, який просто ще не конвертив, — не згорілий. Кольори: зелений ≥ 30%, жовтий 0–30%, червоний нижче нуля.
- Картка креатива: поденні ряди (стовпчики spend, позначки ROI), оголошення, які його крутили, зі статусами та витратами (розгортання Cabinet › Campaign › Adset), текст оголошення, сім'я майже-дублікатів, ваші теги, скачування.
- Теги вільної форми (
offer, geo, approach, creator) — звіт за тегом відповідає на питання «який підхід працює краще».
Де креативи ще з'являються
- Звіти кампаній отримують групування Creative (назва файлу замість голого id оголошення) і превью-мініатюру на рядках оголошень.
- Редактор кампанії отримав вкладку Creatives: що гнало трафік у цю кампанію за останні 7 днів, з ROI по всьому трекеру.
- Денний дайджест у Telegram перелічує топ-3 і найгірші-3 креативи дня та стріляє алертом burnout, коли ROI або платформенний CTR впали сильніше за поріг (типово −50%) за останні 7 днів проти попередніх семи, при витратах вище мінімуму (типово $50). Пороги: налаштування
telegram_creative_burnout_drop_pct,telegram_creative_burnout_min_spend. - Розширення Ads Manager показує CREATIVE ROI (за весь час) поруч із поденними колонками оголошення.
- MCP:
orbitra_creatives_top,orbitra_creative_detail. - Асети, синхронізовані з платформ, доступні в MediaPicker для постерів PWA/лендингів, як і будь-який інший файл.
Банер здоров'я атрибуції
Верхній банер звіту («Revenue linked to ads: 62%») походить з action=revenue_attribution_health: дохід рахується прив'язаним, коли хоч один параметр кліка рівня оголошення несе справжній id платформи — незамінений макрос __CID__ / {{ad.id}} рахується відсутнім, те саме правило, яким користуються діагностики імпортера витрат. Кнопка Fix стрибає в редактор винного джерела з підсвіченою вкладкою параметрів.
Нотатки
- Відеофайли TikTok не скачуються (API потребує окремих прав на асети); обкладинка зберігається, і креатив усе одно несе повні метрики.
- Задачі другої черги (екстракція тексту ШІ, авто-теги) свідомо ще не зроблені.
Швидкий старт: ваша перша кампанія
Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.
Читати гайд →ДокументаціяВстановлення та оновлення
Встановіть 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 й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →