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

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

Вкладка «Креативы» в Галерее контента отвечает на один вопрос: какие креативы реально зарабатывают. Она вырастает из существующей галереи: файлы, синхронизированные с площадок (картинки и видео Facebook, обложки TikTok), лежат рядом с вашими загрузками, у каждого креатива — расход/доход/ROI, а вручную загруженная заготовка получает метрики в тот момент, когда объявление начинает её крутить.

Как попадают данные

Ничего не настраивается руками. Цепочка:

  1. Синк расхода (крон агрегатора или «Синхронизировать») тянет строки расхода из Facebook/TikTok. Каждая строка теперь несёт имена ad/adset/кампании и счётчики площадки (показы/клики — cost_records.impressions, platform_clicks) и апсертит их в ad_entities.
  2. Метаданные креативов (core/CreativeSync.php, троттл — один проход в 3 часа на подключение) спрашивает площадку, что в этих объявлениях: хэш картинки / id видео / текст объявления. Связки — в creative_usages, задачи на скачивание — в creative_fetch_queue.
  3. Воркер файлов (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. Дневной агрегат (core/CreativeStats.php::rebuildWindow) пересобирает creative_daily после каждого синка расхода: расход (с комиссией агентства), показы, клики площадки, клики/визиты трекера, инстоллы, реги, FTD и доход — трекерные метрики ложатся в дни таймзоны кабинета через индексированную колонку clicks.ad_ref.

Воркер проверяет загрузки по сигнатуре (mp4 ftyp / webm EBML для видео, getimagesize для картинок), держит лимиты объёма (10 МБ картинки, 100 МБ видео) обрывом передачи, ходит через прокси подключения. Баннер на вкладке скажет, если файлы в очереди, а воркер не запускался.

Вкладка

Где креативы ещё всплывают

Баннер «доход не привязан»

Баннер над отчётом («К объявлениям привязан 62% дохода») считает action=revenue_attribution_health: доход считается привязанным, когда хоть один ad-параметр клика несёт настоящий id площадки — нераскрытый макрос __CID__ / {{ad.id}} считается пропуском, тем же правилом, что диагностика импорта расхода. Кнопка «Исправить» открывает редактор источника с подсвеченной вкладкой параметров.

Заметки

← Назад
Галерея контента
Вперёд →
Внешние PWA и Telegram-каналы
Исходник на GitHub: github.com/fenjo26/Orbitra.link/wiki
Все гайды
Документация

Быстрый старт: первая кампания

Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.

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

Установка и обновление

Установите Orbitra на чистый сервер Ubuntu или Debian одной командой и безопасно обновляйтесь до новых версий.

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

Миграция из Keitaro

Перенесите кампании, офферы, источники и домены из Keitaro в Orbitra в один клик — что переносится и что проверить.

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

Миграция из Binom

Перенесите кампании и потоки из Binom в Orbitra: что переносится автоматически, а что настроить вручную.

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

Возможности Orbitra

Всё, что умеет Orbitra: кампании и потоки, клоакинг, лендинги, PWA, постбеки, расходы, отчёты и интеграции.

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

Кампании и потоки

Полный справочник: настройки кампаний, типы потоков, схемы, ротация, фильтры, тестовые ссылки и каждый параметр.

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

Клоакинг

Полный справочник по клоакингу: уровни детекции, глобальные настройки, фильтры потоков, вердикты и отчёты.

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

Проверка браузера

Как JS-проверка ловит ботов, виртуальные машины и эмуляторы через противоречия в окружении браузера.

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

Лендинги

Типы лендингов, макрос {offer}, JS-адаптер, LeadForge и мульти-оффер лендинги — полный справочник.

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

PWA-лендинги и Web Push

Собирайте устанавливаемые PWA-приложения и собирайте push-подписчиков: настройки, иконки, события и уведомления.

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

PWA-воронка

Многошаговая PWA-воронка: приглашения к установке, отслеживание событий и возвратные уведомления.

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

Конверсионные попапы

Показывайте реальные конверсии как попапы на странице: настройка, триггеры и размещение.

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

Записи сессий и карта кликов

Воспроизводите реальные визиты, смотрите карты кликов и скроллов. Лимиты хранения и приватность.

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

Галерея контента

Центральное хранилище иконок, скриншотов и креативов для PWA и лендингов.

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

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

Храните креативы с отслеживанием по subid и тестируйте их в разных кампаниях.

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

Внешние PWA и Telegram-каналы

Публикуйте PWA на внешних доменах и используйте Telegram-каналы как источник трафика.

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

Постбеки и конверсии

Входящие постбеки, статусы и типы конверсий, исходящие S2S-постбеки в источник трафика.

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

Расходы: импорт из рекламных кабинетов

Импорт расходов из Facebook, TikTok и Google Ads, обновление через API и крон — и как работает агрегатор доходов.

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

Push и pop сети

Работа с пуш и поп источниками трафика: фиды, оптимизация зон и zone killer.

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

Facebook / Meta integration

Импорт расходов из Meta Ads и Conversions API: серверные события с дедупликацией.

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

Dolphin / Fbtool — приём расходов (Keitaro Admin API)

Получайте расходы Facebook через API Dolphin (Fbtool) в реальном времени.

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

Чистилка комментариев FB

Массовая модерация комментариев под рекламой Meta: скрывать, удалять и фильтровать по ключевым словам.

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

Источники трафика и партнёрские сети

Каталог 50+ источников трафика и 440+ сетей: шаблоны, параметры и адреса постбеков.

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

Отчёты, логи и метрики

Конструктор отчётов, сохранённые отчёты, логи кликов и каждая метрика с пояснением.

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

Домены и SSL

Добавление доменов, DNS, бесплатные сертификаты Let's Encrypt, редиректы, парковка и каждый переключатель на странице.

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

Cloudflare — DNS и SSL доменов

Как запускать домены кампаний через Cloudflare: DNS, режимы SSL и что отключить.

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

Администрирование

Пользователи, роли и права, настройки безопасности, гео-базы, обновления и состояние системы.

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

Telegram-бот

Управляйте трекером из Telegram: статистика, конверсии и алерты в чате.

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

MCP-сервер: работа с трекером через нейросеть

Подключите Claude или любой MCP-клиент к Orbitra и управляйте кампаниями обычными словами.

Читать гайд →