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
| Layer | Quelle | Funktioniert nicht ohne |
|---|---|---|
| Data centers / hosting | Eine ASN-Blocklist (core/data/asn_blocklist.json), veröffentlichte Cloud- und Crawler-Bereiche, Hosting-Keywords im ISP-Namen | Die ASN-Datenbank (GeoLite2-ASN) |
| VPN / proxy | IP2Proxy PX12 (VPN, TOR, Residential, Threat, Fraud Score ≥ 80), eine VPN-ASN-Liste | IP2Proxy PX12 / die ASN-Datenbank |
| Bot blacklists | IPs und User-Agent-Signaturen aus Settings → Bots | — |
| User-Agent heuristics | Crawler 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).
| Level | Safe Page, wenn |
|---|---|
| Low | nur ein hartes Signal |
| Medium (Standard) | ein hartes Signal, oder zwei weiche |
| High | jedes einzelne Signal |
Targeting filters
Werden nach den passiven Layern angewendet; ein Nicht-Passen bedeutet die Safe Page (TARGETING_SAFE):
- Countries — eine Liste zulassen oder blockieren. Lässt sich das Land nicht bestimmen, wird als Grund
geo_unknownstattgeo_countryprotokolliert. Ohne Geo-Datenbank ist jeder BesucherUnknown, und der Länderfilter schickt 100 % des Traffic auf die Safe Page; der Editor warnt davor. - Device types — nur die ausgewählten, oder alle außer den ausgewählten.
- Block bots and data-center providers — ISP und ASN des Besuchers, abgeglichen gegen eine Liste: die lokale Liste des Streams oder, wenn sie leer ist, die globale aus Settings → Bots.
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
| Einstellung | Standard | Was sie tut |
|---|---|---|
| Record Safe Page clicks | an | Safe-Page-Treffer werden mit is_safe_page = 1 geschrieben. Schaltest du es aus, erreichen sie die Datenbank nicht |
| Exclude Safe Page clicks from reports | an | Treffer 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
- Bot IP addresses — IPs und CIDR, IPv4 und IPv6. Jeder Eintrag hat eine Quelle (manuell oder aus einem Feed); das Aufräumen kann Einträge einer einzelnen Quelle löschen.
- Signatures (User-Agent) — Teilstrings.
- Global Bot ISP blacklist — ein Provider pro Zeile. Zu kurze und zu generische Strings (
Inc,LLC) werden ignoriert: Sie würden auf fast jeden ISP passen. - Data-center and crawler IP ranges — veröffentlichte Bereiche von AWS, Google Cloud und Googlebot, Bing, Azure, Oracle, DigitalOcean, Facebook, Telegram, OpenAI, Cloudflare, Apple Private Relay und weiteren aus lord-alfred/ipranges. Täglich aktualisiert vom Cron
ipranges_cron.php(manuell über den Button „Update now“ oderphp ipranges_cron.php --force), gespeichert invar/ipranges/. Bis die Listen geladen sind, bleibt der Layer inaktiv. - Browser check — Off / Observe only / Soft / Strict: Bots, VMs und Emulatoren, erwischt an Widersprüchen im Browser. → Browser check
- Treat VPN ASN as a bot signal — standardmäßig an. Schalte es aus, wenn dein Publikum breit hinter kommerziellen VPNs sitzt.
Diagnostik
- Die Cloak-Karte im Editor — wie viele Treffer im gewählten Zeitraum zur Money Page und zur Safe Page gingen, die häufigsten Gründe und ein Link ins Klick-Log mit demselben Zeitfenster. Geht fast der gesamte Traffic auf die Safe Page, warnt die Karte.
- Das Klick-Log — die Spalten „Route“ und „Reason“ erscheinen automatisch, sobald Cloak-Klicks auf der Seite sind, mit Filter nach Route und Grund. Die Klick-Karte zeigt Urteil und Gründe, aber nur für Klicks, die der Cloak tatsächlich beurteilt hat.
- Der Test-Link mit
_dbg=1— ein Routing-Trace ohne einen Klick zu schreiben;_geo=XXüberschreibt das Land (Kampagnen und Streams). - Das PHP-Log — Zeilen wie
Orbitra cloak [campaign=12 stream=34]: stage=PASSIVE_SAFE ... reasons=[crawler_or_tool_ua].
Verdicts und Gründe
Verdicts: money, passive_safe, targeting_safe, js_safe. Gründe werden in clicks.cloak_reasons geschrieben; die wichtigsten:
| Code | Bedeutung |
|---|---|
geo_country / geo_unknown | Land nicht in der Liste / Land ließ sich nicht bestimmen |
device_type | Device-Typ nicht erlaubt |
bot_isp, isp_blocklist | ISP in der Bot- und Datacenter-Liste |
datacenter_asn, asn_datacenter | Datacenter- oder Hosting-ASN |
vpn_proxy_asn | ASN eines VPN- oder Proxy-Providers |
iprange_datacenter | IP in einem veröffentlichten Cloud- oder Crawler-Bereich |
hosting_isp | Hosting-Keyword im ISP-Namen |
ip2proxy_* | Ein IP2Proxy-Signal: vpn_proxy, datacenter, residential, tor, bot, threat, high_fraud |
bot_blocklist | IP in der Bot-Liste |
crawler_or_tool_ua, suspicious_ua, no_user_agent, missing_accept_language | User-Agent- und Header-Heuristics |
webdriver, js_missing, js_fingerprint | JavaScript-Verifizierung |
Häufige Probleme
| Symptom | Was zu prüfen ist |
|---|---|
| Das Ad-Dashboard zeigt Klicks, der Tracker null | Ob die Safe-Page-Klick-Aufzeichnung aus ist; der Unterdrückungs-Zähler |
| 100 % des Traffic auf der Safe Page | Ob die Geo-Datenbank installiert ist (⚙ → Geo databases); geo_unknown-Gründe im Klick-Log |
| Echte Mobile-User auf der Safe Page | Grund 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 Offer | Ihre 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 |
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 →