Kosten
Orbitra zieht den Tages-Spend aus Ad-Accounts und verteilt ihn auf Klicks, sodass ROI und Profit in den Reports aus echtem Geld gerechnet werden, nicht aus einem manuellen Cost per Click.
Connections findest du unter ⚙ → Integrations, in der Ad-Netzwerke-Gruppe: Facebook Costs, TikTok Costs, Google Ads Costs. Der Reiter Integrations im Kampagnen-Editor zeigt, ob die Klicks der Kampagne IDs fürs Matching tragen, und erlaubt dir, eine Connection hinzuzufügen.
Wie der Spend auf einem Klick landet
- Der Cron
aggregator_cron.php(der Installer legt ihn alle 15 Minuten an) läuft durch die Connections, deren Update-Intervall fällig ist. Jeder Durchlauf liest die letzten 5 Tage erneut, der erste Durchlauf liest 30: Ad-Accounts revidieren den Spend rückwirkend, und der aktuelle Tag wächst bis Mitternacht. - Records landen in
cost_records, Updates keyed über(connection_id, external_id). Denselben Tag erneut zu syncen ist sicher: Der Spend wird neu gerechnet, nicht akkumuliert. - Für jeden Record werden die Klicks desselben Tages gematcht, von der spezifischsten Ebene zur breitesten:
ad_id(auchcreative_id,creative);adset_id/adgroup_id(auchadgroup,adgroupid,ad_group_id);campaign_id(auchcampaign,campaignid,ad_campaign_id).
- Der Tages-Spend wird gleichmäßig auf die gematchten Klicks verteilt.
- Der Spend wird in die Tracker-Währung umgerechnet (Kurse von
open.er-api.com, 12 Stunden gecacht; eigene Kurse über die Einstellungfx_rates_manual_json, Einheiten pro 1 USD).
Die Hauptbedingung: Der Link der Anzeige muss die Ad-, Gruppen- oder Campaign-ID in den Tracker durchreichen. Am einfachsten wählst du in der Kampagne eine Traffic-Quelle aus einem Template (Facebook, TikTok, Google Ads) — das Template fügt die nötigen Makros selbst hinzu.
Records ohne gefundene Klicks wiederholen das Matching bei jedem Sync: Ein später Klick, ein gefixter Link oder eine neue adgroup_id zieht den Spend nach.
„N empfangen, 0 zugeordnet"
Der Button Refresh costs an einer Connection zeigt den konkreten Grund:
| Code | Bedeutung |
|---|---|
no_spend | Records sind angekommen, aber der Spend darin ist null |
no_clicks | An diesen Tagen gibt es keine Klicks in Orbitra |
no_ids | Die Klicks tragen keine Ad-, Gruppen- oder Campaign-ID — der Link führt nicht direkt auf die Orbitra-Kampagne, oder Parameter gehen unterwegs verloren |
macros | Klicks enthalten unaufgelöste Makros wie __CID__ — die Quelle hat keine Werte eingesetzt |
ids_differ | Die IDs in den Klicks und im Ad-Account-Report passen nicht zusammen; beide werden angezeigt |
In der Klick-Karte zeigt der Abschnitt „Parameters" alle erfassten Parameter, mit den IDs des Ad-Netzwerks zuerst.
Facebook / Meta
Ein Long-lived User Token oder System User Token mit ads_read plus die Ad-Account-ID (act_…). API-Version und Proxy kannst du angeben. Details: Facebook / Meta.
TikTok
Drei Wege zur Verbindung:
| Methode | Was du brauchst |
|---|---|
| Connect via TikTok MCP | Nur ein TikTok-Login. Keine Developer-App, kein Token nötig — der Tracker registriert sich selbst über TikToks offiziellen MCP-Server. Importiert Spend; importiert keine Pixel. Das Panel muss über HTTPS geöffnet werden (https:// auf einer nackten IP funktioniert auch) |
| 1-Click (Sign in with TikTok) | App ID und App Secret deiner eigenen TikTok-for-Business-App: die Umgebungsvariablen ORBITRA_TIKTOK_APP_ID / ORBITRA_TIKTOK_APP_SECRET oder die Felder der manuellen Connection. Findet Ad-Accounts und Pixel, importiert Pixel in die Pixel Vault |
| Manual | Ein Marketing-API-Token aus einer kostenlosen Developer-App (Developer Portal → Apps & Agents → Direct Advertiser, Berechtigungen Ads Management und Reporting) + Advertiser ID |
Ein Events-Manager-Token taugt nicht für den Spend-Import — er schickt nur Conversion-Events. Liest sich die Ad-Account-Liste nicht über MCP, kannst du Advertiser-IDs manuell einfügen, kommagetrennt.
Google Ads
- 1-Click (Sign in with Google) — findet Direct-Accounts und MCC-Child-Accounts und legt für jeden ausgewählten eine Connection an. Braucht einen Developer Token (aus dem MCC) und eine OAuth Client ID + Secret (Google Cloud Console, Typ „Web application", Redirect-URI
https://your-domain/api.php?action=google_ads_oauth_callback). - Manual — Customer ID, Developer Token, Client ID, Client Secret, Refresh Token.
Die 1-Click-Keys werden der Reihe nach gezogen: die Umgebungsvariablen ORBITRA_GOOGLE_CLIENT_ID, ORBITRA_GOOGLE_CLIENT_SECRET, ORBITRA_GOOGLE_DEVELOPER_TOKEN → Settings → die Felder einer bereits gespeicherten manuellen Connection. Am einfachsten speicherst du einmal eine manuelle Connection — danach funktioniert auch der 1-Click-Button. Server-Setup prüfen: php check_google_ads_oauth.php.
Umgebungsvariablen werden aus der PHP-FPM-Umgebung gelesen (
env[ORBITRA_GOOGLE_CLIENT_ID] = …in der Pool-Konfiguration), nicht aus der.env-Datei — PHP-Code lädt sie nicht..env.exampleist nur eine Namensliste.
Google und TikTok akzeptieren keine OAuth-Redirects zu http://. Auf einer nackten IP ohne Zertifikat nimm eine manuelle Connection.
Der Spend wird über die ValueTrack-Parameter {campaignid} und {creative} gematcht — das Google-Ads-Quellen-Template fügt sie hinzu.
Push- und Pop-Netzwerke
Spend aus Push-/Pop-Advertiser-Netzwerken — AdMaven, PropellerAds, Kadam, Galaxion, HilltopAds, Adsterra, Clickadu — wird über denselben Cron importiert und landet auf Klicks pro Kampagne und, wo das Netzwerk es meldet, pro Zone (Site). Der Zone Killer, der Zonen blockiert, die Geld verbrennen, arbeitet mit diesen Daten. Siehe Push & pop networks.
Dolphin und Fbtool
Diese Dienste können Spend nur über die Admin-API an Keitaro schicken. Orbitra akzeptiert denselben Request unter POST /admin_api/v1/campaigns/<ID>/update_costs. Details: Dolphin / Fbtool.
Manueller Spend
Der Button Refresh costs im Kampagnen-Menü setzt den Spend für einen Zeitraum manuell (Action update_costs).
Revenue Aggregator
⚙ → Revenue Aggregator — die umgekehrte Aufgabe: Revenue aus Affiliate-Programm-Accounts ziehen, die keine Postbacks schicken. Engines: ReferOn, Affilka, Generic API. Pro Connection stellst du Netzwerk, Deal-Typ, Sync-Intervall und den Namen des Parameters ein, in dem das Affiliate-Programm die Orbitra-Click-ID speichert. Revenues und Sync-Logs liegen in den Reitern derselben Seite.
Agenturen und die Gebühr
Gemietete Ad-Accounts kosten mehr, als der Cabinet reportet: Der Prozentsatz der Agentur wird in jeden Import geschrieben (cost_records.fee_amount; clicks.cost trägt den Spend mit Gebühr, clicks.fee den Gebührenanteil) — ROI/CPC sind also ehrlich, sobald der Spend landet, und den Prozentsatz später zu ändern schreibt nie die Historie um.
- Der Reiter Agencies des Aggregator-Bereichs verwaltet Agenturen (Name, Fee %, Kontakte, Zahlungsbedingungen, Notizen) und vergleicht sie nach Spend, CPC, CPM und ROI über einen Zeitraum.
- Jede Cost-Connection wählt ihre Agentur im Editor.
- Reports bekommen die Spalten Spend (cabinet) und Agency fee; jede Gruppierung teilt beide.
Ad-Namen, Statuswerte, Plattform-Metriken
Der Cost-Sync sammelt auch, was die Plattform über die Ads selbst weiß: Namen und Statuswerte in ad_entities (Statuswerte stündlich aktualisiert, im selben Cron-Durchlauf), Impressions und die eigenen Click-Zähler der Plattform auf den Spend-Zeilen. In Kampagnen-Reports, gruppiert nach Ad / Adset / Campaign, bekommst du Namen statt nackter IDs, einen Status-Chip und die Plattform-Spalten: Impressions, Clicks (platform), CPM, CTR (platform) und Click loss = 1 − Tracker-Visitors / Plattform-Clicks — die Zahl, die ein Cloaking- oder Domain-Problem sofort offenlegt und die adset.pro nicht hat.
Ein oberes Banner in den Reports zeigt den Anteil der Revenue, der sich keiner Ad-ID zuordnen lässt (ein nicht ersetztes __CID__ / {{ad.id}}-Makro gilt als fehlend), und springt in den Editor der betroffenen Quelle.
Cron
*/15 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/www/orbitra/var/logs/aggregator.log 2>&1
Das Intervall wird pro Connection geprüft, ein häufiger Cron ist also billig; für Intervalle unter 15 Minuten lässt du ihn öfter laufen. Flags: --force (ignoriert das Intervall), --connection=5, --days=30.
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 →