Creatives-Bibliothek
Der Creatives-Reiter der Content Gallery beantwortet eine Frage: welche Creatives wirklich verdienen. Er wächst aus der bestehenden Gallery heraus — plattform-synchronisierte Dateien (Facebook-Bilder und -Videos, TikTok-Cover) liegen nebeneinander mit deinen eigenen Uploads, jedes Creative trägt Spend/Revenue/ROI, und ein manuell hochgeladener Entwurf kriegt seine Metriken in dem Moment, in dem eine Anzeige anfängt, ihn zu fahren.
Wie die Daten ankommen
Nichts wird von Hand konfiguriert. Die Kette ist:
- Cost sync (Aggregator-Cron oder Sync now) zieht Spend-Zeilen aus Facebook/TikTok. Jede Zeile trägt jetzt auch die Ad-/Adset-/Campaign-Namen und die eigenen Impressions-/Clicks-Zähler der Plattform (
cost_records.impressions,cost_records.platform_clicks) und upsertet sie inad_entities. - Creative-Metadaten-Pass (
core/CreativeSync.php, gedrosselt auf einen Pass pro 3 Stunden pro Connection) fragt die Plattform ab, was diese Ads enthalten: den Image-Hash / die Video-ID / den Anzeigentext des Creatives. Bindings landen increative_usages, Download-Tasks increative_fetch_queue. - File worker (
cli/creative_fetch_cron.php, von install.sh alle 5 Minuten eingeplant) lädt die echten Dateien herunter: Originale von Facebook (/act_X/adimagesper Hash, Video-Quelle + Cover), Covers und Previews von TikTok (/file/video/ad/info/,/file/image/ad/info/). Dedup ist exakt per sha256; Near-Duplicates werden über einen 64-Bit-dHash mit Hamming-Schwelle ≤6 gematcht — das ist die Verknüpfung „der Entwurf ist live gegangen": Dein manuell hochgeladener Entwurf wird an die Kopie der Plattform gebunden, statt ein Duplikat zu erzeugen. - Tägliches Aggregate (
core/CreativeStats.php::rebuildWindow) bautcreative_dailynach jedem Cost-Sync neu: Spend (mit der Agentur-Gebühr), Impressions, Plattform-Clicks, Tracker-Clicks/Visitors, Installs, Registrations, FTD und Revenue — Tracker-Metriken, eingesortiert in die Zeitzonen-Tage des Ad-Accounts über die indizierte Spalteclicks.ad_ref.
Der Worker validiert Downloads per Signatur (mp4 ftyp / webm EBML für Video, getimagesize für Bilder), setzt Größen-Limits durch (10 MB Bilder, 100 MB Video), indem er den Transfer im Fluss abbricht, und läuft über den Proxy der Connection. Ein Banner im Reiter sagt dir, wenn Dateien in der Queue stehen, der Worker aber nicht gelaufen ist.
Der Reiter
- Filters: Zeitraum (Standard: letzte 7 Tage), Plattform, Format, Tag, Suche, active only (Creatives, deren Ads noch laufen), Sortierung nach Spend/Revenue/ROI/Clicks.
- KPI cards über Unique Assets — ein 3-Bild-Karussell ist ein Creative, sein Tages-Spend wird gleichmäßig auf die drei Dateien verteilt.
- ROI ohne Revenue ist ein Strich, nie −100 %: Ein Creative, das schlicht noch nicht konvertiert hat, ist kein verbranntes. Farben: grün ≥ 30 %, gelb 0–30 %, rot unter null.
- Creative-Karte: Tages-Serien (Spend-Balken, ROI-Marken), die Ads, die es gefahren haben, mit Status und Spend (der Cabinet › Campaign › Adset-Drill), der Anzeigentext, die Near-Duplicate-Familie, deine Tags, Download.
- Tags sind freiformat (
offer, geo, approach, creator) — der Report nach Tag beantwortet „welcher Ansatz funktioniert besser".
Wo Creatives sonst auftauchen
- Kampagnen-Reports bekommen eine Creative-Gruppierung (der Dateiname statt einer nackten Ad-ID) und ein Preview-Thumbnail in Ad-Zeilen.
- Der Kampagnen-Editor hat einen Creatives-Reiter: was in den letzten 7 Tagen Traffic in diese Kampagne gebracht hat, mit tracker-weitem ROI.
- Der Telegram-Tages-Digest listet die Top-3- und die schlechtesten-3-Creatives des Tages und löst einen Burnout-Alert aus, wenn ROI oder Plattform-CTR härter gefallen ist als die Schwelle (Standard −50 %) über die letzten 7 Tage vs. die 7 davor, bei Spend über dem Minimum (Standard $50). Schwellen: Settings
telegram_creative_burnout_drop_pct,telegram_creative_burnout_min_spend. - Die Ads Manager extension zeigt CREATIVE ROI (lifetime) neben den Tages-Spalten einer Ad.
- MCP:
orbitra_creatives_top,orbitra_creative_detail. - Plattform-synchronisierte Assets stehen im MediaPicker für PWA-/Landing-Poster zur Verfügung wie jede andere Datei.
Attribution-Health-Banner
Das obere Banner des Reports („Revenue linked to ads: 62%") kommt aus action=revenue_attribution_health: Revenue gilt als verknüpft, wenn ein Ad-Level-Klick-Parameter eine echte Plattform-ID trägt — ein nicht ersetztes __CID__ / {{ad.id}}-Makro gilt als fehlend, dieselbe Regel wie in den Diagnosen des Kosten-Importers. Der Fix-Button springt in den Editor der betroffenen Quelle, mit hervorgehobenem Parameters-Reiter.
Hinweise
- TikTok-Videodateien werden nicht heruntergeladen (die API braucht separate Asset-Rechte); das Cover wird gespeichert, und das Creative trägt trotzdem die vollen Metriken.
- Second-Queue-Punkte (KI-Textextraktion, Auto-Tags) sind absichtlich noch nicht gebaut.
Schnellstart
Von einem nackten Server zur ersten Conversion in neun Schritten: Installation, erster Login, Domain, Netzwerk und Offer, Traffic-Quelle, Kampagne, Prüfung, Kosten.
Guide lesen →DocsInstallation und Updates
Systemvoraussetzungen, der Ein-Befehl-Installer, PHP-Updates inklusive Sicherheits-Hinweisen, Panel-Zugriff per IP und die lokale Entwicklungsumgebung.
Guide lesen →DocsMigration von Keitaro
Einstellungen per SQL-Dump von Keitaro zu Orbitra übertragen: was mitkommt, das Dump-Script, der Import und was du danach prüfen solltest.
Guide lesen →DocsMigration von Binom
Kampagnen, Offers, Streams und mehr direkt über die Binom-v2-Public-API importieren — ohne Dump-Datei, inklusive Mapping-Hinweisen.
Guide lesen →DocsFunktionen im Überblick
Alle Orbitra-Funktionen auf einen Blick: Traffic und Schemas, Postbacks und Kosten, Analytics, Infrastruktur und Verwaltung — mit Links auf die Detailseiten.
Guide lesen →DocsKampagnen und Streams
Der Kampagnen-Editor im Detail: Reiter, Kostenmodelle, Stream-Typen, alle Filter, Schemas, Rotation mit Auto-Optimierung, Test-Link und Duplikat-Schutz.
Guide lesen →DocsCloaking (Referenz)
Die vollständige Cloaking-Referenz: Detection layers, Sensitivity, Targeting filters, JavaScript-Verifizierung, Verdicts, Gründe und Diagnostik.
Guide lesen →DocsBrowser check
Bots, Moderator-VMs, Emulatoren und Anti-Detect-Browser an Widersprüchen im Browser selbst erkennen — Modi, Anzeichen und der sichere Einstieg.
Guide lesen →DocsLandingpages (Referenz)
Die vollständige Landingpage-Referenz: lokale, Redirect-, Preload- und Action-Landingpages, das {offer}-Makro, SubID-Weitergabe, JS-Adapter und PHP-Landings.
Guide lesen →DocsPWA und Web Push
PWA-Landingpages und eigenes Web Push: Builder, Domain-Bindung, VAPID-Keys, Abonnenten, Messages, der Versand-Cron, Attribution und Fehlerbehebung.
Guide lesen →DocsPWA Funnel
Der PWA-Besuch als konfigurierbarer Funnel: Screens in fester Reihenfolge, Event-Tracking pro Screen und Re-Engagement-Benachrichtigungen.
Guide lesen →DocsConversion-Popups
Echte Conversion-Events als Popup auf der Landing zeigen: Einrichtung pro Kampagne, Trigger und Platzierung.
Guide lesen →DocsSession-Aufzeichnungen und Heatmaps
Echte Besuche wie ein Video abspielen, dazu Klick-Heatmap und Scroll-Map. Speicher-Limits und Datenschutz-Hinweise.
Guide lesen →DocsContent Gallery
Die zentrale Mediathek des Trackers für Icons, Screenshots und Creatives, genutzt in PWAs und Landings: Ordner, Uploads, MediaPicker.
Guide lesen →DocsCreatives-Bibliothek
Creatives mit SubID-Tracking speichern und über Kampagnen hinweg testen.
Guide lesen →DocsExterne PWA und Telegram-Kanäle
PWAs auf externen Domains veröffentlichen und Telegram-Kanäle als Traffic-Quelle mit zuordenbaren Abonnenten fahren.
Guide lesen →DocsPostbacks und Conversions
Eingehende Postbacks, Conversion-Statuswerte und -Typen sowie ausgehende S2S-Postbacks an die Traffic-Quelle.
Guide lesen →DocsKosten
Spend aus Facebook, TikTok und Google Ads importieren oder per API und Cron pflegen — und wie der Revenue Aggregator arbeitet.
Guide lesen →DocsPush- und Pop-Netzwerke
Arbeit mit Push- und Pop-Traffic-Quellen: Feeds, Zonen-Optimierung und der Zone Killer.
Guide lesen →DocsFacebook / Meta
Kosten-Import aus Meta Ads und die Conversions API: serverseitige Events mit Deduplizierung.
Guide lesen →DocsDolphin / Fbtool
Facebook-Kosten über den Keitaro-kompatiblen Admin-API-Endpunkt empfangen: API-Key, Dolphin- und Fbtool-Setup und wie der Spend auf die Klicks verteilt wird.
Guide lesen →DocsFB-Kommentar-Cleaner
Spam-Kommentare unter Meta-Ads nach Zeitplan verstecken oder löschen: Regelwerke, Presets, Ausnahmen, Dry-run und Auto-Pause.
Guide lesen →DocsTraffic-Quellen und Affiliate-Netzwerke
Die beiden Verzeichnisse am Funnel-Rand: Templates für rund 200 Quellen und 440 Netzwerke, Parameter, Makros und Postback-URLs.
Guide lesen →DocsReports, Logs und Metriken
Der Report-Builder, Traffic-Log, Klick-Karte und jede Metrik erklärt — von Clicks und Visits über ROI bis zur Scroll-Tiefe.
Guide lesen →DocsDomains und SSL
Domains hinzufügen, DNS und A-Records, kostenlose Let's-Encrypt-Zertifikate, Cloudflare-Proxy und alle Schalter der Domain-Einstellungen.
Guide lesen →DocsCloudflare
Kampagnen-Domains über Cloudflare fahren: API-Token, Accounts, automatische A-Records, SSL-Modi und der orange Cloud-Proxy.
Guide lesen →DocsAdministration
Users, Rollen und Rechte, Settings, Geo-Datenbanken, Updates und Systemstatus — die Verwaltung des Trackers über das ⚙-Menü.
Guide lesen →DocsTelegram-Bot
Den Tracker aus Telegram steuern: Statistiken, Kampagnen und Conversions per Befehl, dazu Benachrichtigungen und tägliches Digest.
Guide lesen →DocsMCP: ein KI-Assistent im Tracker
Claude oder einen anderen MCP-Client an Orbitra anbinden und Kampagnen, Offers und Domains in natürlicher Sprache verwalten.
Guide lesen →