Docs

Cloaking (Referenz)

Das Stream-Schema Cloaking teilt den Traffic in zwei Zweige: Verdächtige Besucher (Bots, Moderatoren, Datacenter, VPNs) sehen die Safe Page, echte Menschen die Money Page. Ein Modul (core/CloakDetector.php) trifft die Entscheidung für alle Einstiegspunkte: die Kampagnen-URL (index.php), click.php und Click API v3.

Eine ausführliche technische Abhandlung auf Englisch: How the Orbitra Cloaker Works.

Stream-Einrichtung

Safe page

Eingebautes HTML, eine externe URL, eine lokale Landingpage oder ein lokaler Offer. Landings und Offers in der Liste sind nach Gruppe sortiert, mit Suche.

Money page

Funktioniert wie das Schema „Landing + Offer“, einschließlich der Offer-Auswahl „before the click / after the click“.

„Send clean visitors to the next stream“

Das Checkbox-Häkchen „Send clean visitors to the next stream“ macht aus dem Cloak einen Eingangsfilter. Verdächtige Besucher bekommen die Safe Page, während saubere die Stream-Liste weiter hinunterlaufen — Geo, Devices und Sprachen werden von Regular-Streams aufgeteilt. Die Money Page dieses Streams wird in diesem Modus nicht verwendet. Setze so einen Stream an den Anfang oder mach ihn Intercepting, sodass jeder Besucher die Prüfung durchläuft.

Detection layers

LayerQuelleFunktioniert nicht ohne
Data centers / hostingEine ASN-Blocklist (core/data/asn_blocklist.json), veröffentlichte Cloud- und Crawler-Bereiche, Hosting-Keywords im ISP-NamenDie ASN-Datenbank (GeoLite2-ASN)
VPN / proxyIP2Proxy PX12 (VPN, TOR, Residential, Threat, Fraud Score ≥ 80), eine VPN-ASN-ListeIP2Proxy PX12 / die ASN-Datenbank
Bot blacklistsIPs und User-Agent-Signaturen aus Settings → Bots—
User-Agent heuristicsCrawler und Tools (facebookexternalhit, meta-externalagent, curl, python, headless…), ein leerer User-Agent, ein fehlendes Accept-Language—

Fehlt eine benötigte Datenbank, zeigt der Kampagnen-Editor direkt in der Cloak-Karte eine Warnung.

Sensitivity

Signale sind entweder hart (ein eindeutiger Treffer in einer Blocklist oder Reputations-Datenbank) oder weich (für sich genommen verrauschte Heuristics).

LevelSafe Page, wenn
Lownur ein hartes Signal
Medium (Standard)ein hartes Signal, oder zwei weiche
Highjedes einzelne Signal

Targeting filters

Werden nach den passiven Layern angewendet; ein Nicht-Passen bedeutet die Safe Page (TARGETING_SAFE):

JavaScript-Verifizierung

Standardmäßig aus. Der Besucher bekommt zuerst die Safe Page und gelangt über einen einmalig signierten Link (TTL 5 Minuten) nur dann zur Money Page, wenn er JavaScript ausführt. navigator.webdriver = true bleibt auf der Safe Page. Ebenso alles, was kein JS ausführt. Der Preis: ein zusätzlicher Hop für jeden echten Besucher.

Ist der Browser check an (Settings → Bots), sammelt derselbe Schritt auch Browser-Signale: Im Soft- oder Strict-Modus bekommt eine virtuelle Maschine, ein Emulator oder ein gespooftes Phone hier die Safe Page, mit einem bc_-Grund. Das Feld Browser check* des Streams kann das nur für diesen Stream abschalten.

Preloader. Während der JS-Schritt läuft (ein Bruchteil einer Sekunde), sieht der Besucher eine Ladeseite, konfiguriert pro Stream unter JS Challenge Preloader: die eingebaute Seite oder dein eigenes HTML mit Live-Vorschau. Früher nutzte dieser Schritt das HTML der Safe Page — dieses Markup wird weiterhin gezeigt, wenn kein Preloader konfiguriert ist, sodass bestehende Kampagnen ihren Look behalten; wähle Custom HTML, um es zu überschreiben. Die Verifizierungs-Sonde wird automatisch in dein HTML injiziert — füge keine eigenen Redirect-Scripts hinzu, sie liefern ein Rennen gegen den signierten Link.

Aufzeichnung und Reports

EinstellungStandardWas sie tut
Record Safe Page clicksanSafe-Page-Treffer werden mit is_safe_page = 1 geschrieben. Schaltest du es aus, erreichen sie die Datenbank nicht
Exclude Safe Page clicks from reportsanTreffer bleiben im Klick-Log, fallen aber aus jeder Report-Metrik heraus — Klicks, Visits, Uniques, Bots, leere Referer, Kosten, CPV. Ein Safe-Treffer ist weiterhin ein Visit des Kampagnen-Links, zählt also mit ausgeschalteter Box auch in „Clicks“ (seit 1.8.5 zählen Klicks jeden Visit)

Auch wenn Treffer nicht geschrieben werden, zählt der Unterdrückungs-Zähler (cloak_suppressed_stats) sie pro Kampagne, Stream, Tag und Urteil mit — „null Klicks“ wird den echten Traffic nicht verstecken.

Globale Einstellungen: Settings → Bots

Diagnostik

Verdicts und Gründe

Verdicts: money, passive_safe, targeting_safe, js_safe. Gründe werden in clicks.cloak_reasons geschrieben; die wichtigsten:

CodeBedeutung
geo_country / geo_unknownLand nicht in der Liste / Land ließ sich nicht bestimmen
device_typeDevice-Typ nicht erlaubt
bot_isp, isp_blocklistISP in der Bot- und Datacenter-Liste
datacenter_asn, asn_datacenterDatacenter- oder Hosting-ASN
vpn_proxy_asnASN eines VPN- oder Proxy-Providers
iprange_datacenterIP in einem veröffentlichten Cloud- oder Crawler-Bereich
hosting_ispHosting-Keyword im ISP-Namen
ip2proxy_*Ein IP2Proxy-Signal: vpn_proxy, datacenter, residential, tor, bot, threat, high_fraud
bot_blocklistIP in der Bot-Liste
crawler_or_tool_ua, suspicious_ua, no_user_agent, missing_accept_languageUser-Agent- und Header-Heuristics
webdriver, js_missing, js_fingerprintJavaScript-Verifizierung

Häufige Probleme

SymptomWas zu prüfen ist
Das Ad-Dashboard zeigt Klicks, der Tracker nullOb die Safe-Page-Klick-Aufzeichnung aus ist; der Unterdrückungs-Zähler
100 % des Traffic auf der Safe PageOb die Geo-Datenbank installiert ist (⚙ → Geo databases); geo_unknown-Gründe im Klick-Log
Echte Mobile-User auf der Safe PageGrund ip2proxy_vpn_proxy — nimm den VPN/Proxy-Layer heraus (er ist ein hartes Signal; Low-Sensitivity hebt es nicht auf)
Meta- oder Telegram-Reviewer erreichen den OfferIhre Netzwerke werden per ASN nicht als Datacenter markiert; ein einzelner Bereichs-Treffer ist bei mittlerer Sensitivität nur ein weiches Signal. Erhöhe die Sensitivity oder ergänze einen „Bot“-Filter auf einem Intercepting-Stream
← Zurück
Kampagnen und Streams
Weiter →
Browser check
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 →