Docs

Cloaking

Le schéma de stream Cloaking répartit le trafic en deux branches : les visiteurs suspects (bots, modérateurs, data centers, VPN) voient la page safe, les vraies personnes la page money. Un seul module (core/CloakDetector.php) prend la décision pour tous les points d'entrée : l'URL de campagne (index.php), click.php et la Click API v3.

Un article technique détaillé en anglais : How the Orbitra Cloaker Works.

Configuration du stream

Safe page

HTML intégré, une URL externe, une landing locale ou une offre locale. Les landings et offres de la liste sont groupées par groupe, avec une recherche.

Money page

Fonctionne comme le schéma « Landing + Offer », y compris la sélection d'offre « before the click / after the click ».

Clean visitors to the next stream

La case « Send clean visitors to the next stream » transforme le cloak en filtre d'entrée. Les visiteurs suspects reçoivent la page safe, tandis que les clean continuent le long de la liste des streams — geos, appareils et langues sont répartis par des streams réguliers. La page money de ce stream n'est pas utilisée dans ce mode. Placez un tel stream en premier ou rendez-le intercepting pour que chaque visiteur passe la vérification.

Couches de détection

CoucheSourceNe fonctionne pas sans
Data centers / hostingUne blocklist ASN (core/data/asn_blocklist.json), les plages cloud et crawler publiées, des mots-clés d'hébergement dans le nom de l'ISPLa base ASN (GeoLite2-ASN)
VPN / proxyIP2Proxy PX12 (VPN, TOR, residential, threat, fraud score ≥ 80), une liste de VPN-ASNIP2Proxy PX12 / la base ASN
Blocklists de botsIPs et signatures User-Agent de Settings → Bots—
Heuristiques User-AgentCrawlers et outils (facebookexternalhit, meta-externalagent, curl, python, headless…), User-Agent vide, Accept-Language absent—

Si une base requise manque, l'éditeur de campagne affiche un avertissement directement dans la carte du cloak.

Sensitivity

Les signaux sont soit hard (une entrée explicite dans une blocklist ou une base de réputation), soit soft (des heuristiques individuellement bruitées).

NiveauPage safe quand
Lowuniquement un signal hard
Medium (défaut)un signal hard, ou deux soft
Highn'importe quel signal isolé

Targeting filters

Appliqués après les couches passives ; une non-correspondance signifie la page safe (TARGETING_SAFE) :

Vérification JavaScript

Désactivée par défaut. Le visiteur reçoit d'abord la page safe et passe à la page money via un lien signé à usage unique (TTL 5 minutes) seulement après avoir exécuté le JS. navigator.webdriver = true reste sur la page safe. Tout ce qui n'exécute pas de JS aussi. Le prix : un saut de plus pour chaque visiteur vivant.

Avec le browser check activé (Settings → Bots), la même étape collecte aussi des signaux du navigateur : en mode Soft ou Strict, une machine virtuelle, un émulateur ou un téléphone spoofé reçoivent la page safe ici, avec une raison bc_. Le champ Browser check* du stream peut le désactiver pour ce stream seulement.

Preloader. Pendant que l'étape JS tourne (une fraction de seconde) le visiteur voit une page de chargement, configurée par stream sous JS Challenge Preloader : la page intégrée, ou votre propre HTML avec une preview en direct. Historiquement, cette étape réutilisait le HTML de la page safe — ce markup est toujours affiché quand aucun preloader n'est configuré, pour que les campagnes existantes gardent leur look ; choisissez Custom HTML pour le remplacer. La sonde de vérification est injectée dans votre HTML automatiquement — n'ajoutez pas vos propres scripts de redirection, ils font la course avec le lien signé.

Enregistrement et rapports

RéglageDéfautCe qu'il fait
Record Safe Page clicksonLes visites de la page safe sont écrites avec is_safe_page = 1. Désactivez-le et elles n'atteindront pas la base
Exclude Safe Page clicks from reportsonLes visites restent dans le journal des clics mais sortent de chaque métrique de rapport — clics, visites, uniques, bots, referers vides, coût, CPV. Une visite safe reste une visite du lien de campagne, donc avec la case décochée elle compte aussi dans « Clicks » (depuis 1.8.5, les clics comptent chaque visite)

Même quand les visites ne sont pas écrites, le compteur des visites supprimées (cloak_suppressed_stats) les compte par campagne, stream, jour et verdict — « zéro clics » ne cachera pas le vrai trafic.

Réglages globaux : Settings → Bots

Diagnostics

Verdicts et raisons

Verdicts : money, passive_safe, targeting_safe, js_safe. Les raisons sont écrites dans clicks.cloak_reasons ; les principales :

CodeSignification
geo_country / geo_unknownpays absent de la liste / pays non déterminable
device_typetype d'appareil non autorisé
bot_isp, isp_blocklistISP dans la liste des bots et data centers
datacenter_asn, asn_datacenterASN de data center ou d'hébergement
vpn_proxy_asnASN d'un fournisseur VPN ou proxy
iprange_datacenterIP dans une plage cloud ou crawler publiée
hosting_ispmot-clé d'hébergement dans le nom de l'ISP
ip2proxy_*un signal IP2Proxy : vpn_proxy, datacenter, residential, tor, bot, threat, high_fraud
bot_blocklistIP dans la liste des bots
crawler_or_tool_ua, suspicious_ua, no_user_agent, missing_accept_languageheuristiques User-Agent et en-têtes
webdriver, js_missing, js_fingerprintvérification JavaScript

Problèmes courants

SymptômeQuoi vérifier
Le dashboard pub montre des clics, le tracker zéroSi l'enregistrement des clics Safe Page est désactivé ; le compteur des visites supprimées
100 % du trafic sur la page safeSi la base geo est installée (⚙ → Geo databases) ; raisons geo_unknown dans le journal des clics
Des utilisateurs mobiles vivants sur la page safeRaison ip2proxy_vpn_proxy — retirez la couche VPN/proxy (c'est un signal hard ; une sensitivity basse ne l'annulera pas)
Les reviewers Meta ou Telegram atteignent l'offreLeurs réseaux ne sont pas marqués comme data centers par l'ASN ; une seule entrée de plage à sensitivity medium n'est qu'un signal soft. Montez la sensitivity ou ajoutez un filtre « Bot » à un stream intercepting
← Précédent
Campaigns et streams
Suivant →
Browser check
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 →