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
| Couche | Source | Ne fonctionne pas sans |
|---|---|---|
| Data centers / hosting | Une 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'ISP | La base ASN (GeoLite2-ASN) |
| VPN / proxy | IP2Proxy PX12 (VPN, TOR, residential, threat, fraud score ≥ 80), une liste de VPN-ASN | IP2Proxy PX12 / la base ASN |
| Blocklists de bots | IPs et signatures User-Agent de Settings → Bots | — |
| Heuristiques User-Agent | Crawlers 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).
| Niveau | Page safe quand |
|---|---|
| Low | uniquement un signal hard |
| Medium (défaut) | un signal hard, ou deux soft |
| High | n'importe quel signal isolé |
Targeting filters
Appliqués après les couches passives ; une non-correspondance signifie la page safe (TARGETING_SAFE) :
- Countries — allow ou block d'une liste. Si le pays ne peut être déterminé, la raison est enregistrée comme
geo_unknownplutôt quegeo_country. Sans base geo, chaque visiteur estUnknownet le filtre par pays enverra 100 % du trafic vers la page safe ; l'éditeur prévient de cela. - Device types — seulement ceux sélectionnés, ou tous sauf ceux sélectionnés.
- Block bots and data-center providers — l'ISP et l'ASN du visiteur comparés à une liste : la liste locale du stream ou, si elle est vide, la globale de Settings → Bots.
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églage | Défaut | Ce qu'il fait |
|---|---|---|
| Record Safe Page clicks | on | Les 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 reports | on | Les 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
- Bot IP addresses — IPs et CIDR, IPv4 et IPv6. Chaque entrée a une source (manuelle ou d'un feed) ; le nettoyage peut supprimer les entrées d'une seule source.
- Signatures (User-Agent) — des sous-chaînes.
- Global Bot ISP blacklist — un fournisseur par ligne. Les chaînes trop courtes et trop génériques (
Inc,LLC) sont ignorées : elles correspondraient à presque tous les ISP. - Data-center and crawler IP ranges — les plages publiées d'AWS, Google Cloud et Googlebot, Bing, Azure, Oracle, DigitalOcean, Facebook, Telegram, OpenAI, Cloudflare, Apple Private Relay, et d'autres depuis lord-alfred/ipranges. Mises à jour quotidiennement par le cron
ipranges_cron.php(manuellement via le bouton « Update now » ouphp ipranges_cron.php --force), stockées dansvar/ipranges/. Tant que les listes ne sont pas téléchargées, la couche est inactive. - Browser check — Off / Observe only / Soft / Strict : bots, VM et émulateurs attrapés par les contradictions du navigateur. → Browser check
- Treat VPN ASN as a bot signal — activé par défaut. Désactivez-le si votre audience se trouve largement derrière un VPN commercial.
Diagnostics
- La carte du cloak dans l'éditeur — combien de visites sont allées en money et en safe sur la période choisie, les raisons principales, et un lien vers le journal des clics avec la même fenêtre. Si presque tout le trafic va vers la page safe, la carte prévient.
- Le journal des clics — les colonnes « Route » et « Reason » apparaissent automatiquement quand il y a des clics du cloak sur la page, avec un filtre par route et par raison. La fiche de clic montre le verdict et les raisons, mais seulement pour les clics que le cloak a réellement jugés.
- Le test link avec
_dbg=1— une trace de routage sans enregistrer de clic ;_geo=XXoverride le pays (Campaigns et streams). - Le log PHP — des lignes comme
Orbitra cloak [campaign=12 stream=34]: stage=PASSIVE_SAFE ... reasons=[crawler_or_tool_ua].
Verdicts et raisons
Verdicts : money, passive_safe, targeting_safe, js_safe. Les raisons sont écrites dans clicks.cloak_reasons ; les principales :
| Code | Signification |
|---|---|
geo_country / geo_unknown | pays absent de la liste / pays non déterminable |
device_type | type d'appareil non autorisé |
bot_isp, isp_blocklist | ISP dans la liste des bots et data centers |
datacenter_asn, asn_datacenter | ASN de data center ou d'hébergement |
vpn_proxy_asn | ASN d'un fournisseur VPN ou proxy |
iprange_datacenter | IP dans une plage cloud ou crawler publiée |
hosting_isp | mot-clé d'hébergement dans le nom de l'ISP |
ip2proxy_* | un signal IP2Proxy : vpn_proxy, datacenter, residential, tor, bot, threat, high_fraud |
bot_blocklist | IP dans la liste des bots |
crawler_or_tool_ua, suspicious_ua, no_user_agent, missing_accept_language | heuristiques User-Agent et en-têtes |
webdriver, js_missing, js_fingerprint | vérification JavaScript |
Problèmes courants
| Symptôme | Quoi vérifier |
|---|---|
| Le dashboard pub montre des clics, le tracker zéro | Si l'enregistrement des clics Safe Page est désactivé ; le compteur des visites supprimées |
| 100 % du trafic sur la page safe | Si la base geo est installée (⚙ → Geo databases) ; raisons geo_unknown dans le journal des clics |
| Des utilisateurs mobiles vivants sur la page safe | Raison 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'offre | Leurs 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 |
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 →