Docs

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

NetzwerkSpend-EbeneAPI-Key
AdMavenKampagne × ZoneAdvertiser panel → API section → API token
PropellerAdsKampagne × ZoneSSP → Profile → API token
KadamKampagne × ZoneAdvertiser account → API section → API token
GalaxionKampagne × ZoneE-Mail + Passwort des Accounts (der Tracker holt sich selbst einen Token) oder ein fertiger API-Token
HilltopAdsnur KampagneMy Account → API tab → API key
Adsterranur KampagneSettings → API tab → Generate new token (nur der neueste Token funktioniert)
Clickadunur KampagneAdvertiser 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:

  1. 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.
  2. 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:

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.

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.

← ZurĂŒck
Kosten
Weiter →
Facebook / Meta
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 →