Docs

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.

TypeOù elle vitLien d'offre
LocalZIP téléversée, servie par le tracker{offer} ou /?_lp=1
Redirectvotre propre hébergement, un autre domaine/?_lp=1 + l'adaptateur JS
Preloadrécupérée par le tracker, montrée sous votre domaine{offer}
Actionrien 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

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 :

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 :

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 :

MacroValeur
{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 :

ActionRésultat
Send to campaignpasse le visiteur à une autre campagne ; le clic compte dans les deux
Show a 404 errorpage vide, statut 404
Show as textle texte que vous saisissez, en text/plain
Show as HTMLle HTML que vous saisissez
Do nothingré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

  1. La page d'entrée est index.php.
  2. 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.
  3. Incluez les autres fichiers par chemin absolu :
   require_once dirname(__FILE__) . '/src/lib.php';   // right
   require_once 'src/lib.php';                        // wrong
  1. 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 que disable_functions et open_basedir dans votre php.ini s'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

Validation de téléphone 150-GEO & adaptateur client (orbitra_adapter.js)

Quand c'est activé, LeadForge injecte orbitra_adapter.js, qui fournit :

Bridge universel de commandes CPA (order.php)

Génère un handler de commandes autonome et auto-contenu supportant 10 réseaux CPA :


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.

← Précédent
Browser check
Suivant →
PWA et Web Push
Voir la source sur GitHub: github.com/fenjo26/Orbitra.link/wiki
Tous les guides
Docs

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 →
Docs

Installation 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 →
Docs

Migrer 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 →
Docs

Migrer 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 →
Docs

Aperç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 →
Docs

Campaigns 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 →
Docs

Cloaking

La référence complète du cloaking : couches de détection, réglages globaux, filtres par stream, verdicts et rapports.

Lire le guide →
Docs

Browser check

Comment la vérification JS attrape bots, VM et émulateurs à travers les contradictions de l'environnement du navigateur.

Lire le guide →
Docs

Landing 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 →
Docs

PWA 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 →
Docs

Funnel 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 →
Docs

Popups 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 →
Docs

Enregistrements 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 →
Docs

Content 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 →
Docs

Bibliothè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 →
Docs

PWA 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 →
Docs

Postbacks et conversions

Postbacks entrants, types de conversion et devises, postbacks S2S sortants, macros, file de livraison, testeur, import et Conversions API.

Lire le guide →
Docs

Coû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 →
Docs

Ré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 →
Docs

Facebook / 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 →
Docs

Dolphin / 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 →
Docs

Nettoyage 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 →
Docs

Sources 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 →
Docs

Rapports, 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 →
Docs

Domaines et SSL

Ajouter des domaines, réglages par domaine, certificats Let's Encrypt et Cloudflare, registrars connectés et surveillance Backorder.

Lire le guide →
Docs

Cloudflare

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 →
Docs

Administration

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 →
Docs

Bot 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 →
Docs

MCP : 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 →