Docs

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

  1. 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.
  2. 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.
  3. Für jeden Record werden die Klicks desselben Tages gematcht, von der spezifischsten Ebene zur breitesten:
    1. ad_id (auch creative_id, creative);
    2. adset_id / adgroup_id (auch adgroup, adgroupid, ad_group_id);
    3. campaign_id (auch campaign, campaignid, ad_campaign_id).
  1. Der Tages-Spend wird gleichmäßig auf die gematchten Klicks verteilt.
  2. Der Spend wird in die Tracker-Währung umgerechnet (Kurse von open.er-api.com, 12 Stunden gecacht; eigene Kurse über die Einstellung fx_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:

CodeBedeutung
no_spendRecords sind angekommen, aber der Spend darin ist null
no_clicksAn diesen Tagen gibt es keine Klicks in Orbitra
no_idsDie Klicks tragen keine Ad-, Gruppen- oder Campaign-ID — der Link führt nicht direkt auf die Orbitra-Kampagne, oder Parameter gehen unterwegs verloren
macrosKlicks enthalten unaufgelöste Makros wie __CID__ — die Quelle hat keine Werte eingesetzt
ids_differDie 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:

MethodeWas du brauchst
Connect via TikTok MCPNur 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
ManualEin 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.

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.example ist 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.

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.

← Zurück
Postbacks und Conversions
Weiter →
Push- und Pop-Netzwerke
Quelle auf GitHub ansehen: github.com/fenjo26/Orbitra.link/wiki
Alle Guides
Docs

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 →
Docs

Installation und Updates

Systemvoraussetzungen, der Ein-Befehl-Installer, PHP-Updates inklusive Sicherheits-Hinweisen, Panel-Zugriff per IP und die lokale Entwicklungsumgebung.

Guide lesen →
Docs

Migration 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 →
Docs

Migration von Binom

Kampagnen, Offers, Streams und mehr direkt über die Binom-v2-Public-API importieren — ohne Dump-Datei, inklusive Mapping-Hinweisen.

Guide lesen →
Docs

Funktionen 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 →
Docs

Kampagnen 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 →
Docs

Cloaking (Referenz)

Die vollständige Cloaking-Referenz: Detection layers, Sensitivity, Targeting filters, JavaScript-Verifizierung, Verdicts, Gründe und Diagnostik.

Guide lesen →
Docs

Browser check

Bots, Moderator-VMs, Emulatoren und Anti-Detect-Browser an Widersprüchen im Browser selbst erkennen — Modi, Anzeichen und der sichere Einstieg.

Guide lesen →
Docs

Landingpages (Referenz)

Die vollständige Landingpage-Referenz: lokale, Redirect-, Preload- und Action-Landingpages, das {offer}-Makro, SubID-Weitergabe, JS-Adapter und PHP-Landings.

Guide lesen →
Docs

PWA und Web Push

PWA-Landingpages und eigenes Web Push: Builder, Domain-Bindung, VAPID-Keys, Abonnenten, Messages, der Versand-Cron, Attribution und Fehlerbehebung.

Guide lesen →
Docs

PWA Funnel

Der PWA-Besuch als konfigurierbarer Funnel: Screens in fester Reihenfolge, Event-Tracking pro Screen und Re-Engagement-Benachrichtigungen.

Guide lesen →
Docs

Conversion-Popups

Echte Conversion-Events als Popup auf der Landing zeigen: Einrichtung pro Kampagne, Trigger und Platzierung.

Guide lesen →
Docs

Session-Aufzeichnungen und Heatmaps

Echte Besuche wie ein Video abspielen, dazu Klick-Heatmap und Scroll-Map. Speicher-Limits und Datenschutz-Hinweise.

Guide lesen →
Docs

Content Gallery

Die zentrale Mediathek des Trackers für Icons, Screenshots und Creatives, genutzt in PWAs und Landings: Ordner, Uploads, MediaPicker.

Guide lesen →
Docs

Creatives-Bibliothek

Creatives mit SubID-Tracking speichern und über Kampagnen hinweg testen.

Guide lesen →
Docs

Externe PWA und Telegram-Kanäle

PWAs auf externen Domains veröffentlichen und Telegram-Kanäle als Traffic-Quelle mit zuordenbaren Abonnenten fahren.

Guide lesen →
Docs

Postbacks und Conversions

Eingehende Postbacks, Conversion-Statuswerte und -Typen sowie ausgehende S2S-Postbacks an die Traffic-Quelle.

Guide lesen →
Docs

Kosten

Spend aus Facebook, TikTok und Google Ads importieren oder per API und Cron pflegen — und wie der Revenue Aggregator arbeitet.

Guide lesen →
Docs

Push- und Pop-Netzwerke

Arbeit mit Push- und Pop-Traffic-Quellen: Feeds, Zonen-Optimierung und der Zone Killer.

Guide lesen →
Docs

Facebook / Meta

Kosten-Import aus Meta Ads und die Conversions API: serverseitige Events mit Deduplizierung.

Guide lesen →
Docs

Dolphin / 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 →
Docs

FB-Kommentar-Cleaner

Spam-Kommentare unter Meta-Ads nach Zeitplan verstecken oder löschen: Regelwerke, Presets, Ausnahmen, Dry-run und Auto-Pause.

Guide lesen →
Docs

Traffic-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 →
Docs

Reports, 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 →
Docs

Domains und SSL

Domains hinzufügen, DNS und A-Records, kostenlose Let's-Encrypt-Zertifikate, Cloudflare-Proxy und alle Schalter der Domain-Einstellungen.

Guide lesen →
Docs

Cloudflare

Kampagnen-Domains über Cloudflare fahren: API-Token, Accounts, automatische A-Records, SSL-Modi und der orange Cloud-Proxy.

Guide lesen →
Docs

Administration

Users, Rollen und Rechte, Settings, Geo-Datenbanken, Updates und Systemstatus — die Verwaltung des Trackers über das ⚙-Menü.

Guide lesen →
Docs

Telegram-Bot

Den Tracker aus Telegram steuern: Statistiken, Kampagnen und Conversions per Befehl, dazu Benachrichtigungen und tägliches Digest.

Guide lesen →
Docs

MCP: 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 →