Funnel de visite PWA
Renderer v16 · migration 51. La visite in-browser d'une landing PWA est désormais un funnel configurable : une liste ordonnée d'écrans où la première étape activée est ce que voit en premier un visiteur à froid, chaque activation d'écran émet un beacon et est reportée, et chaque écran peut embarquer son propre script de tracking.
Le modèle de funnel
La clé landings.config_json gagne une clé, funnel — un tableau ordonné d'étapes :
"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 }
]
Types d'étapes :
| type | ce qu'il affiche |
|---|---|
store | La fiche Google Play / App Store (markup existant ; l'UA choisit la disposition) |
screen | Un écran opérateur : template lobby / slot / wheel / custom en HTML — les mêmes templates que l'écran de l'app installée. Jusqu'à 5 par funnel |
instructions | Un écran plein-page d'instructions d'installation. Les deux listes par plateforme s'affichent ; le CSS indexé sur data-store (le sniffing d'UA dans <head>) montre les étapes Safari sur iOS et les étapes du menu Chrome ailleurs |
push | La carte d'opt-in push placée dans le flux navigateur. Uniquement quand Push enabled — sans la clé VAPID ni le support navigateur, l'étape serait un cul-de-sac, donc le flux l'ignore aussi à l'exécution |
Règles (PwaLanding::normalizeFunnel() fait office de liste blanche, l'éditeur ne produit que des formes qu'elle accepte) :
- les ids correspondent à
^[a-z0-9_]{1,32}$, sont uniques et n'entrent jamais en
collision avec les ids builtin ; les invalides sont régénérés côté serveur ;
- un
store/ uninstructions/ unpushpar funnel (les doublons sont supprimés) ; - 5 étapes
screenau maximum ; funnelabsent ou invalide →[store]. **Toute config d'avant le funnel affiche
exactement ce qu'elle affichait avant** — le store reste le premier écran, ios_flow gouverne toujours l'overlay de clic d'installation, la carte push appartient toujours à l'app installée.
Sémantique du flux (JS de la page)
- La première étape activée s'affiche lors d'une visite à froid ; une première
étape non-store masque les dispositions du store dès le premier paint (data-flow-first, posé par le script du <head> avant que le body n'existe).
- N'importe quel CTA
.install-triggerdans le flux **avance vers l'étape activée
suivante** ; quand le flux n'a plus d'étapes, le CTA retombe sur la tentative d'installation legacy (prompt natif / overlay iOS / redirection selon la config). L'opérateur décide où l'invite d'installation se déclenche en ordonnant le funnel.
- La carte push du flux : Allow lance la machinerie standard de permission (le
handover vers sw.js reste intact), Not now répond à l'étape et avance. Quand le flux s'épuise après une réponse push, le visiteur part vers l'offre (flowExhausted) ; avec app_action = screen, c'est l'écran de l'app installée qui s'affiche à la place.
- L'app installée (ouverture standalone) ne fait pas partie du flux : la branche
standalone — beacon d'ouverture, confirmation d'installation iOS, sync push, puis app_action — se comporte exactement comme avant.
- Les minuteurs
auto_redirect/decline_redirect/install_redirectgardent
leur signification globale et déclenchent vers l'offre quelle que soit l'étape visible.
Tracking par écran
Chaque activation d'un écran du flux émet un beacon vers /pixel.gif?action=pwa&kind=screen&screen=<id>&subid=<click> :
clicks.pwa_entry_screen— premier écran que le clic ait jamais vu (protégé
contre NULL ; la ligne du clic reste la porte de dédup comme pour chaque colonne pwa_*) ;
clicks.pwa_last_screen— l'étape où le clic était pour la dernière fois
(last-write-wins) ;
pwa_screen_views— le journal d'événements brut 1:N
(click_id, landing_id, screen, created_at), plafonné à 100 lignes par clic pour qu'un onglet garé qui cycle les écrans ne puisse pas pomper la table. La migration 51 la crée ; la DDL d'auto-réparation toujours active garantit son existence sur chaque version de schéma car le SQL des rapports la référence inconditionnellement.
Chaque étape screen peut aussi embarquer un custom_js (le champ « Screen tracking script » de l'éditeur). Il s'exécute à la première activation de l'écran, pas au parse de la page — un pixel pub ne doit pas partir pour un écran que le visiteur n'a jamais atteint. Les moteurs interactifs du template (rouleaux de slot, roue de bonus) ont été refactorisés en factories par conteneur pour que plusieurs copies du même template puissent coexister sur une page ; les ids d'éléments sont préfixés par étape (fs<id>_…). Helpers disponibles pour les scripts custom : window.orbitraFlow.next(), window.orbitraFlow.goto(id), plus les existants orbitraRedirect / orbitraBeacon.
Statistiques
- Métrique
pwa_screen_views— vues totales d'écrans du flux, agrégées dans
les cartes du dashboard, la liste des campagnes, campaign_report et les tables Landings et Offers (parité rapports == campagnes). Un clic contribue légitimement plusieurs vues ; il n'y a pas de ratio dérivé par-dessus.
- Dimensions
pwa_entry_screen/pwa_last_screen— simples colonnes de
clics enregistrées dans $allowed_dimensions (api.php, campaign_report), donc utilisables à la fois comme couches Group By et comme filtres. NULL (lignes d'avant la fonctionnalité, trafic non-PWA) groupe comme Unknown.
- Endpoint
pwa_funnel_stats— carte funnel par landing sur la page Landings
(le bouton graphique en barres sur les lignes PWA) : vues/uniques par écran, distributions d'entrée et de sortie (une sortie = le dernier écran du clic sans transition vers l'offre), et la matrice de transitions écran→écran parcourue depuis le journal d'événements ordonné. L'ordre des écrans suit d'abord la config du funnel.
Éditeur et aperçu
L'étape 1 du constructeur PWA a gagné la section Visit funnel : une liste d'étapes réordonnçable (drag par la poignée, boutons ↑/↓), des toggles d'activation, le badge premier écran, des éditeurs par écran (template, titre/texte/bouton, image hero via MediaPicker, HTML custom + JS de tracking) et un compteur de plafond (0/5). L'aperçu live peut ouvrir le funnel à n'importe quelle étape activée — pwa_preview accepte un id d'étape comme view et le force via window.__PWA_FORCE_SCREEN.
Version du renderer et auto-réparation
RENDERER_VERSION passe de 15 à 16 : la route lander et le serveur de racine de domaine régénèrent les statiques écrites par le renderer plus ancien à la prochaine vue, donc les PWA déjà créées récupèrent le boot du flux (et le beacon de vue du store) sans re-save. Les configs legacy se régénèrent avec le funnel [store] et restent visuellement identiques.
Tests
tests/pwa_funnel_http_test.php— le modèle de config du funnel, le markup du
flux, la dédup/le plafond/l'attribution des beacons et l'endpoint funnel-stats (HTTP, sandbox du harness).
tests/report_metrics_test.php— valeurs de référence calculées à la main pour
pwa_screen_views sur le dashboard, le SQL des landings et des offres (vues 1:N : un clic contribue chaque écran qu'il a vu, revisites incluses).
Démarrage rapide : votre première campagne
Le chemin court : installez le tracker, créez une campagne et obtenez vos premiers clics et conversions en moins d'une heure.
Lire le guide →DocsInstallation et mises à jour
Installez Orbitra sur un serveur Ubuntu ou Debian tout neuf en une commande, et passez aux nouvelles versions sans risque.
Lire le guide →DocsMigrer depuis Keitaro
Déplacez campagnes, offres, sources et domaines de Keitaro vers Orbitra : ce qui est transféré et quoi vérifier après l'import.
Lire le guide →DocsMigrer depuis Binom
Déplacez campagnes et streams de Binom vers Orbitra via l'API publique v2 : ce qui est transféré automatiquement et quoi régler à la main.
Lire le guide →DocsAperçu des fonctionnalités
Tout ce qu'Orbitra sait faire : campaigns et streams, cloaking, landings, PWA, postbacks, coûts, rapports et intégrations.
Lire le guide →DocsCampaigns et streams
La référence complète : réglages de campagne, types de streams, schémas, rotation, filtres, test links et chaque option expliquée.
Lire le guide →DocsCloaking
La référence complète du cloaking : couches de détection, réglages globaux, filtres par stream, verdicts et rapports.
Lire le guide →DocsBrowser check
Comment la vérification JS attrape bots, VM et émulateurs à travers les contradictions de l'environnement du navigateur.
Lire le guide →DocsLanding pages
Types de landings, la macro {offer}, l'adaptateur JS, LeadForge et les landings multi-offres — la référence complète.
Lire le guide →DocsPWA et Web Push
Construisez des apps PWA installables et collectez des abonnés push : réglages, icônes, événements et notifications.
Lire le guide →DocsFunnel de visite PWA
Le funnel configurable des landings PWA : étapes ordonnées, store, instructions et carte push, tracking par écran, statistiques de transitions et éditeur.
Lire le guide →DocsPopups de conversion
Un popup avec bouton d'offre sur vos landings : templates par vertical, déclencheurs, designs, une vraie étape du funnel et les métriques Popup CTR.
Lire le guide →DocsEnregistrements de session
Replay des visites façon vidéo, heatmap de clics et carte de scroll : activation, sites entiers, consentement cookies, stockage et dépannage.
Lire le guide →DocsContent Gallery : référence complète
La médiathèque partagée du tracker : dossiers, uploads, limites de formats, MediaPicker et contrat de taille dans les éditeurs PWA, landing et offre.
Lire le guide →DocsBibliothèque de créas
L'onglet Creatives de la galerie : sync Facebook/TikTok, dépense et ROI par créa, rattachement des brouillons, alertes burnout et rapports.
Lire le guide →DocsPWA externes et chaînes Telegram
Builders PWA tiers comme cibles de stream avec installs et postbacks attribués, et offres chaîne Telegram via funnel bots avec conversions tg_join.
Lire le guide →DocsPostbacks et conversions
Postbacks entrants, types de conversion et devises, postbacks S2S sortants, macros, file de livraison, testeur, import et Conversions API.
Lire le guide →DocsCoûts : import de la dépense
Import de la dépense Facebook, TikTok, Google Ads et réseaux push/pop : matching par IDs, diagnostics, agences, métriques plateforme et agrégateur de revenus.
Lire le guide →DocsRéseaux push et pop
Import de dépense AdMaven, PropellerAds, Kadam et autres, et le Zone Killer : règles dry-run/auto pour bloquer les zones qui brûlent de l'argent.
Lire le guide →DocsFacebook / Meta
Les deux intégrations Facebook : import de coûts avec mapping des paramètres, et Conversions API avec matching navigateur, consentement et dépannage.
Lire le guide →DocsDolphin / Fbtool
Recevoir les coûts Facebook de Dolphin et Fbtool.pro sur l'endpoint compatible Keitaro : clé API, matching par adset/ad et répartition de la dépense sur les clics.
Lire le guide →DocsNettoyage des commentaires FB
Modération planifiée des commentaires spam sous vos pubs Facebook : dry-run, stop words, regexes admin, whitelist, journal et restauration en un clic.
Lire le guide →DocsSources de trafic et réseaux d'affiliation
Les deux annuaires du funnel : templates de sources avec paramètres et macros, postback vers la source, réseaux d'affiliation et paramètres d'offre.
Lire le guide →DocsRapports, logs et métriques
Dashboard, liste des campagnes, rapport à dimensions, tendances et cohortes, journal du trafic, carte du clic et le détail du calcul de chaque métrique.
Lire le guide →DocsDomaines et SSL
Ajouter des domaines, réglages par domaine, certificats Let's Encrypt et Cloudflare, registrars connectés et surveillance Backorder.
Lire le guide →DocsCloudflare
Connecter Cloudflare via l'API : parking DNS automatique, proxy orange, modes SSL de zone, import des zones et réécriture des enregistrements A.
Lire le guide →DocsAdministration
Utilisateurs, rôles et permissions, clés API, réglages du tracker, bases geo, mises à jour et menu ⚙ : archive, statuts, logs et extension Ads Manager.
Lire le guide →DocsBot Telegram
Statistiques, conversions et digest quotidien dans Telegram : connexion par token, webhook ou polling, commandes, notifications et alertes vers les chaînes.
Lire le guide →DocsMCP : un assistant IA dans le tracker
Connecter Claude Desktop ou tout client MCP à Orbitra via le serveur MCP : clés API, options de connexion et les 41 tools disponibles.
Lire le guide →