Postbacks und Conversions
Eine Conversion erreicht Orbitra als Postback vom Affiliate-Netzwerk und wird ĂŒber ihre ID (subid) an einen Klick gehĂ€ngt. Der Tracker kann sie dann weiterleiten an die Traffic-Quelle (ein ausgehender S2S-Postback) und an die Conversions API der Ad-Plattform.
Eingehender Postback
Die Postback-Adresse ist â â Postback URL. Sie sieht so aus:
https://your-domain/<postback_key>/postback
postback_key ist der geheime SchlĂŒssel der Installation (Schutz vor Fake-Conversions). Stimmt er noch mit dem öffentlichen Standardwert aus dem Repository ĂŒberein, warnt dich das Panel; generiere einen neuen auf derselben Seite oder mit php cli/generate_postback_key.php. Der Installer generiert seinen eigenen Key.
Parameter
| Parameter | Erforderlich | Bedeutung |
|---|---|---|
subid | ja | Die Tracker-Click-ID â was das Netzwerk in {subid} / {clickid} erhalten hat |
status | nein | Conversion-Status: lead, sale, rejected, registration, deposit, trash oder ein eigener |
payout | nein | Payout-Betrag |
currency | nein | Payout-WĂ€hrung |
tid | nein | Transaction ID â fĂŒr wiederholte Conversions auf demselben Klick |
sub_id_N | nein | ZusÀtzliche Werte |
<type>_status | nein | Status direkt in der URL mappen: sale_status=approved,confirmed |
Beispiele:
âŠ/postback?subid={subid}&status=lead
âŠ/postback?subid={subid}&status=sale&payout={payout}
âŠ/postback?subid={subid}&status=sale&payout={payout}&tid={transaction_id}
âŠ/postback?subid={subid}&status={status}&sale_status=approved,confirmed
Benennt das Netzwerk seine Parameter anders, lege Parameter-Aliase auf derselben Seite an.
Antworten
200 â die Conversion ist verbucht. 4xx â der Request wird abgelehnt (falscher Key, unbekannter Klick). 500 / 503 â ein Schreibfehler; das Netzwerk sollte den Postback wiederholen. Die Conversion, ihre ZĂ€hler und die Conversions-API-Events werden in einer einzigen Transaktion geschrieben: Ein Fehler kann nie ein â200 und ein verlorenes Event" produzieren.
Wie der Status bestimmt wird
Der Reihe nach:
- Conversion types aus Settings â Conversion Types â wenn der Status in der Werteliste eines Typs steht.
- Ein eingebauter Typ mit demselben Namen.
- Die
<type>_status=âŠ-Regel aus dem Postback selbst. - Eingebaute Aliase:
approved,confirmed,accepted,convertedâsale;declined,refused,cancelled,canceledârejected. - Sonst â
custom.
Statuswerte, die keinen Typ getroffen haben, stehen unter Settings â Conversion Types â Unmapped statuses: Dort kannst du sie einem Typ zuordnen, und bereits verbuchte Conversions werden neu klassifiziert.
Conversion-Typen
Jeder Typ hat: einen Namen, eine Liste von Statuswerten des Netzwerks, eine Label-Farbe und vier Flags â zĂ€hlt zu âConversions", zĂ€hlt zu âProfit", S2S an die Quelle senden, zĂ€hlt zum Offer-Cap. Ein Typ Revshare existiert ab Werk (der Status revshare geht nur in den Profit: keine neue Conversion, kein S2S, kein Cap).
Payouts in anderer WĂ€hrung
Der Payout wird in die BasiswÀhrung des Trackers umgerechnet (Kurse in core/CurrencyRates.php). Original-Betrag, WÀhrung und Kurs werden auf dem Klick gespeichert. Die ausgehenden Postback-Makros {payout} / {currency} tragen den Wert in der BasiswÀhrung; die Originale sind {fx_orig_payout} / {fx_orig_currency}. Ein unbekanntes WÀhrungspaar wird so verbucht, wie es ist.
Log der eingehenden Postbacks
â â Logs â Postbacks â jeder eingehende Request mit seinem Ausgang: ob der Klick gefunden wurde, der resultierende Status, der Betrag. Die Click-ID öffnet die Klick-Karte.
Ausgehende S2S-Postbacks (an die Traffic-Quelle)
Konfiguriert in der Kampagne, im Reiter S2S Postbacks. Jeder Postback ist eine Karte: URL, GET- oder POST-Methode, Status-Chips (sale, lead, rejected, registration, deposit, trash plus eigene). Das âInsert macro"-MenĂŒ fĂŒgt ein Makro an der Cursor-Position ein.
Hat die gewÀhlte Traffic-Quelle eine postback_url hinterlegt, bekommt eine Kampagne mit leerer Liste sie automatisch. Sind schon Postbacks konfiguriert, erscheint oben im Reiter ein Hinweis mit einem Add-Button.
Der Status-Filter lĂ€sst eine Conversion durch, wenn der interne Status gepasst hat (sale), das eigene Wort des Netzwerks (approved) oder der Legacy-custom-Chip fĂŒr Wörter, die inzwischen von Aliasen erkannt werden.
Makros
{subid} (auch {clickid}, {click_id}), {status}, {payout} (auch {conversion_revenue}), {currency}, {tid} (auch {external_id}), {campaign_id}, {offer_id}, {cost}, {revenue}, {profit} und jeder gespeicherte Klick-Parameter namentlich: {sub_id_1} ⊠{sub_id_30}, {fx_orig_payout}, {fx_orig_currency} usw.
{status} trĂ€gt den internen Status (sale), nicht das Original-Wort des Netzwerks. Um es in den Wortschatz der Quelle zu ĂŒbersetzen, nutze eine Keitaro-artige Transformation: {status: sale=purchase lead=lead} â ein Status, der nicht in der Liste steht, geht unverĂ€ndert durch.
Delivery-Queue
Ausgehende Postbacks werden nicht im Moment der Conversion geschickt â sie gehen in die Queue s2s_postbacks_log, und der Cron postback_queue_cron.php (einmal pro Minute) liefert sie mit Wiederholungen aus:
- Erfolg â HTTP 2xxâ3xx;
- Wiederholungen: 60 s â 5 min â 30 min â 2 h â 24 h, danach wird die Zeile als
failedmarkiert; - SSRF-PrĂŒfung beim Einreihen und vor dem Senden: Eine Adresse in einem privaten Netz bekommt sofort
failed; - eine von einem abgestĂŒrzten Worker in
in_flightliegengelassene Zeile kehrt nach 10 Minuten in die Queue zurĂŒck.
â ïž Ohne den Cron wird die Queue nie abgearbeitet. Der Installer richtet ihn ein; zum PrĂŒfen oder manuellen HinzufĂŒgen â Settings â Automation â Postback Queue. Das Update ĂŒber das Panel stellt einen fehlenden Cron ebenfalls wieder her.
Queue-Log: â â Logs â S2S (Status, Versuche, nĂ€chster Versuch, letzter Fehler, HTTP-Code).
Postback-Tester
Der Button im Reiter S2S Postbacks (nur Admin) schickt einen echten Postback an denselben Server, mit einem Einmal-Klick, und zeigt ein Urteil fĂŒr jeden Schritt:
- mit welchem Status die Conversion verbucht wurde;
- ob der Status-Filter jedes S2S-Postbacks sie durchlĂ€sst â und warum: ĂŒber den internen Status, das Wort des Netzwerks oder den Legacy-Chip;
- eine Probe-Zustellung an die Quelle: HTTP-Code und Timing;
- Makros, die sich nicht auflösen wĂŒrden und als Klartext zur Quelle gingen (
{external_id},{sub_id_N}); - Platzhalter aus dem Template der Quelle (
bbg=xxx,[YOUR_âŠ]); - ob der Queue-Worker lebt und der Cron installiert ist.
Der Test-Klick, die Test-Conversion und die Queue-Zeilen werden nach der PrĂŒfung gelöscht.
Verpasste Conversions erneut senden
Der Button âRe-send missed conversions" reiht Conversions der letzten 72 Stunden in die Queue ein, die den aktuellen Filter passieren, es aber nie in die Queue geschafft haben. Nochmal drĂŒcken dupliziert nichts.
Conversion-Import
â â Conversion Import â eine Datei hochladen oder eine Liste von Click-IDs einfĂŒgen, wenn das Netzwerk keine Postbacks schicken kann oder sie wiederhergestellt werden mĂŒssen.
Conversions API
Das Senden von Conversions an die Meta- und TikTok-Server wird im Pixel-Profil und in der Kampagne konfiguriert (Reiter âIntegrations"). Details zu Meta: Facebook / Meta. Events werden zusammen mit der Conversion in die Queue gestellt und mit BestĂ€tigung zugestellt: Erfolg nur bei einer 2xx-Antwort, in der events_received der Batch-GröĂe entspricht.
Monitoring
conversion_monitor_cron.php berechnet den Anteil fehlgeschlagener Postbacks ĂŒber ein Fenster (Standard: 60 Minuten) und schreibt bei Ăberschreiten der Schwelle (10 %) einen Alert in var/logs/conversion_alerts.log; das Senden des Alerts an Telegram ist noch nicht implementiert. Der Installer richtet diesen Cron nicht ein â fĂŒge ihn bei Bedarf hinzu:
*/5 * * * * php /var/www/orbitra/conversion_monitor_cron.php --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 â