PWA Funnel
Renderer v16 · Migration 51. Der Besuch einer PWA-Landingpage im Browser ist jetzt ein konfigurierbarer Funnel: eine geordnete Liste von Screens, bei der der erste aktivierte Schritt das ist, was ein kalter Besucher zuerst sieht, jede Screen-Aktivierung per Beacon gemeldet und im Report gezählt wird und jeder Screen sein eigenes Tracking-Skript mitbringen kann.
Das Funnel-Modell
Der Schlüssel funnel kommt in landings.config_json hinzu — ein geordnetes Array von Schritten:
"funnel": [
{ "id": "scr_k3x9_2a", "type": "screen", "enabled": true,
"template": "lobby", "title": "...", "text": "...",
"button": "...", "image": "...", "custom_html": "...", "custom_js": "..." },
{ "id": "store", "type": "store", "enabled": true },
{ "id": "instructions", "type": "instructions", "enabled": true },
{ "id": "push", "type": "push", "enabled": true }
]
Schritt-Typen:
| Typ | Was er rendert |
|---|---|
store | Den Google-Play-/App-Store-Eintrag (vorhandenes Markup; der User-Agent wählt das Layout) |
screen | Einen Operator-Screen: Template lobby / slot / wheel / custom als HTML — dieselben Templates, die der Screen der installierten App nutzt. Bis zu 5 pro Funnel |
instructions | Einen Installations-Anleitungs-Screen über die ganze Seite. Beide Plattform-Listen werden gerendert; über data-store (der UA-Sniff im <head>) zeigt CSS auf iOS die Safari-Schritte und sonst die Chrome-Menü-Schritte |
push | Die Push-Opt-in-Karte, platziert im Browser-Funnel. Nur wenn Push enabled — ohne VAPID-Key oder Browser-Support wäre der Schritt eine Sackgasse, deshalb überspringt der Flow ihn auch zur Laufzeit |
Regeln (PwaLanding::normalizeFunnel() ist die Whitelist, der Editor erzeugt nur Formen, die sie akzeptiert):
- IDs entsprechen
^[a-z0-9_]{1,32}$, sind eindeutig und kollidieren nie mit den eingebauten IDs; ungültige werden serverseitig neu generiert; - ein
store/ eininstructions/ einpushpro Funnel (Duplikate fallen weg); - maximal 5
screen-Schritte; - fehlender oder ungültiger
funnel→[store]. Jede Konfiguration von vor dem Funnel rendert exakt dasselbe wie vorher — der Store ist weiterhin der erste Screen,ios_flowregelt weiterhin das Install-Click-Overlay, die Push-Karte gehört weiterhin zur installierten App.
Flow-Semantik (Page-JS)
- Der erste aktivierte Schritt erscheint bei einem kalten Besuch; ein Nicht-Store-Erstschritt versteckt die Store-Layouts ab dem ersten Paint (
data-flow-first, gesetzt vom<head>-Skript, bevor der Body existiert). - Jede
.install-trigger-CTA im Flow springt zum nächsten aktivierten Schritt; sind die Schritte des Flows aufgebraucht, fällt die CTA auf den klassischen Install-Versuch zurück (nativer Prompt / iOS-Overlay / Redirect je nach Konfiguration). Der Operator entscheidet über die Reihenfolge des Funnels, wo der Install-Prompt feuert. - Die Push-Karte des Flows: Allow startet die normale Permission-Maschinerie (die Übergabe an sw.js bleibt unangetastet), Not now beantwortet den Schritt und geht weiter. Ist der Flow nach einer Push-Antwort am Ende, geht der Besucher zum Offer (
flowExhausted); mitapp_action = screenzeigt sich stattdessen der Screen der installierten App. - Die installierte App (Öffnen im Standalone) ist kein Teil des Flows: Der Standalone-Zweig — Open-Beacon, iOS-Install-Bestätigung, Push-Sync, danach
app_action— verhält sich genau wie vorher. - Die Timer
auto_redirect/decline_redirect/install_redirectbehalten ihre globale Bedeutung und feuern unabhängig vom sichtbaren Schritt in den Offer.
Tracking pro Screen
Jede Aktivierung eines Flow-Screens sendet einen Beacon an /pixel.gif?action=pwa&kind=screen&screen=<id>&subid=<click>:
clicks.pwa_entry_screen— der erste Screen, den der Klick je gesehen hat (NULL-geschützt; die Klick-Zeile ist das Dedup-Gate wie bei jederpwa_*-Spalte);clicks.pwa_last_screen— der Schritt, auf dem der Klick zuletzt war (last-write-wins);pwa_screen_views— das rohe 1:N-Event-Log (click_id, landing_id, screen, created_at), gedeckelt auf 100 Zeilen pro Klick, damit ein parkender Tab, der Screens durchrattert, die Tabelle nicht aufblähen kann. Migration 51 legt sie an; das immer aktive Self-Heal-DDL garantiert, dass sie in jeder Schema-Version existiert, weil der Report-SQL sie bedingungslos referenziert.
Jeder screen-Schritt kann außerdem custom_js mitbringen (das Feld „Screen tracking script" im Editor). Es läuft bei der ersten Aktivierung des Screens, nicht beim Parsen der Seite — ein Ad-Pixel darf nicht für einen Screen feuern, den der Besucher nie erreicht hat. Die interaktiven Engines der Templates (Slot-Walzen, Bonus-Rad) wurden in Factories pro Container refaktoriert, damit mehrere Kopien desselben Templates auf einer Seite koexistieren können; Element-IDs bekommen pro Schritt ein Präfix (fs<id>_…). Helfer für eigene Skripte: window.orbitraFlow.next(), window.orbitraFlow.goto(id), plus die bestehenden orbitraRedirect / orbitraBeacon.
Statistiken
pwa_screen_views-Metrik — Flow-Screen-Views insgesamt, aggregiert in den Dashboard-Karten, der Kampagnen-Liste,campaign_reportund den Landings- und Offers-Tabellen (gleicher Stand in Report und Kampagnen). Ein Klick trägt legitim mehrere Views bei; darauf sitzt keine abgeleitete Kennzahl.pwa_entry_screen/pwa_last_screen-Dimensionen — schlichte Clicks-Spalten, registriert in$allowed_dimensions(api.php,campaign_report); beide funktionieren als Group-By-Ebene und als Filter. NULL (Zeilen vor dem Feature, Nicht-PWA-Traffic) gruppiert als Unknown.pwa_funnel_stats-Endpoint — die Funnel-Karte pro Landing auf der Landings-Seite (der Balkendiagramm-Button in PWA-Zeilen): Views/Uniques pro Screen, Entry- und Exit-Verteilungen (ein Exit = der letzte Screen des Klicks ohne Offer-Übergang) und die Screen-zu-Screen-Übergangsmatrix, abgeschritten aus dem geordneten Event-Log. Die Screen-Reihenfolge folgt zuerst der Funnel-Konfiguration.
Editor und Vorschau
Schritt 1 des PWA-Builders hat den Abschnitt Visit funnel bekommen: eine umsortierbare Schrittliste (Ziehen am Griff, ↑/↓-Buttons), Enable-Toggles, das First-Screen-Badge, Editoren pro Screen (Template, Titel/Text/Button, Hero-Bild über den MediaPicker, Custom-HTML + Tracking-JS) und eine Kapazitätsanzeige (0/5). Die Live-Vorschau kann den Funnel an jedem aktivierten Schritt öffnen — pwa_preview akzeptiert eine Schritt-ID als view und erzwingt sie über window.__PWA_FORCE_SCREEN.
Renderer-Version und Self-Heal
RENDERER_VERSION von 15 auf 16 erhöht: Die Lander-Route und der Domain-Root-Server regenerieren beim nächsten Aufruf die Statics, die der ältere Renderer geschrieben hat, sodass bereits angelegte PWAs den Flow-Boot (und den Store-Screen-View-Beacon) ohne erneutes Speichern bekommen. Alte Konfigurationen regenerieren mit dem [store]-Funnel und bleiben optisch identisch.
Tests
tests/pwa_funnel_http_test.php— das Funnel-Konfigurationsmodell, das Flow-Markup, Beacon-Dedup/Cap/Attribution und den Funnel-Stats-Endpoint (HTTP, Harness-Sandbox).tests/report_metrics_test.php— handgerechnete Pins fürpwa_screen_viewsim Dashboard und im Landings-/Offers-SQL (1:N-Views: ein Klick trägt jeden Screen bei, den er gesehen hat, Revisits eingeschlossen).
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 →