Push- und Pop-Netzwerke
Spend-Import aus Push- und Pop-Advertiser-Netzwerken, dazu der Zone Killer â Regeln, die die Zonen finden (und, wenn du es erlaubst, blockieren), die Geld verbrennen. Alles an einem Ort: die Karte Push/Pop networks unter â â Integrations, in der Ad-Netzwerke-Gruppe neben Facebook / TikTok / Google Costs.
Netzwerke
| Netzwerk | Spend-Ebene | API-Key |
|---|---|---|
| AdMaven | Kampagne Ă Zone | Advertiser panel â API section â API token |
| PropellerAds | Kampagne Ă Zone | SSP â Profile â API token |
| Kadam | Kampagne Ă Zone | Advertiser account â API section â API token |
| Galaxion | Kampagne Ă Zone | E-Mail + Passwort des Accounts (der Tracker holt sich selbst einen Token) oder ein fertiger API-Token |
| HilltopAds | nur Kampagne | My Account â API tab â API key |
| Adsterra | nur Kampagne | Settings â API tab â Generate new token (nur der neueste Token funktioniert) |
| Clickadu | nur Kampagne | Advertiser account â API section â API key |
Netzwerke mit nur Kampagne haben zwar einen Zone-Breakdown in ihrer API, aber dessen Zeilen tragen keine Campaign-ID â eine Zone lĂ€sst sich dort nicht der Kampagne zuordnen, deren Klicks sie gekauft hat. Ihr Spend wird ĂŒber die Klicks der Kampagne verteilt, und die Connection-Karte warnt dich beim Verbinden vorher davon.
Verbinden
WĂ€hle eine Netzwerk-Kachel, fĂŒge den Key ein, drĂŒcke Check connection â er zeigt den echten Kontostand â und speichere. Jede Connection hat ihr eigenes Update-Intervall; die Buttons in der Liste: Update spend (jetzt), Pause, Bearbeiten, Löschen. Bereits importierter Spend bleibt nach dem Löschen in den Reports.
Der Sync lĂ€uft im selben aggregator_cron.php-Durchlauf wie die anderen Cost-Connections (siehe Kosten): Jeder Durchlauf liest die letzten 5 Tage erneut, der erste 30. Einen Tag erneut zu syncen ist sicher â der Spend wird neu gerechnet, nicht akkumuliert.
Wie der Spend auf einem Klick landet
Die Hauptbedingung ist dieselbe wie bei Facebook oder TikTok: Die Kampagne muss das Traffic-Quellen-Template des Netzwerks nutzen, damit der Link die Campaign-ID des Netzwerks durchreicht (in ad_campaign_id) und die Zone-ID (die Keitaro-Quellen-Templates schreiben sie in source, das eingebaute PropellerAds-Template in zone). Ohne das Zone-Makro landet der Spend trotzdem â aber nur pro Kampagne, nie nach Zone gesplittet.
Matching, von der spezifischsten Ebene zur breitesten:
- Kampagne Ă Zone â eine Zone-Zeile wird nur Klicks desselben Tages zugeordnet, die sowohl die Zone-ID als auch die Campaign-ID des Netzwerks tragen. Eine nackte Zone-ID reicht nicht: Zone-IDs sind netzwerkĂŒbergreifend nicht eindeutig.
- Kampagne â eine Zone-Zeile, deren Zone keine Klicks getroffen hat, summiert sich auf die Klicks der Kampagne ohne Zone (sie klettert nie auf Klicks, die bereits von ihren eigenen Zone-Zeilen bepreist sind â mehrere ungematchte Zonen addieren sich, statt sich gegenseitig zu ĂŒberschreiben).
Als âdie Zone" zĂ€hlen die Klick-Parameter-Keys: zone, zone_id, zoneid, sub_source_id.
Antwortet ein Sync âRecords empfangen, aber keiner lieĂ sich an Klicks hĂ€ngen", nutzt die Kampagne höchstwahrscheinlich nicht das Quellen-Template dieses Netzwerks â der Link bringt keine Campaign-ID zum Matchen mit. Die Diagnose âN empfangen, 0 zugeordnet" aus Kosten gilt hier genauso.
Zone Killer
Eine Karte im Reiter General des Kampagnen-Editors (die Kampagne muss zuerst gespeichert sein). Eine Regel bindet die Kampagne an eine Push-/Pop-Cost-Connection und entscheidet, welche Zonen Kandidaten sind:
- window â wie viele Tage zurĂŒckgeurteilt wird (Spend und Conversions werden pro Zone ĂŒber das Fenster summiert);
- min spend â eine Zone, die weniger ausgegeben hat, bleibt unangetastet;
- zero conversions und/oder max ROI â die Kill-Bedingungen;
- mode â
dry_run(Standard) oderautomit einem Block-Limit pro Lauf.
Kandidaten werden aus clicks.cost / clicks.revenue pro Zone gerechnet â dieselben verteilten Zahlen, die die Reports zeigen, mit denselben Zone-Keys, auf die der Kosten-Import gematcht hat. Eine Regel kann also nie eine Zone beurteilen, die der Importer anders bepreist hat.
- Dry-run listet die Kandidaten; du wĂ€hlst aus und drĂŒckst Block selected.
- Auto lÀsst
zone_rules_cron.phpdie Kandidaten selbst ausfĂŒhren (gedeckelt pro Lauf) und schickt eine Telegram-Benachrichtigung darĂŒber, was blockiert wurde.
Das Blockieren lĂ€uft ĂŒber die Write-API des Netzwerks fĂŒr AdMaven, HilltopAds, PropellerAds, Kadam und Galaxion. Adsterra und Clickadu haben keine brauchbare Zone-Write-API: Ihre Regeln bleiben im Dry-Run, und die Karte kopiert die gewĂ€hlten Zone-IDs, damit du sie von Hand in die Blacklist des Netzwerks einfĂŒgen kannst.
Jeder Block und Unblock â manuell oder automatisch â landet in einem Append-only-Journal mit den Metriken, die hinter der Entscheidung standen; aktuell blockiert ist eine Zone, deren letzte erfolgreiche Aktion âblock" ist. Das Journal wird unter der Regel gerendert.
Bei Netzwerken mit nur Kampagne (HilltopAds, Adsterra, Clickadu) beurteilt der Zone Killer Zonen ungefĂ€hr â ĂŒber ihren Anteil an den Klicks der Kampagne, weil die API keinen Spend pro Zone liefert. Lass ihre Regeln im Dry-Run und prĂŒfe die Liste, bevor du blockierst.
Cron
*/15 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/www/orbitra/var/logs/aggregator.log 2>&1
*/30 * * * * php /var/www/orbitra/zone_rules_cron.php >> /var/www/orbitra/var/logs/zone_rules.log 2>&1
Die erste Zeile ist der Cron, den der Installer fĂŒr den Cost-Sync anlegt. Die zweite â den Zone-Killer-Executor â fĂŒgst du selbst hinzu, und nur wenn du auto-Regeln nutzt; ein Durchlauf ist billig (eine Regel ohne Kandidaten ist ein einzelner GROUP BY ĂŒber die Klicks der Kampagne). Flags: --campaign=12 (eine Kampagne), --quiet.
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 â