Landing pages
Une landing est la page que voit un visiteur en chemin vers une offre. Orbitra en sert quatre sortes, et les différences tiennent surtout à une question : comment le bouton d'achat atteint l'offre.
| Type | Où elle vit | Lien d'offre |
|---|---|---|
| Local | ZIP téléversée, servie par le tracker | {offer} ou /?_lp=1 |
| Redirect | votre propre hébergement, un autre domaine | /?_lp=1 + l'adaptateur JS |
| Preload | récupérée par le tracker, montrée sous votre domaine | {offer} |
| Action | rien n'est montré ; le tracker fait quelque chose | — |
Landings locales
L'archive est dépaquetée dans landings/<landing id>/. Le point d'entrée est index.html, ou index.php si les landings PHP sont activées.
Prérequis
- La page d'entrée doit s'appeler
index.html(ouindex.php). - Utilisez des chemins relatifs :
img/hero.jpg, pas/img/hero.jpg. Les deux fonctionnent, mais les chemins relatifs marchent aussi quand vous ouvrez l'archive en local. - Pas de redirection interne vers
index.html— le visiteur quitterait l'URL trackée.
Contrairement à Keitaro, Orbitra n'ajoute pas de balise <base> et ne réécrit pas votre markup. La page est servie octet par octet comme vous l'avez téléversée, et ses fichiers sont résolus par rapport à la landing qui a été montrée. Deux conséquences à connaître :
- Une balise
<base>à vous est laissée telle quelle. - Les liens d'ancre (
href="#form"), les scripts de popup et le smooth scrolling continuent de fonctionner. Chez Keitaro ils cassent, parce qu'il réécrit chaquehref.
Lier l'offre
La forme la plus simple, et celle vers laquelle tendre :
<a href="{offer}">Buy</a>
{offer} est remplacé par la transition signée landing→offre (depuis 1.6.14, à la manière de Keitaro) : le clic passe par le tracker, donc le funnel est compté et les macros de l'offre sont substituées à la redirection. Avant 1.6.14, il embarquait l'URL directe de l'annonceur, ce qui sautait le tracker — les streams avec « sélection d'offre : before » montraient zéro clic.
Avec plusieurs offres sur une page, les deux formes marchent — l'explicite dans toutes les versions :
<a href="/?_lp=1&offer_id=10">Offer 10</a>
<a href="{offer}&offer_id=22">Offer 22</a>
Ajouter &offer_id= à {offer} change l'offre (depuis 1.6.14) : {offer} s'étend en lien de transition signé, donc le tracker lit le paramètre et re-attribue le clic — une conversion atterrit sur l'offre que vous avez nommée. Avant 1.6.14, {offer} s'étendait en URL directe de l'annonceur et le paramètre leur était simplement transmis ; la forme explicite /?_lp=1&offer_id=N marche dans toutes les versions.
Passer un choix fait sur la landing (un produit, un plan ou une réponse de quiz) fonctionne à la manière Keitaro : ajoutez sub_id_1 … sub_id_30 au lien de transition et ils mettent à jour le clic.
<a href="/?_lp=1&sub_id_5=Blue%20Watch&sub_id_6=https%3A%2F%2Fcdn.example%2Fblue.jpg">Buy the blue one</a>
L'URL de l'offre les récupère alors comme {sub_id_5} / {sub_id_6}, p. ex. https://network.example/?sub1={clickid}&product={sub_id_5}&image={sub_id_6}. Les valeurs sont écrites aussi dans le clic, donc rapports et postbacks voient la même chose. Seules les clés sub_id_N sont acceptées, des valeurs vides n'effacent jamais ce que la source de trafic a envoyé, et chaque valeur est plafonnée à 512 octets. Sur une landing hébergée ailleurs, ajoutez-les au lien signé : {lp_url}&sub_id_5=….
Depuis 1.6.14, {offer}&sub_id_5=… marche aussi — la macro est le lien de transition lui-même, donc le tracker lit ce que vous y ajoutez. Si la valeur est connue avant le clic (un produit par campagne), sautez entièrement l'étape landing et mettez ?sub_id_5=… dans le lien de campagne.
Le temps sur la landing
Rien à ajouter à la page : chaque landing servie par le tracker reçoit un petit timer injecté avant </body>. Il rapporte combien de temps le visiteur est resté — qu'il ait ou non appuyé sur le bouton offre, et c'est la différence entre ceci et Time to offer : une page que personne ne quitte par un clic ne rapporte rien sous la métrique plus ancienne, et c'est justement la page qu'il vaut la peine de trouver.
Ce qu'il mesure, et ce qu'il ne mesure délibérément pas :
- seulement le temps visible — un onglet laissé en arrière-plan ne s'accumule pas ;
- le scroll le plus profond atteint, 0-100 %, à côté des secondes ;
- des checkpoints à 5, 15, 30 et 60 secondes puis chaque minute, plus un flush
final quand la page est masquée ou déchargée, pour qu'un onglet fermé laisse quand même un chiffre.
Où ça apparaît : la colonne Time on LP dans Logs (les valeurs sous 5 secondes sont surlignées) et dans les détails de clic, et dans les rapports comme métriques Time on LP, LP bounce rate, LP scroll depth et LP measured visits plus la dimension Time on LP (bucket). Une visite qui n'a jamais rapporté — une landing en redirection sur le domaine de quelqu'un d'autre sans le script de tracking, un bot qui ne lance pas de JS — se groupe en Unknown au lieu d'être comptée comme une visite de zéro seconde.
Pour une landing hébergée ailleurs, le même timer voyage dans tracking.js / kclient.js ; une page PHP fait écho à $client->timerScript() (voir Tracking Client (PHP)).
Session recording et heatmap
L'onglet Session recording de l'éditeur de landing active les recordings façon Clarity pour cette landing : une part des visiteurs (5–100 %), la durée d'enregistrement, et les limites de stockage partagées. Les recordings se lisent dans ⚙ → Logs → Session recordings ; le même onglet ouvre la heatmap de clics et la carte de scroll de la landing. Les landings locales et « Show HTML » n'ont besoin de rien de plus ; les pages externes enregistrent via tracking.js / kclient.js / kclient.php. Les champs de formulaires sont masqués dans le navigateur du visiteur. → Session recordings et heatmaps de clics
Macros
Substituées dans le HTML d'une landing locale :
| Macro | Valeur |
|---|---|
{offer} | transition signée landing→offre (/index.php?_lp=1&_token=…, depuis 1.6.14 — le clic passe par le tracker, donc le funnel compte et les paramètres ajoutés &offer_id= / &sub_id_N l'atteignent ; même valeur que {lp_url}) |
{lp_url} | la même transition signée, orthographiée pour les landings externes |
{offer_id} | l'id de l'offre liée |
{clickid}, {subid} | l'id du clic |
{token} | token signé, utilisé par l'adaptateur JS |
{keyword}, {sub_id_1} … {sub_id_30} | paramètres de clic captés depuis la source de trafic |
Les valeurs prises de l'URL sont échappées en HTML. Rien d'autre n'est touché — {unknown}, les template literals JS, la syntaxe Vue et Angular survivent tous.
Sans offre sur le stream, {offer} devient un lien de transition non signé, ce qui rend la mauvaise configuration visible au clic au lieu de recharger silencieusement la page.
Landings Redirect (externes)
La landing se trouve sur votre propre hébergement. Le tracker envoie le visiteur là-bas et ajoute deux paramètres :
https://your-landing.example/promo?_subid=<click id>&_token=<signed token>
Le token est ce qui fait que le lien d'offre fonctionne du tout. Une landing sur un autre domaine ne peut pas lire les cookies du tracker, donc sans lui le tracker n'a aucun moyen de savoir quel clic revient. Il est signé avec HMAC-SHA256 et expire après 24 heures ; un _subid nu de l'URL n'est pas accepté seul, car cela permettrait à n'importe qui d'attribuer une visite à n'importe quel id de clic. Une landing locale ou preload récupère le clic depuis son cookie à la place, donc elle n'a pas besoin du token.
Un {offer} dans l'URL propre de la landing devient la même transition, absolue (http://your-tracker/index.php?_lp=1&_token=…), pour qu'une landing qui prend son CTA d'un paramètre de query reçoive aussi un lien fonctionnel. Les deux comportements exigent la v1.6.14 ; avant elle, le duo n'arrivait jamais réellement et {offer} embarquait l'URL directe de l'annonceur.
Installez l'adaptateur JS et liez l'offre ainsi :
<a href="/?_lp=1">Buy</a>
L'adaptateur réécrit cela en lien absolu vers le tracker et ajoute _subid et _token.
Landings Preload
Le tracker récupère votre page côté serveur, injecte <base href> pour que ses images et styles se chargent toujours depuis l'hôte d'origine, applique les macros et sert le résultat sous votre domaine — pas de redirection. Utilisez {offer} pour le lien d'offre.
Landings Action
Rien n'est montré. Choisissez ce qui arrive :
| Action | Résultat |
|---|---|
| Send to campaign | passe le visiteur à une autre campagne ; le clic compte dans les deux |
| Show a 404 error | page vide, statut 404 |
| Show as text | le texte que vous saisissez, en text/plain |
| Show as HTML | le HTML que vous saisissez |
| Do nothing | réponse vide ; le visiteur reste où il est |
{offer}, {clickid} et les paramètres de clic sont substitués dans les variantes texte et HTML.
Keitaro passe le visiteur à une autre campagne sans redirection. Orbitra utilise une redirection : rentrer dans le tracker dans la même requête reviendrait à inclure son script d'entrée deux fois, ce que PHP ne peut pas faire. Le clic est enregistré dans les deux campagnes de toute façon — le visiteur fait juste un saut de plus.
Adaptateur JS
<script src="https://your-tracker/js/orbitra-adapter.js"
data-postback="https://your-tracker/POSTBACK_KEY/postback"></script>
Collez-le dans le <head> de chaque page. Le panneau montre le snippet avec votre propre clé préremplie, sous les réglages de la landing.
Requis pour une landing redirect. Optionnel mais utile pour une locale à plusieurs pages : il porte le clic vers les pages internes et les formulaires, pour que la page deux sache encore qui est le visiteur.
Il laisse délibérément de côté ce que l'adaptateur de Keitaro réécrit : les liens #anchors, mailto:, tel: et javascript: sont intacts, et les liens vers des domaines tiers ne reçoivent jamais votre id de clic.
Signaler une conversion depuis la page
<a href="{offer}" onclick="orbitraPostback(this, event, 'lead', 10)">Buy</a>
Arguments : l'élément, l'événement, un statut de conversion, un payout optionnel et un id de transaction optionnel. La navigation se poursuit même si le postback échoue — perdre la vente pour un pépin de rapport serait le pire échange.
Pour un handler de formulaire, PHP est plus simple :
file_get_contents('https://your-tracker/POSTBACK_KEY/postback?subid=' . urlencode($_COOKIE['subid']) . '&status=lead');
Landings PHP
Désactivées par défaut. Activez-les dans Settings → General → Allow PHP landings, et seulement pour des landings dont vous faites confiance au code : une landing PHP tourne à l'intérieur du tracker, dans la racine web.
Prérequis
- La page d'entrée est
index.php. - Ces appels sont rejetés au téléversement :
exec,system,shell_exec,passthru,proc_open,popen,pcntl_exec,pcntl_fork,dl,eval,assert,create_function,symlink,link,set_time_limit,ini_set,ini_alter. - Incluez les autres fichiers par chemin absolu :
require_once dirname(__FILE__) . '/src/lib.php'; // right
require_once 'src/lib.php'; // wrong
- Gardez l'exécution sous le timeout (3 secondes par défaut, 9 maximum). Mettez des timeouts sur chaque appel curl :
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3);
curl_setopt($ch, CURLOPT_TIMEOUT, 3);
Lire le clic
<?php
$clickId = $rawClick->get('click_id');
$keyword = $rawClick->get('keyword');
$offer = $rawClick->get('offer'); // the offer URL, same as {offer}
$rawClick est en lecture seule. Pour enregistrer une conversion, envoyez un postback.
Le scan n'est pas une sandbox. Il lit la source téléversée avec le tokenizer propre de PHP, donc il voit de vrais appels plutôt que des mots dans des commentaires — mais
$f = 'sys' . 'tem'; $f();le bat, comme il bat la vérification équivalente dans tous les autres trackers. Ce qui contient réellement le risque, c'est que la fonctionnalité est désactivée par défaut, que seul un admin peut l'activer, et quedisable_functionsetopen_basedirdans votrephp.inis'appliquent à une landing exactement comme à tout le reste. Réglez-les.
LeadForge 2.0 (Landing Analyzer, JS Validation & Multi-Network Bridge)
LeadForge 2.0 est le moteur intégré d'Orbitra pour analyser, nettoyer et replanter des bundles de landing pages sur des réseaux d'affiliation cibles.
Modes d'intégration
- Auto Mode : détecte automatiquement le réseau source à partir des signatures de code et mappe les soumissions de formulaires vers le réseau cible.
- Cross-Network Mode : retire les handlers de commandes hérités du réseau (
send.php,order.php,api.php), nettoie les pixels/scripts de tracking étrangers et installe le bridge multi-réseaux universel. - Raw Mode (Clone Patch) : dénude les compteurs et scripts étrangers, injecte le bridge ClickID/SubID et les macros
{offer}sans générer de handlers backend.
Validation de téléphone 150-GEO & adaptateur client (orbitra_adapter.js)
Quand c'est activé, LeadForge injecte orbitra_adapter.js, qui fournit :
- 150 règles pays : patterns regex nationaux et internationaux exacts, vérifications de préfixes d'opérateurs mobiles, et contraintes de longueur min/max.
- Changement dynamique de pays : met à jour automatiquement les règles de validation, les plafonds de longueur et les helpers de compteur quand l'utilisateur change
<select name="country">. - Badges de saisie interactifs en direct : compteur en temps réel montrant les chiffres saisis et restants (p. ex. « 3 cifre inserite, 7 mancanti » → « Numero complete »).
- Validation stricte Unicode des noms : filtrage en temps réel empêchant chiffres et symboles de spam dans les noms des clients.
- Feedback vibratoire haptique : fait vibrer les appareils mobiles sur les tentatives de format de téléphone invalide.
- Bridge ClickID / SubID : capture tous les paramètres de tracking entrants (
subid,click_id,sub1..sub5,utm_*,fbp,fbc, etc.) et hydrate les champs de formulaires à travers des funnels multi-pages.
Bridge universel de commandes CPA (order.php)
Génère un handler de commandes autonome et auto-contenu supportant 10 réseaux CPA :
- Dr.Cash, Webvork (avec fallback SuperClient), Lucky.online, KMA.biz, TerraLeads (avec vérification de checksum SHA1), Leadbit, LemonAD, Everad, Ezaff, et Custom Webhooks.
- Normalisation E.164 automatisée : standardise les numéros de téléphone locaux au format international avec réconciliation du préfixe pays.
- Double journalisation CRM : envoie simultanément le lead au réseau d'affiliation et enregistre un snapshot complet du lead brut dans l'Orbitra CRM Vault (
orbitraCrmRecordLead//crm-ingest). - Journalisation locale failsafe : ajoute les leads à
leadforge.leads.logetorbitra_leads_backup.log.
Dépannage
Les images et vidéos ne se chargent pas. Utilisez des chemins relatifs. S'ils sont corrects et que la page arrive encore nue, vérifiez que vous ouvrez bien l'URL de campagne plutôt que landings/<id>/index.html directement.
Le bouton d'achat ne mène nulle part. La landing pointe probablement encore directement vers l'annonceur — une landing copiée du funnel de quelqu'un d'autre garde son lien d'affiliation. Remplacez ces href par {offer}.
Landing transition failed: original click not found. Une landing sur un autre domaine sans l'adaptateur JS, ou un visiteur avec les cookies désactivés et pas de _token dans l'URL.
no offer attached to this stream. Le stream a une landing mais pas d'offre. Ajoutez-en une, ou laissez la landing comme page finale et retirez le lien d'offre.
Une landing PHP affiche « disabled on this tracker ». La fonctionnalité est désactivée ; voir plus haut.
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 →