Creatives library
The Creatives tab of the Content Gallery answers one question: which creatives actually earn. It grows out of the existing gallery β platform-synced files (Facebook images and videos, TikTok covers) live side by side with your own uploads, every creative carries spend/revenue/ROI, and a draft you uploaded manually picks up metrics the moment an ad starts running it.
How the data arrives
Nothing is configured by hand. The chain is:
- Cost sync (aggregator cron or Sync now) pulls spend rows from Facebook/TikTok. Every row now also carries the ad/adset/campaign names and the platform's own impressions/clicks counters (
cost_records.impressions,cost_records.platform_clicks), and upserts them intoad_entities. - Creative metadata pass (
core/CreativeSync.php, throttled to one pass per 3 hours per connection) asks the platform what those ads contain: the creative's image hash / video id / ad text. Bindings land increative_usages, download tasks increative_fetch_queue. - File worker (
cli/creative_fetch_cron.php, scheduled by install.sh every 5 minutes) downloads the actual files: originals from Facebook (/act_X/adimagesby hash, video source + cover), covers and previews from TikTok (/file/video/ad/info/,/file/image/ad/info/). Dedup is exact by sha256; near-duplicates are matched by a 64-bit dHash with a Hamming threshold of β€6 β that is the "draft went live" link: your manually uploaded draft is bound to the platform's copy instead of spawning a duplicate. - Daily aggregate (
core/CreativeStats.php::rebuildWindow) rebuildscreative_dailyafter every cost sync: spend (with the agency fee), impressions, platform clicks, tracker clicks/visitors, installs, registrations, FTD and revenue β tracker metrics bucketed into the ad account's own timezone days via the indexedclicks.ad_refcolumn.
The worker validates downloads by signature (mp4 ftyp / webm EBML for video, getimagesize for images), enforces size caps (10 MB images, 100 MB video) by aborting the transfer mid-stream, and goes through the connection's proxy. A banner in the tab tells you when files are queued but the worker has not run.
The tab
- Filters: period (default last 7 days), platform, format, tag, search, active only (creatives whose ads still run), sorting by spend/revenue/ROI/clicks.
- KPI cards over unique assets β a 3-image carousel is one creative, its day's spend split equally across the three files.
- ROI without revenue is a dash, never β100%: a creative that simply hasn't converted yet is not a burned one. Colors: green β₯ 30%, amber 0β30%, red below zero.
- Creative card: per-day series (spend bars, ROI marks), the ads that ran it with statuses and spend (the Cabinet βΊ Campaign βΊ Adset drill), the ad text, the near-duplicate family, your tags, download.
- Tags are free-form (
offer, geo, approach, creator) β the report by tag answers "which approach works better".
Where creatives surface elsewhere
- Campaign reports gain a Creative grouping (the file name instead of a bare ad id) and a preview thumbnail on ad rows.
- Campaign editor has a Creatives tab: what carried traffic into this campaign over the last 7 days, with tracker-wide ROI.
- Telegram daily digest lists the day's top-3 and worst-3 creatives and fires a burnout alert when ROI or platform CTR fell harder than the threshold (default β50%) over the last 7 days vs the 7 before, on spend above the minimum (default $50). Thresholds: settings
telegram_creative_burnout_drop_pct,telegram_creative_burnout_min_spend. - Ads Manager extension shows CREATIVE ROI (lifetime) next to an ad's day columns.
- MCP:
orbitra_creatives_top,orbitra_creative_detail. - Platform-synced assets are available in the MediaPicker for PWA/landing posters like any other file.
Attribution health banner
The report's top banner ("Revenue linked to ads: 62%") comes from action=revenue_attribution_health: revenue counts as linked when any ad-level click parameter carries a real platform id β an unreplaced __CID__ / {{ad.id}} macro counts as missing, same rule the cost importer's diagnostics use. The Fix button jumps into the offending source's editor with the parameters tab highlighted.
Notes
- TikTok video files are not downloaded (the API needs separate asset rights); the cover is stored and the creative still carries full metrics.
- Second-queue items (AI text extraction, auto-tags) are intentionally not built yet.
Quick start: your first campaign
The short path: install the tracker, create a campaign, and get your first clicks and conversions in under an hour.
Read guide βDocsInstallation and updates
Install Orbitra on a fresh Ubuntu or Debian server with one command, and update to new versions safely.
Read guide βDocsMigrating from Keitaro
Move campaigns, offers, sources and domains from Keitaro to Orbitra in one click β what transfers and what to check.
Read guide βDocsMigrating from Binom
Move campaigns and streams from Binom to Orbitra: what transfers automatically and what to set up by hand.
Read guide βDocsFeature overview
Everything Orbitra can do: campaigns and streams, cloaking, landings, PWA, postbacks, costs, reports and integrations.
Read guide βDocsCampaigns and streams
The complete reference: campaign settings, stream types, schemas, rotation, filters, test links and every option explained.
Read guide βDocsCloaking
Full cloaking reference: detection layers, global settings, per-stream filters, verdicts and reports.
Read guide βDocsBrowser check
How the JS check catches bots, VMs and emulators through contradictions in the browser environment.
Read guide βDocsLanding pages
Landing types, the {offer} macro, the JS adapter, LeadForge and multi-offer landings β the complete reference.
Read guide βDocsPWA and Web Push
Build installable PWA apps and collect push subscribers: settings, icons, events and notifications.
Read guide βDocsPWA Funnel
A multi-step PWA funnel: install prompts, event tracking and re-engagement notifications.
Read guide βDocsConversion popups
Show real conversion events as on-page popups: setup, triggers and placement.
Read guide βDocsSession recordings and heatmaps
Replay real visits and see click and scroll maps. Storage limits and privacy notes.
Read guide βDocsContent gallery
Central storage for icons, screenshots and creatives used across PWAs and landings.
Read guide βDocsCreatives library
Store creatives with subid tracking and test them across campaigns.
Read guide βDocsExternal PWA and Telegram channels
Publish PWAs to external domains and run Telegram channels as a traffic source.
Read guide βDocsPostbacks and conversions
Incoming postbacks, conversion statuses and types, and outgoing S2S postbacks to your traffic source.
Read guide βDocsCosts
Import spend from Facebook, TikTok and Google Ads, or update it via API and cron β and how the revenue aggregator works.
Read guide βDocsPush and pop networks
Working with push and pop traffic sources: feeds, zone optimization and the zone killer.
Read guide βDocsFacebook / Meta
Cost import from Meta Ads and the Conversions API: server-side events with deduplication.
Read guide βDocsDolphin / Fbtool
Receive Facebook costs through the Dolphin (Fbtool) API in real time.
Read guide βDocsFB comment cleaner
Bulk-moderate comments under Meta ads: hide, delete and filter by keywords.
Read guide βDocsTraffic sources and affiliate networks
Catalog of 50+ traffic sources and 440+ networks: templates, parameters and postback URLs.
Read guide βDocsReports, logs and metrics
The report builder, saved reports, click logs and every metric explained.
Read guide βDocsDomains and SSL
Add domains, DNS, free Let's Encrypt certificates, redirects, parking and every switch on the page.
Read guide βDocsCloudflare
How to run campaign domains through Cloudflare: DNS, SSL modes and what to turn off.
Read guide βDocsAdministration
Users, roles and permissions, security settings, geo databases, updates and system health.
Read guide βDocsTelegram bot
Manage the tracker from Telegram: stats, conversions and alerts in chat.
Read guide βDocsMCP: an AI assistant in the tracker
Connect Claude or any MCP client to Orbitra and manage campaigns with plain-language commands.
Read guide β