Landingpages (Referenz)
Eine Landingpage ist die Seite, die ein Besucher auf dem Weg zum Offer sieht. Orbitra serviert vier Arten, und die Unterschiede liegen vor allem in einer Frage: wie der Kauf-Button den Offer erreicht.
| Typ | Wo sie lebt | Offer-Link |
|---|---|---|
| Local | hochgeladenes ZIP, ausgeliefert vom Tracker | {offer} oder /?_lp=1 |
| Redirect | dein eigenes Hosting, eine andere Domain | /?_lp=1 + der JS-Adapter |
| Preload | vom Tracker geholt, gezeigt unter deiner Domain | {offer} |
| Action | nichts wird gezeigt; der Tracker tut etwas | — |
Lokale Landingpages
Das Archiv wird nach landings/<landing id>/ entpackt. Der Einstiegspunkt ist index.html, oder index.php, wenn PHP-Landingpages aktiviert sind.
Anforderungen
- Die Einstiegsseite muss
index.html(oderindex.php) heißen. - Benutze relative Pfade:
img/hero.jpg, nicht/img/hero.jpg. Beides funktioniert, aber relative Pfade gehen auch, wenn du das Archiv lokal öffnest. - Kein interner Redirect zu
index.html— sonst verlässt der Besucher die getrackte URL.
Anders als Keitaro fügt Orbitra kein <base>-Tag hinzu und schreibt dein Markup nicht um. Die Seite wird Byte für Byte so ausgeliefert, wie du sie hochgeladen hast, und ihre Dateien werden gegen die Landingpage aufgelöst, die gezeigt wurde. Zwei Folgen, die du kennen solltest:
- Ein eigenes
<base>-Tag bleibt unangetastet. - Anker-Links (
href="#form"), Popup-Scripts und Smooth Scrolling funktionieren weiter. In Keitaro brechen sie, weil es jedeshrefumschreibt.
Mit dem Offer verlinken
Die einfachste Form — und die, nach der du greifen solltest:
<a href="{offer}">Buy</a>
{offer} wird durch den signierten Landing→Offer-Übergang ersetzt (seit 1.6.14, passend zu Keitaro): Der Klick läuft durch den Tracker, der Funnel wird also gezählt, und die Makros des Offers werden beim Redirect eingesetzt. Vor 1.6.14 bettete er die direkte URL des Advertisers ein, die den Tracker übersprang — Streams mit „Offer selection: before“ zeigten null Klicks.
Mit mehreren Offers auf einer Seite funktioniert jede Form — die explizite in jeder Version:
<a href="/?_lp=1&offer_id=10">Offer 10</a>
<a href="{offer}&offer_id=22">Offer 22</a>
Ein angehängtes &offer_id= an {offer} wechselt den Offer (seit 1.6.14): {offer} expandiert zum signierten Übergangs-Link, der Tracker liest also den Parameter und attributiert den Klick neu — eine Conversion landet auf dem Offer, den du genannt hast. Vor 1.6.14 expandierte {offer} zur direkten URL des Advertisers und der Parameter wurde nur an ihn durchgereicht; die explizite Form /?_lp=1&offer_id=N funktioniert in jeder Version.
Die Weitergabe einer auf der Landingpage getroffenen Wahl (ein Produkt, ein Tarif oder eine Quiz-Antwort) funktioniert auf die Keitaro-Art: hänge sub_id_1 … sub_id_30 an den Übergangs-Link, und sie aktualisieren den Klick.
<a href="/?_lp=1&sub_id_5=Blue%20Watch&sub_id_6=https%3A%2F%2Fcdn.example%2Fblue.jpg">Buy the blue one</a>
Die Offer-URL nimmt sie dann als {sub_id_5} / {sub_id_6} auf, z. B. https://network.example/?sub1={clickid}&product={sub_id_5}&image={sub_id_6}. Die Werte werden auch in den Klick geschrieben, sodass Reports und Postbacks dasselbe sehen. Akzeptiert werden nur sub_id_N-Keys, leere Werte löschen nie, was die Traffic-Quelle geschickt hat, und jeder Wert ist auf 512 Bytes begrenzt. Auf einer Landingpage, die anderswo liegt, hänge sie an den signierten Link an: {lp_url}&sub_id_5=….
Seit 1.6.14 funktioniert auch {offer}&sub_id_5=… — das Makro ist selbst der Übergangs-Link, der Tracker liest also, was du ihn anhängst. Ist der Wert schon vor dem Klick bekannt (ein Produkt pro Kampagne), überspringe den Landingpage-Schritt ganz und setze ?sub_id_5=… in den Kampagnen-Link.
Time on LP
Nichts der Seite hinzuzufügen: Jede Landingpage, die der Tracker ausliefert, bekommt einen kleinen Timer injiziert, vor </body>. Er meldet, wie lange der Besucher geblieben ist — ob er je den Offer-Button gedrückt hat oder nicht, und das ist der Unterschied zu Time to Offer: eine Seite, auf der niemand durchklickt, meldet bei der älteren Metrik nichts, und genau solche Seiten findet man.
Was er misst — und was er mit Absicht nicht misst:
- nur sichtbare Zeit — ein Tab im Hintergrund akkumuliert nicht;
- die tiefste Scroll-Position, 0-100 %, neben den Sekunden;
- Checkpoints bei 5, 15, 30 und 60 Sekunden und danach jede Minute, plus ein finaler Flush, wenn die Seite versteckt oder entladen wird — auch ein geschlossener Tab hinterlässt eine Zahl.
Wo er auftaucht: die Spalte Time on LP in den Logs (Werte unter 5 Sekunden sind hervorgehoben) und in den Klick-Details, sowie in Reports als die Metriken Time on LP, LP bounce rate, LP scroll depth und LP measured visits plus der Dimension Time on LP (bucket). Ein Visit, der nie gemeldet hat — eine Redirect-Landingpage auf fremder Domain ohne das Tracking-Script, ein Bot ohne JS — gruppiert als Unknown, statt als Null-Sekunden-Visit zu zählen.
Für eine Landingpage, die anderswo liegt, kommt derselbe Timer in tracking.js / kclient.js mit; eine PHP-Seite gibt $client->timerScript() aus (siehe Tracking Client (PHP)).
Session-Aufzeichnung und Heatmap
Der Reiter Session recording im Landing-Editor schaltet für diese Landingpage Clarity-artige Aufzeichnungen ein: ein Anteil der Besucher (5–100 %), wie lange aufgezeichnet wird, und die gemeinsamen Speicher-Limits. Aufzeichnungen laufen unter ⚙ → Logs → Session recordings; derselbe Reiter öffnet die Klick-Heatmap und die Scrollmap der Landingpage. Lokale und „Show HTML“-Landings brauchen nichts Extra; externe Seiten zeichnen über tracking.js / kclient.js / kclient.php auf. Formularfelder werden im Browser des Besuchers maskiert. → Session-Aufzeichnungen und Klick-Heatmaps
Makros
Ersetzt im HTML einer lokalen Landingpage:
| Makro | Wert |
|---|---|
{offer} | signierter Landing→Offer-Übergang (/index.php?_lp=1&_token=…, seit 1.6.14 — der Klick läuft durch den Tracker, der Funnel zählt also, und angehängte &offer_id= / &sub_id_N-Parameter erreichen ihn; derselbe Wert wie {lp_url}) |
{lp_url} | derselbe signierte Übergang, geschrieben für externe Landingpages |
{offer_id} | die ID des gebundenen Offers |
{clickid}, {subid} | die Klick-ID |
{token} | signiertes Token, vom JS-Adapter genutzt |
{keyword}, {sub_id_1} … {sub_id_30} | Klick-Parameter, aus der Traffic-Quelle erfasst |
Aus der URL genommene Werte werden HTML-escaped. Alles andere bleibt unberührt — {unknown}, JS-Template-Literale, Vue- und Angular-Syntax überleben alle.
Ohne Offer am Stream wird {offer} zu einem unsignierten Übergangs-Link, der beim Klick die Fehlkonfiguration erklärt, statt die Seite still neu zu laden.
Redirect-Landingpages (extern)
Die Landingpage liegt auf deinem eigenen Hosting. Der Tracker schickt den Besucher dorthin und hängt zwei Parameter an:
https://your-landing.example/promo?_subid=<click id>&_token=<signed token>
Das Token ist der Grund, warum der Offer-Link überhaupt funktioniert. Eine Landingpage auf einer anderen Domain kann die Cookies des Trackers nicht lesen, ohne das Token hat der Tracker also keine Möglichkeit zu erkennen, welcher Klick zurückkommt. Es ist mit HMAC-SHA256 signiert und läuft nach 24 Stunden ab; ein nacktes _subid aus der URL wird nicht allein akzeptiert — sonst könnte jeder einen Visit auf jede ihm genehme Klick-ID attributieren. Eine lokale oder Preload-Landingpage holt den Klick stattdessen aus ihrem Cookie und braucht das Token nicht.
Ein {offer} in der URL der Landingpage selbst wird zu demselben Übergang, absolut (http://your-tracker/index.php?_lp=1&_token=…) — eine Landingpage, die ihren CTA aus einem Query-Parameter nimmt, bekommt also ebenfalls einen funktionierenden Link. Beide Verhaltensweisen brauchen v1.6.14; vorher kam das Paar nie wirklich an und {offer} bettete die direkte URL des Advertisers ein.
Installiere den JS-Adapter und verlinke den Offer als:
<a href="/?_lp=1">Buy</a>
Der Adapter schreibt das in einen absoluten Link zum Tracker um und ergänzt _subid und _token.
Preload-Landingpages
Der Tracker holt deine Seite server-seitig, injiziert <base href>, sodass Bilder und Styles weiterhin vom ursprünglichen Host laden, wendet die Makros an und serviert das Ergebnis unter deiner Domain — ohne Redirect. Benutze {offer} für den Offer-Link.
Action-Landingpages
Nichts wird gezeigt. Wähle, was passiert:
| Action | Ergebnis |
|---|---|
| Send to campaign | übergibt den Besucher an eine andere Kampagne; der Klick zählt in beiden |
| Show a 404 error | leere Seite, Status 404 |
| Show as text | der eingegebene Text, als text/plain |
| Show as HTML | das eingegebene HTML |
| Do nothing | leere Antwort; der Besucher bleibt, wo er ist |
{offer}, {clickid} und die Klick-Parameter werden in den Text- und HTML-Varianten ersetzt.
Keitaro übergibt den Besucher ohne Redirect an eine andere Kampagne. Orbitra nutzt einen Redirect: den Tracker im selben Request erneut zu betreten hieße, sein Entry-Script zweimal einzubinden — das kann PHP nicht. Der Klick wird so oder so in beiden Kampagnen geschrieben — der Besucher macht nur einen zusätzlichen Hop.
JS-Adapter
<script src="https://your-tracker/js/orbitra-adapter.js"
data-postback="https://your-tracker/POSTBACK_KEY/postback"></script>
Füge ihn in den <head> jeder Seite ein. Das Panel zeigt das Snippet mit deinem eigenen Key eingetragen, unter den Einstellungen der Landingpage.
Erforderlich für eine Redirect-Landingpage. Optional, aber nützlich bei einer lokalen mit mehreren Seiten: Er trägt den Klick auf innere Seiten und Formulare, sodass Seite zwei immer noch weiß, wer der Besucher ist.
Er lässt mit Absicht unangetastet, was der Adapter von Keitaro umschreibt: #anchors, mailto:, tel: und javascript:-Links bleiben unberührt, und Links zu Drittanbieter-Domains erhalten nie deine Klick-ID.
Conversion von der Seite melden
<a href="{offer}" onclick="orbitraPostback(this, event, 'lead', 10)">Buy</a>
Argumente: das Element, das Event, ein Conversion-Status, ein optionaler Payout und eine optionale Transaktions-ID. Die Navigation läuft auch dann weiter, wenn der Postback scheitert — einen Sale an einen Melde-Hänger zu verlieren wäre das schlechtere Geschäft.
Für einen Formular-Handler ist PHP einfacher:
file_get_contents('https://your-tracker/POSTBACK_KEY/postback?subid=' . urlencode($_COOKIE['subid']) . '&status=lead');
PHP-Landingpages
Standardmäßig aus. Aktiviere sie unter Settings → General → Allow PHP landings — und nur für Landingpages, deren Code du vertraust: Eine PHP-Landingpage läuft im Tracker, im Web-Root.
Anforderungen
- Die Einstiegsseite ist
index.php. - Diese Aufrufe werden beim Upload abgelehnt:
exec,system,shell_exec,passthru,proc_open,popen,pcntl_exec,pcntl_fork,dl,eval,assert,create_function,symlink,link,set_time_limit,ini_set,ini_alter. - Binde andere Dateien über den absoluten Pfad ein:
require_once dirname(__FILE__) . '/src/lib.php'; // right
require_once 'src/lib.php'; // wrong
- Halte die Ausführung unter dem Timeout (standardmäßig 3 Sekunden, maximal 9). Setze Timeouts bei jedem curl-Aufruf:
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3);
curl_setopt($ch, CURLOPT_TIMEOUT, 3);
Den Klick lesen
<?php
$clickId = $rawClick->get('click_id');
$keyword = $rawClick->get('keyword');
$offer = $rawClick->get('offer'); // the offer URL, same as {offer}
$rawClick ist read-only. Um eine Conversion zu schreiben, schicke einen Postback.
Der Scan ist keine Sandbox. Er liest den hochgeladenen Quellcode mit PHPs eigenem Tokenizer und sieht also echte Aufrufe statt Wörter in Kommentaren — aber
$f = 'sys' . 'tem'; $f();überlistet ihn, wie es die äquivalente Prüfung in jedem anderen Tracker überlistet. Was das Risiko tatsächlich eindämmt: Die Funktion ist standardmäßig aus, nur ein Admin kann sie einschalten, unddisable_functionsundopen_basedirin deinerphp.inigelten für eine Landingpage genau wie für alles andere. Setze sie.
LeadForge 2.0 (Landing Analyzer, JS-Validierung & Multi-Network-Bridge)
LeadForge 2.0 ist Orbitras eingebaute Engine zum Analysieren, Bereinigen und Neuanpassen von Landingpage-Bundles an Ziel-Affiliate-Netzwerke.
Integrations-Modi
- Auto Mode: Erkennt das Quell-Netzwerk automatisch aus Code-Signaturen und leitet Formular-Absendungen an das Ziel-Netzwerk weiter.
- Cross-Network Mode: Entfernt alte Netzwerk-Order-Handler (
send.php,order.php,api.php), räumt fremde Tracking-Pixel/Scripts weg und installiert die universelle Multi-Network-Bridge. - Raw Mode (Clone Patch): Entfernt fremde Counter und Scripts, injiziert die ClickID/SubID-Bridge und
{offer}-Makros, ohne Backend-Handler zu erzeugen.
Telefon-Validierung für 150 Geo-Märkte & Client-Adapter (orbitra_adapter.js)
Ist er aktiviert, injiziert LeadForge orbitra_adapter.js, mit:
- 150 Länder-Regeln: Exakte nationale und internationale Regex-Muster, Prüfungen der Mobilfunk-Vorwahlen und Min-/Max-Längen-Grenzen.
- Dynamischer Länderwechsel: Aktualisiert Validierungs-Regeln, Längen-Grenzen und Counter-Helfer automatisch, wenn der User
<select name="country">ändert. - Interaktive Live-Input-Badges: Echtzeit-Counter mit eingegebenen und fehlenden Ziffern (z. B. «3 cifre inserite, 7 mancanti» → «Numero complete»).
- Strikte Unicode-Namen-Validierung: Echtzeit-Filter, der Ziffern und Spam-Zeichen in Kundennamen verhindert.
- Haptisches Vibrations-Feedback: Lässt mobile Geräte bei ungültigen Telefonformat-Versuchen vibrieren.
- ClickID-/SubID-Bridge: Erfasst alle eingehenden Tracking-Parameter (
subid,click_id,sub1..sub5,utm_*,fbp,fbcusw.) und befüllt Formularfelder über Mehrseiten-Funnels.
Universal-CPA-Order-Bridge (order.php)
Erzeugt einen eigenständigen, in sich geschlossenen Order-Handler für 10 CPA-Netzwerke:
- Dr.Cash, Webvork (mit SuperClient-Fallback), Lucky.online, KMA.biz, TerraLeads (mit SHA1-Checksum-Verifizierung), Leadbit, LemonAD, Everad, Ezaff und Custom Webhooks.
- Automatisierte E.164-Normalisierung: Vereinheitlicht lokale Telefonnummern ins internationale Format mit Länder-Vorwahlen-Abgleich.
- CRM-Dual-Logging: Sendet den Lead gleichzeitig ans Affiliate-Netzwerk und schreibt einen vollständigen Roh-Snapshot des Leads in das Orbitra-CRM-Vault (
orbitraCrmRecordLead//crm-ingest). - Failsafe-Local-Logging: Hängt Leads an
leadforge.leads.logundorbitra_leads_backup.logan.
Fehlerbehebung
Bilder und Video laden nicht. Benutze relative Pfade. Sind sie korrekt und die Seite kommt trotzdem nackt, prüfe, dass du die Kampagnen-URL öffnest und nicht direkt landings/<id>/index.html.
Der Kauf-Button führt nirgendwohin. Die Landingpage zeigt vermutlich noch direkt auf den Advertiser — eine Landingpage, die aus jemandes anderem Funnel kopiert wurde, behält dessen Affiliate-Link. Ersetze diese hrefs durch {offer}.
Landing transition failed: original click not found. Eine Landingpage auf einer anderen Domain ohne den JS-Adapter, oder ein Besucher mit deaktivierten Cookies und ohne _token in der URL.
no offer attached to this stream. Der Stream hat eine Landingpage, aber keinen Offer. Füge einen hinzu, oder lasse die Landingpage als letzte Seite und streiche den Offer-Link.
Eine PHP-Landingpage zeigt „disabled on this tracker“. Die Funktion ist aus; siehe oben.
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 →