Guide

Postbacks: Was du deinem Affiliate-Manager sagst

Was ein Postback ist

Wenn ein Besucher auf der Seite des Advertisers kauft, wird der Sale im Affiliate-Netzwerk verbucht, nicht in deinem Tracker. Ein Postback ist die Nachricht des Netzwerks an deinen Tracker darĂŒber: ein kurzer Server-zu-Server-Request wie

https://track.example.com/a7f3c91e/postback?subid=0bc4ba11-688d-4de0-98b4-8b0d6e81cef&status=sale&payout=30

Er sagt: „Der Klick 0bc4ba11
 hat konvertiert, Status sale, du verdienst 30". Orbitra findet diesen Klick und weiß von da an, welche Kampagne, welcher Stream, welcher Offer, welches Land, welche Anzeige und welches Creative das Geld gebracht hat.

Ohne Postbacks zĂ€hlt der Tracker zwar Klicks, sieht aber nie eine einzige Conversion — Einnahmen, Gewinn, ROI und CR bleiben bei null.

Wie die Klick-ID die Runde macht

1. Visitor clicks your ad → Orbitra creates click 0bc4ba11

2. Orbitra redirects to the offer:  https://network/offer?aff=777&sub1=0bc4ba11

                                                              â–Č added by the network's "offer parameters"
3. The network remembers sub1 for this visitor
4. Visitor buys → the network calls your postback URL and puts sub1 back:
       https://track.example.com/a7f3c91e/postback?subid=0bc4ba11
&status=sale&payout=30
5. Orbitra marks click 0bc4ba11
 as a conversion

Zwei Einstellungen sorgen dafĂŒr, dass es funktioniert:

Hast du das Netzwerk aus einem Template angelegt, nutzen beide HĂ€lften bereits die richtigen Namen.

Wo du deine Postback-URL findest

Die Seite mit den Postback-Einstellungen
Die Seite mit den Postback-Einstellungen

Die Parameter, die Orbitra versteht:

ParameterErforderlichBedeutung
subidjaDie Orbitra-Klick-ID — was auch immer das Netzwerk in sub1 (oder deinem gewĂ€hlten Feld) erhalten hat
statusneinlead, sale, rejected, trash, registration, deposit oder das eigene Wort des Netzwerks (approved, pending, declined
)
payoutneinWie viel du fĂŒr diese Conversion verdienst
currencyneinWenn das Netzwerk in einer anderen WĂ€hrung zahlt — sie wird in die Tracker-WĂ€hrung umgerechnet
tidneinTransaction ID, nötig, wenn ein Klick mehrere Conversions bringen kann (z. B. wiederholte Deposits)

Die eigenen Status-Worte des Netzwerks werden automatisch ĂŒbersetzt (approved, confirmed → sale; declined, cancelled → rejected). Jedes andere Wort kannst du direkt in der URL mappen: &sale_status=approved,paid&lead_status=pending. Worte, die Orbitra nicht erkennt, tauchen unter ⚙ → Settings → Conversion Types → Unmapped statuses auf, wo du sie zuordnen kannst.

Was du deinem Affiliate-Manager schickst

Die meisten Netzwerke richten den Postback fĂŒr dich ein, wenn du fragst. Schick so etwas (ersetze die URL durch deine):

Hi! Bitte richte fĂŒr meinen Account einen globalen Postback ein (alle Offers):
https://track.example.com/a7f3c91e/postback?subid={sub1}&status={status}&payout={payout}
- Meine Klick-ID wird in sub1 des Offer-Links ĂŒbergeben — bitte gib sie in subid zurĂŒck.
- Bitte schicke Postbacks fĂŒr alle Statuswerte: neuer Lead (hold/pending), approved, rejected und trash, mit dem Payout fĂŒr approved.
- Methode GET ist in Ordnung.
Kannst du mir außerdem deine Makro-Namen fĂŒr Klick-ID, Status und Payout nennen, falls sie sich von {sub1}, {status}, {payout} unterscheiden? Danke!

Was du in der Antwort prĂŒfst:

  1. Welches Feld deine Klick-ID trĂ€gt. Wenn sie sagen „nimm aff_sub", Ă€ndere die Offer-Parameter des Netzwerks in Orbitra auf &aff_sub={subid} und den Postback auf subid={aff_sub}.
  2. Die Makro-Syntax. {sub1}, [SUB1], %sub1%, {{sub1}} — kopiere exakt, was sie verwenden.
  3. Status-Worte. Wenn sie status=1/2/3 oder russische Worte schicken, mappe sie mit &sale_status=
&lead_status=
&rejected_status=
 oder unter Conversion Types.
  4. Pro Offer vs. global. Ein globaler Postback deckt jeden Offer ab; einen Postback pro Offer musst du bei jedem Offer einzeln hinterlegen.

So testest du es

  1. Mache einen echten Klick ĂŒber den Kampagnen-Link (oder nimm einen Klick aus ⚙ → Logs → Traffic) und kopiere seine Klick-ID.
  2. ⚙ → Postback URL → Test Postback: fĂŒge die Klick-ID ein, wĂ€hle einen Status, klicke Test.
Postback testen
Postback testen
  1. Öffne ⚙ → Conversions — die Conversion ist da, und die ZĂ€hler der Kampagne Ă€ndern sich.

Viele Netzwerke haben außerdem einen „Test postback"-Button, der einen Request mit Fake-sub1 abschickt. Orbitra antwortet mit „click not found" — das ist erwartet und beweist, dass die URL erreichbar ist.

Das Conversion-Log
Das Conversion-Log

⚙ → Logs → Incoming Postbacks listet jeden eingegangenen Request auf, auch abgelehnte, mit dem Grund. Das ist die erste Anlaufstelle, wenn „das Netzwerk sagt, es hat geschickt, der Tracker zeigt nichts".

Conversions zurĂŒck an die Traffic-Quelle schicken (S2S)

Manche Traffic-Quellen (Push- und Pop-Netzwerke, TikTok, manche Native-Netzwerke) optimieren besser, wenn sie deine Conversions erhalten. Das ist ein ausgehender Postback, konfiguriert im Reiter S2S Postbacks der Kampagne. Hat das Template der Traffic-Quelle eine Postback-URL, bekommt eine neue Kampagne sie automatisch. Der Button Run test dort prĂŒft die gesamte Kette. Facebook und TikTok nutzen stattdessen ihre Conversions API — siehe Facebook / Meta.

Der Reiter S2S Postbacks der Kampagne
Der Reiter S2S Postbacks der Kampagne

Fehlerbehebung

SymptomWo du nachschaust
Nichts unter Incoming PostbacksDas Netzwerk hat dich nie aufgerufen: falsche URL in deren Dashboard, oder der Postback ist pro Offer fĂŒr einen anderen Offer hinterlegt
„Click not found"Die Klick-ID wird nicht ĂŒbergeben: prĂŒfe die Offer-Parameter des Netzwerks und das Makro im Postback
„Wrong key"Die URL enthĂ€lt einen alten Postback-Key. Ein vor der Key-Änderung angelegtes Netzwerk behĂ€lt den alten Key in seiner gespeicherten Postback URL — korrigiere den Key in dieser URL (Netzwerk-Editor) und aktualisiere sie im Netzwerk-Dashboard
Conversion mit Status custom verbuchtDas Status-Wort des Netzwerks ist nicht gemappt — korrigiere es unter Conversion Types
Payout ist 0Das Netzwerk ersetzt {payout} nicht oder schickt es unter anderem Namen — fĂŒge auf der Postback-Seite einen Parameter-Alias hinzu

Referenz: Postbacks und Conversions.

← ZurĂŒck
Offers und Affiliate-Netzwerke
Weiter →
Streams: Wie Traffic verteilt wird
Quelle auf GitHub ansehen: github.com/fenjo26/Orbitra.link/wiki
Alle Guides
Guide

Einsteiger-Guide: Hier starten

Eine Tour durch Orbitra, Bildschirm fĂŒr Bildschirm: was der Tracker tut, welche Begriffe dir begegnen und in welcher Reihenfolge du die Guides liest.

Guide lesen →
Guide

Deine erste Kampagne, Schritt fĂŒr Schritt

Von der frischen Installation bis zum funktionierenden Kampagnen-Link und einer Test-Conversion: Domain, Netzwerk, Offer, Quelle, Kampagne, Postback.

Guide lesen →
Guide

Domain verbinden

Domain hinzufĂŒgen, DNS auf den Tracker zeigen lassen, kostenloses SSL-Zertifikat holen — und was jeder Schalter auf der Domains-Seite bewirkt.

Guide lesen →
Guide

Offers und Affiliate-Netzwerke

Wie Offers und Netzwerke in Orbitra organisiert sind: Templates, Offer-Parameter und Payout-Einstellungen.

Guide lesen →
Guide

Postbacks: Was du deinem Affiliate-Manager sagst

Wie Conversions in Orbitra ankommen: die Postback-URL, Statuswerte und was du deinem Netzwerk copy-pasten kannst.

Guide lesen →
Guide

Streams: Wie Traffic verteilt wird

Was ein Stream ist, Schemas, Rotation und Gewichte — und wie Orbitra entscheidet, wohin ein Klick geht.

Guide lesen →
Guide

Stream-Filter

Land, Device, ISP, Bots und mehr: jeder Filter erklĂ€rt, mit Beispielen fĂŒr typische Routing-Setups.

Guide lesen →
Guide

Cloaking fĂŒr Einsteiger

Safe Page vs. Money Page, Filter-Ebenen, SensitivitĂ€t — und wie du deinen Cloak testest, bevor echter Traffic fließt.

Guide lesen →
Guide

Landingpages

Landingpages direkt im Tracker hosten: Landing-Typen, das {offer}-Makro, der JS-Adapter und Tracking-Pixel.

Guide lesen →
Guide

PWA-Apps

Aus einer Landingpage eine installierbare PWA bauen: Icon, Screenshots, Store-Eintrag und Limits.

Guide lesen →
Guide

Push-Benachrichtigungen an PWA-Nutzer

Push-Abonnenten aus PWA-Landingpages sammeln und ihnen Benachrichtigungen schicken — kostenloser Re-Engagement-Traffic.

Guide lesen →
Guide

Content Gallery

Icons, Screenshots und Creatives im Tracker speichern und in PWAs und Landingpages wiederverwenden.

Guide lesen →
Guide

Creatives und Creative-Testing

Nachvollziehen, aus welchem Creative ein Klick kam: SubID-Routing, eine Testkampagne und das Lesen des Reports.

Guide lesen →