Docs

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

ParameterErforderlichBedeutung
subidjaDie Tracker-Click-ID — was das Netzwerk in {subid} / {clickid} erhalten hat
statusneinConversion-Status: lead, sale, rejected, registration, deposit, trash oder ein eigener
payoutneinPayout-Betrag
currencyneinPayout-WĂ€hrung
tidneinTransaction ID — fĂŒr wiederholte Conversions auf demselben Klick
sub_id_NneinZusÀtzliche Werte
<type>_statusneinStatus 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:

  1. Conversion types aus Settings → Conversion Types — wenn der Status in der Werteliste eines Typs steht.
  2. Ein eingebauter Typ mit demselben Namen.
  3. Die <type>_status=
-Regel aus dem Postback selbst.
  4. Eingebaute Aliase: approved, confirmed, accepted, converted → sale; declined, refused, cancelled, canceled → rejected.
  5. 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:

⚠ 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:

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
← ZurĂŒck
Externe PWA und Telegram-KanÀle
Weiter →
Kosten
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 →