Docs

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.

TypWo sie lebtOffer-Link
Localhochgeladenes ZIP, ausgeliefert vom Tracker{offer} oder /?_lp=1
Redirectdein eigenes Hosting, eine andere Domain/?_lp=1 + der JS-Adapter
Preloadvom Tracker geholt, gezeigt unter deiner Domain{offer}
Actionnichts 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

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:

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:

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:

MakroWert
{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:

ActionErgebnis
Send to campaignübergibt den Besucher an eine andere Kampagne; der Klick zählt in beiden
Show a 404 errorleere Seite, Status 404
Show as textder eingegebene Text, als text/plain
Show as HTMLdas eingegebene HTML
Do nothingleere 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

  1. Die Einstiegsseite ist index.php.
  2. 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.
  3. Binde andere Dateien über den absoluten Pfad ein:
   require_once dirname(__FILE__) . '/src/lib.php';   // right
   require_once 'src/lib.php';                        // wrong
  1. 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, und disable_functions und open_basedir in deiner php.ini gelten 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

Telefon-Validierung für 150 Geo-Märkte & Client-Adapter (orbitra_adapter.js)

Ist er aktiviert, injiziert LeadForge orbitra_adapter.js, mit:

Universal-CPA-Order-Bridge (order.php)

Erzeugt einen eigenständigen, in sich geschlossenen Order-Handler für 10 CPA-Netzwerke:


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.

← Zurück
Browser check
Weiter →
PWA und Web Push
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 →