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
- Eine PWA ist eine gewöhnliche Zeile in der Tabelle
landings(Typlocal), derenconfig_json"pwa": trueenthĂ€lt. Der Klick-Router, die Stream-Rotation und das Cloaking behandeln sie wie jede andere lokale Landingpage â keine neuen Typen. - Beim Speichern erzeugt der Builder drei Dateien im Landingpage-Verzeichnis:
index.html(ein Storefront im Google-Play-Stil),manifest.webmanifestundsw.js. - Die Landingpage wird unter
/lander/<slug>/ausgeliefert â Chrome bietet die Installation nur innerhalb des Manifest-Scope an, daher wird keine Root-URL verwendet. - Der Klick (eine Klick-Log-Zeile + Attribution-Cookies) wird vor dem Redirect zum Storefront geschrieben, sodass Push-Abo, Funnel-Beacons und der Hop zum Offer dem echten Klick zugeordnet werden.
manifest.webmanifest(Renderer v17) ist fĂŒr Chromes Rich-Install-Sheet gebaut (Android 94+ / Desktop 105+): Neben den Basis-Feldern deklariert esid,lang,description(mit den aufgelösten{value}-Makros) unddisplay_override, und listet jeden Storefront-Screenshot, der Chromes Sheet-Constraints besteht (jede Seite 320â3840 px, SeitenverhĂ€ltnis †2,3), alsscreenshotsmit einemnarrow/wide-Formfaktor. Die Karte Install readiness im Editor zeigt dasselbe Urteil live.- Browser ohne nativen Install-Prompt bekommen ein Anleitung-Overlay: Firefox/Opera auf Android sehen die Browser-MenĂŒ-Schritte (iOS sieht die Safari-Schritte, solange
ios_flow = instruction), und In-App-Webviews (Instagram, Facebook, TikTok, generisches WebView) bekommen eine wegklickbare âopen this page in your browserâ-Karte â der Funnel darunter lĂ€uft weiter.
1.2 Der Builder
Landings â Add PWA (oder âDuplicateâ auf einer bestehenden). Die Hauptblöcke des Editors:
| Block | Was er konfiguriert |
|---|---|
| General | App-Name, Slug, Gruppe, Icon und Screenshots (ĂŒber die Content Gallery), Kategorie, Developer, Sprache, Version, âupdatedâ |
| Store | Beschreibung (mit {value}-Makros), Tags, Rating-Histogramm, Reviews, âwhat's newâ, Badges (verified, glow, live counter), Light/Dark-Theme, Farbschema |
| Screen | Der In-App-Screen nach der Installation: Typ, Titel, Text, Button, Bild, eigenes HTML/JS |
| Actions | Aktion des Install-Buttons: zum Offer / zu einer Kampagne / zu einer URL / nirgendwohin (action_target), Auto-Redirect-Timer |
| Push | Das Push-Abo auf dem App-Screen aktivieren (push_enabled) |
| Domain | Domain-Bindung (siehe §2) + der Offer fĂŒr die direkte Domain |
| Readiness | Eine 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:
pwa_intent_atâ ein Tipp auf âInstallâ;pwa_install_atâ die App wurde installiert (dasappinstalled-Event oder der erste standalone-Start auf iOS);pwa_open_at/pwa_open_countâ erneute Ăffnungen der installierten App (höchstens einmal pro 10 Minuten pro Klick);push_prompted_at/push_declined_at/push_subscribed_atâ Push-Abo-Events;push_fail_reasonâ warum kein Abo zustande kam (nokey/unsupported/insecure/denied/dismissed/error/timeout).
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:
- abonniert bei
pushsubscriptionchangevon selbst neu (Endpoint-Key-Rotation auf Seiten des Push-Dienstes, VAPID-Key-Update); - gleicht bei jeder Ăffnung der installierten App das Abo still mit den Tracker-Einstellungen ab (self-heal) â ein erneutes Ăffnen der App repariert das Abo ohne Neuinstallation;
- zeigt eingehende Pushes und behandelt Notification-Klicks (ein bestehendes Fenster fokussieren und zu
data.urlnavigieren).
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.
- Die Bindung wird im Builder (Domain-Block) oder in der Domain-Karte konfiguriert.
- Eine Domain â höchstens eine PWA; eine PWA kann an mehreren Domains hĂ€ngen.
- Neben der Domain wird ein Offer gewÀhlt (
pwa_offer_id): Auch ohne Kampagne fĂŒhrt der âOfferâ-Button auf dem Storefront weiterhin per/?_lp=1mit Attribution zum Offer. - PrioritĂ€ten: Ein explizites
?campaign_id=oder ein Kampagnen-Alias schlÀgt die Bindung immer; die Bindung schlÀgtindex_campaign_idauf dem Root. - Organische Visits (ein kalter Besucher ohne Klick-Cookie) werden als echte Klicks in die archivierte Systemkampagne
orbitra-pwa-organicgeschrieben â sie wird automatisch angelegt und ist in der Kampagnen-Liste nicht sichtbar. Wiederholte Visits mit lebendem Cookie erzeugen keine Duplikate.
3. Web Push: die Basis, die Keys, das Versenden
3.1 VAPID-Keys und der Contact
Die Seite Push Base (Panel â Push):
- FĂŒlle den Contact aus â
mailto:[email protected]oderhttps://âŠ. Ohne echten Contact ist die Key-Generierung blockiert: Apple (web.push.apple.com) validiert densub-Claim im JWT und antwortet mit 403 BadJwtToken auf Platzhalter-Adressen. - 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. - 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:
- Filter nach Status/Land, Suche nach endpoint und click_id, Pagination mit 50 Zeilen/Seite;
- Operationen: activate / deactivate / delete (harte Löschung â das DSGVO-Szenario);
- CSV export der gesamten Basis (
;-Separator: id;date;status;country;language;click_id;endpoint); - Der Button Send in einer Zeile â ein Test-Push an einen einzelnen Abonnenten, der Warteschlange und den Cron umgehend, sofort. Antworten werden ehrlich dekodiert: 403 â Hinweis auf einen ungĂŒltigen VAPID-Contact, 404/410 â das Abo ist tot, alles andere â der Fehlercode des Dienstes. Das ist der schnellste Weg, die ganze Pipe zu testen (Keys â JWT â Push-Dienst â GerĂ€t).
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:
- Manual â was du per Button verschickst;
- Event-driven (kind
event) â verschickt der Cron automatisch bei einem Event:install(PWA-Installation),lead,sale, verzögert umdelay_secondsSekunden ab dem Event.
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:
| Segment | Wer erhÀlt sie |
|---|---|
all | alle aktiven Abonnenten |
reg0 | keine Registrierung |
reg1dep0 | registriert, keine Einzahlung |
reg1dep1 | registriert 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:
clicks.push_clicks+push_click_atin der Klick-Zeile (gedrosselt auf eine ZĂ€hlung pro 10 Minuten, wie beim Re-Open-ZĂ€hlen) â das ist die ROI-Zahl: Abonnenten â Klicks â Conversions, alles in einem Funnel;push_sends.clicked_atin der Delivery-Zeile â die Messages-Tabelle rendert Push-Klicks pro Message mit der Durchklick-Quote;- die Summen der PWA-Funnel-Karte schlieĂen die Push-Klicks der Landingpage ein.
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:
- Push Base â Subscribers â Send in der Zeile â der âacceptedâ-Banner;
- auf dem GerÀt: das Notification-Shade (das Banner kann still durchgegangen sein, wÀhrend die App offen war);
- 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
tests/push_sender_test.phpâ Kryptographie: die ES256-Signatur verifiziert mit openssl, der Key ink=passt zum signierten Key, der Datensatz entschlĂŒsselt Byte fĂŒr Byte so, wie es der Browser tut (keyid aus dem Wire gelesen), ein Referenz-Vektor aus der Web-Push-Library (npm) entschlĂŒsselt mit unserem Code, HKDF per RFC 5869, Record-GröĂen-Limits (Body †4096 Bytes â das Apple/FCM-Limit).tests/push_macros_test.phpâ Makros und Segment-SQL.tests/push_api_test.phpâ Message-CRUD, Geo-/Sprachen-Targeting, das Push-Klick-Pixel (Throttle +push_sends.clicked_at),/push_unsubscribeund die öffentliche Unsubscribe-Seite, RBAC.tests/push_base_test.phpâ der/push_subscribe-Validator, Migrationen, statische Dateien.tests/push_cron_test.phpâ Warteschlange, Retries, Abo-Verfall.tests/pwa_landing_test.phpâ SW-Handler,{vapid_public}-Ersetzung zur Auslieferungszeit, derService-Worker-Allowed-Header.tests/domain_pwa_test.phpâ Root-Rendering einer gebundenen Domain, Cookies, organische Klicks, Bindungs-PrioritĂ€ten.
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
- Gesehen: Der Service Worker beacont in dem Moment, in dem er die Benachrichtigung tatsÀchlich zeigt (
push_sends.viewed_at) â shown % und die CTR ab Views sind ehrlich, nicht erschlossen. - Conversions pro Push (
core/PushAttribution.php): Eine Conversion auf dem Klick des Abonnenten zĂ€hlt fĂŒr den Push, wenn sie innerhalb des Attribution-Fensters nach dem Push-Klick landet (empfohlen; dersend-Modus ist ebenfalls verfĂŒgbar) â der letzte Klick vor der Conversion gewinnt. Fenster:push_attribution_hours(1â720, Standard 72). FTD = die erste Einzahlung des Abonnenten, Wiederholungen zĂ€hlen als Re-Deposits. Die Einzahlung bleibt auch dem Ad-Klick attributiert â Kampagnen-Reports bleiben unberĂŒhrt. - Ein Banner warnt, wenn die Zustellung unter 50 % fĂ€llt: 404/410-Endpoints werden bei Sendeversuchen automatisch deaktiviert, die Basis heilt sich selbst.
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.
- Wo: die Benachrichtigungen-Seite (Avatar-MenĂŒ â Notifications, oder das Zahnrad-MenĂŒ) â Sub-Tab Push to phone, persönlich fĂŒr jeden User; der Telegram-Sub-Tab (nur Admin) hĂ€lt die Chats des Bots und den Digest-Zeitplan. Das Profil behĂ€lt eine Hinweis-Karte; die Push-Seite trĂ€gt eine Notiz âdas sind Landingpage-Abonnentenâ, die hierhin zeigt.
- Installieren: Das Panel bringt ein Manifest mit (
<panel>?orbitra_manifest=1) und dieselbe/sw.js. Wenn der Browser die Installation anbietet, erscheint eine Install-Pill in der Navbar; iOS Safari wird von der Karte angeleitet (Share â Add to Home Screen). Admins können die gemeinsamen VAPID-Keys direkt in der Karte erzeugen (Contact inklusive) â kein Umweg ĂŒber die Push-Seite. - Auf diesem GerĂ€t aktivieren abonniert den Browser ĂŒber den Panel-Service-Worker. Das VAPID-Key-Paar wird geteilt mit der Landingpage-Push-Basis (Push-Seite â Subscribers â Keys) â ein Key-Paar, zwei Zielgruppen; ânoch keine Keysâ ist der erste Hinweis der Karte. Auf iOS funktionieren Benachrichtigungen nur in der installierten App.
- Conversion-Alarme: ein Push pro passendem Postback (Status-Badges â
sale,deposit, ⊠â und Kampagnen-IDs; leer = alles). Wird synchron aus dem Postback gesendet, wie die Telegram-Alarme; ein 404/410-Endpoint zieht das GerĂ€t automatisch zurĂŒck. - Digests: tĂ€glich (heute), wöchentlich (die letzte vollstĂ€ndige Woche, MoâSo, gesendet am Montag) und monatlich (der letzte vollstĂ€ndige Monat, gesendet am 1.) â Klicks, Conversions, Einnahmen, Gewinn â zur lokalen
digest_timedes Users. Fenster werden in der Profil-Zeitzone des Users berechnet (DST-sicher) und gegen das UTC-clicks.created_atverglichen; ausgeschlossene Safe-Page-Treffer bleiben drauĂen, genau wie auf dem Dashboard (orbitraSafePagePredicate). Ein verpasster Montag / 1. (Cron down, Digest gerade eingeschaltet) holt beim nĂ€chsten Tick auf. Gesendet voncli/push_cron.php; deradmin_push_digest_log-Gesendet-Marker macht ein doppeltes Senden unmöglich. - Tabellen:
admin_push_subs,admin_push_settings,admin_push_digest_log(Migration 69) â strikt getrennt vonpush_subscriptionsgehalten (das sind Landingpage-Besucher). API-Aktionen:admin_push_state,admin_push_subscribe,admin_push_unsubscribe,admin_push_settings_save,admin_push_test. - Core:
core/AdminPushNotify.php; die Panel-sw.jsbehandeltpushundnotificationclick(nur Same-Origin-Links). Tests:php tests/admin_push_test.php.
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.
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 â