Docs

PWA und Web Push

Eine PWA-Landingpage ist eine lokale Landingpage, die Orbitra zu einer vollwertigen Web-App ausbaut: ein „App-Store“-Storefront, ein Manifest und ein Service Worker. Zusammen mit dem Web Push-Modul kannst du direkt auf dem Storefront eine Abonnenten-Basis aufbauen und ihr Pushes schicken — komplett in Eigenregie, ohne externe Dienste (FCM dient nur als Android-Transport, Apple als iOS-Transport; die Keys und die Datenbank gehören dir).

Dieses Dokument behandelt: den PWA-Builder, die App-Installation, die Domain-Bindung, die Funnel-Instrumentierung, die Abonnenten-Basis, Messages (manuell und ereignisgesteuert), den Versand-Cron und die Fehlerbehebung.


1. PWA-Landingpage: was sie ist und wie sie funktioniert

1.1 Wie es unter der Haube funktioniert

1.2 Der Builder

Landings → Add PWA (oder „Duplicate“ auf einer bestehenden). Die Hauptblöcke des Editors:

BlockWas er konfiguriert
GeneralApp-Name, Slug, Gruppe, Icon und Screenshots (ĂŒber die Content Gallery), Kategorie, Developer, Sprache, Version, „updated“
StoreBeschreibung (mit {value}-Makros), Tags, Rating-Histogramm, Reviews, „what's new“, Badges (verified, glow, live counter), Light/Dark-Theme, Farbschema
ScreenDer In-App-Screen nach der Installation: Typ, Titel, Text, Button, Bild, eigenes HTML/JS
ActionsAktion des Install-Buttons: zum Offer / zu einer Kampagne / zu einer URL / nirgendwohin (action_target), Auto-Redirect-Timer
PushDas Push-Abo auf dem App-Screen aktivieren (push_enabled)
DomainDomain-Bindung (siehe §2) + der Offer fĂŒr die direkte Domain
ReadinessEine Live-Checkliste, wie das native Install-Sheet aussehen wird: Icon, Beschreibung, Screenshot-GrĂ¶ĂŸen, Push-Keys, Domain-Bindung

Der Button Preview rendert den Config-Entwurf mit dem Production-Renderer — eine Live-Vorschau von Storefront und Screen (auto/iOS-Plattform), ganz ohne Speichern.

1.3 Der Funnel und die Beacons

Die Storefront-Seite schickt Ein-Pixel-Beacons, die in den Klick geschrieben werden:

Alle Spalten sind in den Klick-Details sichtbar — dem wichtigsten Funnel-Diagnose-Werkzeug: der Tracker benennt den Grund selbst, keine Browser-Logs nötig.

1.4 Das Push-Abo lebt im Service Worker

Das Abo lĂ€uft komplett in der generierten sw.js (orbitraSubscribe): Die Seite schickt dem Worker nur eine Nachricht und macht sich auf den Weg zum Offer. Das ist mit Absicht so — auf iOS kann der erste, kalte pushManager.subscribe Dutzende Sekunden dauern, und das Abo darf nicht davon abhĂ€ngen, wie lange der User auf der Seite bleibt. Der Worker darĂŒber hinaus:

Der Platzhalter {vapid_public} in sw.js wird zum Zeitpunkt des Datei-Auslieferns ersetzt, nicht bei der Generierung — ein VAPID-Key-Wechsel erreicht bereits installierte Apps, ohne die statischen Dateien neu zu erzeugen.

1.5 RENDERER_VERSION

Jede Renderer-Änderung erhöht RENDERER_VERSION (core/PwaLanding.php). Bei der nĂ€chsten Ansicht der Landingpage vergleicht der Tracker den Versions-Marker in den gerenderten statischen Dateien und regeneriert veraltete Dateien von selbst — kein manuelles Neu-Hochladen auf den Server.


2. Domain → PWA-Bindung

Eine Domain kann direkt an eine PWA gebunden werden: Ein Besuch von https://domain.com/ öffnet den Storefront aus dem Root, ohne den Umweg ĂŒber eine Kampagne und /lander/ — eine saubere Install-URL.


3. Web Push: die Basis, die Keys, das Versenden

3.1 VAPID-Keys und der Contact

Die Seite Push Base (Panel → Push):

  1. FĂŒlle den Contact aus — mailto:[email protected] oder https://
. Ohne echten Contact ist die Key-Generierung blockiert: Apple (web.push.apple.com) validiert den sub-Claim im JWT und antwortet mit 403 BadJwtToken auf Platzhalter-Adressen.
  2. Klicke Generate keys. Die Keys liegen in den Tracker-Einstellungen (vapid_public_key / vapid_private_key / vapid_private_pem); VerschlĂŒsselung und Signierung sind reines PHP + openssl (RFC 8291 + RFC 8292), ohne Composer.
  3. Key rotation fragt nach einer BestĂ€tigung: Bestehende Abos werden ungĂŒltig, aber jedes GerĂ€t abonniert bei der nĂ€chsten App-Öffnung still neu (self-heal); die Basis restauriert sich selbst.

Der Diagnostik-Streifen auf der Seite zeigt: ob Keys existieren, den Public Key, den Contact (mit Warnung, falls der Standard gesetzt ist), das Alter des letzten Worker-Pings und die neuesten Fehlercodes der Zustellung.

3.2 Der Reiter „Subscribers“

Die Tabelle push_subscriptions: id, click, endpoint, country, language, UA, status (active / expired), created, last shown. Funktionen:

Abonnenten vervielfachen sich durch Neuinstallationen und Re-Abos (der Endpoint wird vom Push-Dienst geĂ€ndert) — alte Zeilen verfallen von selbst per 404/410 beim Versand, kein separates AufrĂ€umen nötig. PrĂŒfe vor einem Blast die „Frische“ eines Abonnenten ĂŒber seinen Klick (die Klick-Details zeigen die Landingpage und die Install-UA).

3.3 Der Reiter „Messages“

Messages sind Broadcast-Templates. Zwei Arten:

Message-Felder: Titel (≀250), Body (≀400), Icon (eine URL, am bequemsten aus der Gallery), Banner-Bild (eine URL — Android Chrome zeigt es als großes Bild auf der Benachrichtigung; iOS ignoriert es still), Klick-Link, Segment, LĂ€nder- und Sprachen-Targeting, das „active“-Flag.

Segmente werden aus den Conversion-ZĂ€hlern des Abonnenten zum Zeitpunkt der Einreihung berechnet:

SegmentWer erhÀlt sie
allalle aktiven Abonnenten
reg0keine Registrierung
reg1dep0registriert, keine Einzahlung
reg1dep1registriert und eingezahlt

Targeting (Migration 60) schrĂ€nkt jedes Segment zur Einreihungszeit weiter ein: countries — eine Komma-Liste von ISO-Codes, abgeglichen gegen den Geo des Abonnenten (US, DE), languages — zweibuchstabige Browser-Sprach-Codes, abgeglichen ĂŒber den primĂ€ren Subtag (en passt auf einen Abonnenten, gespeichert als en-US). Leere Liste = keine EinschrĂ€nkung. Junk-EintrĂ€ge fallen beim Speichern weg und werden nie gespeichert.

Der Body unterstĂŒtzt Makros, die zum Sendezeitpunkt expandiert werden: {variant1|variant2} (Zufallswahl, Schachtelung ≀10), {Random=(X,Y)}, {subid} und andere Klick-Makros — eine Message gibt jedem EmpfĂ€nger seinen eigenen Text.

3.3.1 Push-Klicks und die Message-CTR

Jede Benachrichtigung, die der SW zeigt, trÀgt die Delivery-IDs in ihrem data (subid, message_id, sid). Ein Tipp darauf feuert ein Beacon (/pixel.gif?action=pwa&kind=pushclick) vor der Navigation, sodass der Tipp gezÀhlt wird, obwohl der Browser sofort zum Offer weiterlÀuft:

3.3.2 Abbestellen

Die Benachrichtigung selbst trĂ€gt einen Unsubscribe-Action-Button (lokalisiert, in den SW der Landingpage gebacken; iOS ignoriert Actions — dort öffnet der Tipp auf die Benachrichtigung trotzdem). Ein Tipp darauf POSTet den Endpoint des Browsers an den öffentlichen /push_unsubscribe-Ingest, der is_active = 0 setzt (idempotent; die Keys bleiben, das Panel kann also reaktivieren). Es gibt außerdem eine eigenstĂ€ndige öffentliche Seite /push-unsubscribe?endpoint=<urlencoded> — sie rendert einen BestĂ€tigungs-Button (die Deaktivierung ist ein POST dahinter, also kann ein vorgeladener Link niemanden abbestellen) und lĂ€sst sich von ĂŒberall verlinken.

Der generierte SW dient außerdem eine eigene Offline-Seite fĂŒr fehlgeschlagene Navigationen (lokalisiert, mit einem Retry-Button), statt der veralteten gecachten Storefront-Seite — eine gecachte Store-Seite wĂŒrde eine veraltete Klick-ID beacont, und ihr CTA funktioniert offline ohnehin nicht.

3.4 Versand: die Warteschlange und der Cron

Das Panel selbst verschickt nichts. Der Button „Send now“ in einer Message-Zeile reiht (push_queue) einen Eintrag pro aktivem Abonnenten des Segments ein, mit Duplikat-Schutz, und antwortet „Queued: N“.

Die Zustellung erledigt der Cron-Worker cli/push_cron.php — jede Minute:

* * * * * www-data php /var/www/orbitra/cli/push_cron.php --quiet >> /var/www/orbitra/var/logs/push.log 2>&1

Die Zeile installiert install.sh automatisch (Marker # orbitra-push); prĂŒfe: crontab -u www-data -l | grep orbitra-push. Der Worker: flock gegen parallele LĂ€ufe, Batches ≀300, Retry nach 300 Sekunden, 429 respektiert Retry-After, 401/403 — ein Retry mit frischem JWT, 404/410 — das Abo verfĂ€llt, 5xx/Netzwerk — zurĂŒck in die Warteschlange. Event-Messages werden vom selben Worker ĂŒber einen Cursor in den Einstellungen ausgelöst.

Die Warteschlangen-Gesundheit zeigt der Streifen ĂŒber der Message-Liste: pending/done/failed und die Zeit des letzten Worker-Pings. Tickt der Ping nicht — der Cron ist nicht installiert oder lĂ€uft nicht, und die Zustellung wird nicht stattfinden.

3.5 Was „gesendet“ bedeutet

Ein 201 vom Push-Dienst bedeutet „Umschlag akzeptiert“, nicht zugestellt. Der Push-Dienst kann die VerschlĂŒsselung nicht brechen (E2E): Er antwortet 201 und lĂ€sst die Message still fallen, wenn das GerĂ€t sie nie liest. Der finale Richter ist das Phone allein. Eine ĂŒberwachte Verifikations-Kette:

  1. Push Base → Subscribers → Send in der Zeile → der „accepted“-Banner;
  2. auf dem GerÀt: das Notification-Shade (das Banner kann still durchgegangen sein, wÀhrend die App offen war);
  3. wenn 201, aber Funkstille — siehe §4.

4. Fehlerbehebung und hÀufige Probleme

Überhaupt kein Abo — Klick-Details: push_fail_reason benennt den Grund (unsupported = keine Push API — das Telegram-/Chrome-Webview auf iOS; insecure = kein HTTPS; nokey = VAPID nicht konfiguriert; denied = abgelehnt; timeout = langsames Netz — das Abo kommt bei der nĂ€chsten Öffnung per self-heal nach).

iOS — nur Safari, und nur vom Home-Screen. Web Push auf iOS funktioniert unter diesen Bedingungen: iOS ≄ 16.4, die App zum Home-Screen hinzugefĂŒgt ausgerechnet aus Safari (normales Safari hat kein Notification-Objekt — ein Abo wird nie erzeugt), eine Domain mit echtem öffentlichen Zertifikat. Eine App, die aus Chrome (CriOS) zum Home-Screen hinzugefĂŒgt wurde, bekommt keine Push-Garantie: PrĂŒfe den installierenden Browser per UA in den Klick-Details (CriOS/
 = Chrome, Version/
 = Safari). Wenn es nicht geht — das Icon aus Safari neu installieren.

403 BadJwtToken beim Versenden — ein ungĂŒltiger VAPID-Contact: Apple weist Platzhalter-Adressen zurĂŒck (mailto:orbitra@localhost). Trage ein echtes mailto: ein.

201, aber bei manchen nirgendwo angekommen — prĂŒfe, dass der Server auf der neuesten Version ist (git log --oneline -1 via sudo -u www-data): FrĂŒhe Builds hatten Krypto-Umschlag-Defekte (ein Header ohne keyid, ein Key-Schedule nicht per RFC 8291), die der Dienst trotzdem mit 201 akzeptierte. Dann ein Kontrollversuch: Desktop-Chrome → PWA installieren → Allow → Senden: Kommt es auf dem Desktop an, aber nicht auf dem iPhone — das Problem ist das GerĂ€t/der Kanal (ein VPN bricht die persistente APNs-Verbindung; Chrome-Installationen); bekommt der Desktop ebenfalls nichts — schreib an den Support, mit dem Fehlercode aus dem Diagnostik-Streifen.

„Buttons klicken nicht“ nach einem Panel-Update — fast immer der Browser-Cache mit einem alten index.html: Hard-Reload (Cmd+Shift+R) oder ein privater Tab.

Stiller Cron — push_cron_last_ping_at tickt nicht: Der Cron ist nicht installiert. crontab -u www-data -l | grep orbitra-push; das Log ist var/logs/push.log.


5. Tests

Den In-App-Browser verlassen (Renderer v19+)

Eine PWA lĂ€sst sich im FB/IG/TikTok-Webview nicht installieren — jeder Webview-Visit ist ein garantierter Funnel-Verlust. Mit Auto-open in browser an (Standard), verlĂ€sst die Landingpage sofort: Android ĂŒber ein intent:// in Chrome (die aktuelle URL als Fallback), iOS 17+ ĂŒber x-safari-https://; Ă€lteres iOS behĂ€lt die Anleitung-Karte. Die Flucht-URL trĂ€gt die Klick-ID, und der externe Browser fĂŒhrt denselben Klick fort — kein zweiter Klick, kein gespaltener Funnel. Die PWA-Funnel-Karte zeigt Versuche und Erfolgsquote (RĂŒckkehr in einem echten Browser). Nur die Money-Seite flieht je: Eine Safe Page serviert weiterhin den Safe-Inhalt.

Zustellung und Conversion-Attribution

Offer-Makros im Push-Text

{offer.value} / {offer.value1} / {offer.value2} lösen sich aus der LĂ€nder-Tabelle des Offers (Country → Bonus / Freespins / WĂ€hrung; leeres Land = universeller Fallback) nach dem Land des Abonnenten, ĂŒber den Offer, zu dem der Klick des Abos ging. Der Message-Editor hat eine Live-Vorschau fĂŒr ein gewĂ€hltes Land + Offer. Ohne Kontext bleibt das Makro sichtbar — nie still leer.

Versand zur lokalen Zeit des Abonnenten

Das Abo speichert die IANA-Zeitzone des GerĂ€ts (Ă€ltere Zeilen: abgeleitet aus dem Geo-Land). Eine Message mit Send at subscriber's local time wartet die Ruhezeiten aus — standardmĂ€ĂŸig 23:00–08:00 lokal (push_quiet_hours) — und sendet in der ersten erlaubten Minute. Die Requeue hĂ€lt die Zeile auf pending (last_code=quiet), sie scheitert nie.

Push-Benachrichtigungen des Betreibers (Panel-PWA)

Alles oben pusht an Landingpage-Abonnenten. Das Panel selbst ist ebenfalls eine PWA (aus dem Browser installierbar), und unter Users & Profile → Profile → Push notifications kann der Betreiber Web Push auf seinen eigenen GerĂ€ten empfangen — Conversion-Alarme und Tages-/Wochen-/Monats-Digests — ganz ohne Telegram.

Telegram-Wochen-/Monats-Digests (Migration 70)

Die Tages-Zusammenfassung des Admin-Bots bekam zwei Geschwister, auf der Benachrichtigungen-Seite → Telegram: wöchentlich (die letzte vollstĂ€ndige Woche, gesendet am Montag) und monatlich (der letzte vollstĂ€ndige Monat, gesendet am 1.); konfigurierbar ist nur die Sendezeit. Alle Telegram-Zeiten — auch die tĂ€gliche — werden in der Zeitzone des Profils des ersten Admins gelesen, nicht in der Serverzeit. Per-Chat-Schalter spiegeln die Bot-Befehle /weekly on|off und /monthly on|off; die Auslieferung einmal pro Fenster wird von tg_digest_log gesperrt (unique chat × period × window). Die Summen kommen vom selben Helfer AdminPushNotify::digestWindow()/windowStats(), den auch die Push-Digests nutzen — Telegram und Push können sich bei den Zahlen also nie widersprechen.

← ZurĂŒck
Landingpages (Referenz)
Weiter →
PWA Funnel
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 →