Administration
Tout ce qui s'ouvre depuis le menu ⚙ dans le coin en haut à droite du panneau.
Utilisateurs et accès
⚙ → Users. Deux onglets : Users (la table des comptes, visible par les admins) et Profile (votre propre compte — pour chaque utilisateur).
Rôles
Il y a deux rôles : admin (accès complet) et user (permissions par ressource). Le compte créé à l'installation ne peut pas être supprimé, pas plus que le dernier admin restant. Les utilisateurs ont des templates de permissions : media buyer, monteur vidéo / designer, développeur, ou des permissions custom.
Les permissions sont accordées par ressource : campagnes, offres, landings, sources, réseaux d'affiliation, domaines, logs, gallery, push. Les niveaux sont full, read-only, no access. Pour les campagnes il y a aussi own + assigned et assigned only — alors l'utilisateur ne voit et n'édite que ces campagnes partout : dans les listes, les rapports, les logs, les conversions, sur le dashboard. Les données financières peuvent être cachées séparément : coûts, revenus, payouts.
Les permissions sont appliquées côté serveur. Les actions assignées à aucune ressource sont réservées aux admins (liste complète dans REST API). Les opérations globalement dangereuses (vider les statistiques, import Keitaro, import de conversions, re-mapping rétroactif) sont indisponibles aux utilisateurs avec l'accès « own + assigned ».
Profil
Login, e-mail, langue de l'interface, fuseau horaire (environ 250 zones avec l'offset UTC courant), premier jour de la semaine, changement de mot de passe (exige le mot de passe actuel ; minimum 8 caractères).
Authentification à deux facteurs — TOTP via une app d'authentification. Les codes sont à usage unique.
Clés API
Créées par un admin pour un utilisateur : read — lecture seule, write — aussi la gestion. La clé est passée dans l'en-tête Authorization: Bearer <key> ou X-Api-Key. Utilisée dans MCP, la REST API, la réception des coûts de Dolphin / Fbtool, et l'extension Ads Manager.
Connexion
Limites de tentatives échouées : 5 par 5 minutes depuis une IP, et 20 par 15 minutes par compte (remises à zéro après une connexion réussie). La durée de vie de session est session_lifetime (un jour par défaut, de 5 minutes à 30 jours ; la variable d'environnement ORBITRA_SESSION_LIFETIME est prioritaire sur le réglage).
Réglages
⚙ → Settings, onglets :
| Onglet | Ce qu'il y a |
|---|---|
| General | Clé de postback, devise par défaut, IP serveur manuelle, permission des landings PHP (désactivée par défaut) et leur timeout de 1–9 s |
| Bots | Mode Browser check (Off / Observe only / Soft / Strict), IPs et signatures de bots, la liste globale Bot ISP, les plages datacenter, les ASN VPN comme signal de bot — voir Cloaking |
| Conversion types | Statuts custom et ce qu'ils signifient, statuts non mappés — voir Postbacks |
| Custom metrics | Formules custom pour les rapports |
| Automation | Crons : file des postbacks, backorder |
| System | Collecte des statistiques on/off, ignorer le prefetch, vérifications de nouvelles versions, durées de rétention des logs et archives, accès au panneau par IP/sous-réseaux, chemin du panneau admin |
| Privacy | Protection contre le scan : quoi répondre quand un lien qui marche est touché directement sans paramètres de campagne — une 302 vers votre URL, un 404, ou une page vide |
Chemin du panneau
/admin.php est la première chose que tout scanner vérifie. Dans System → Admin panel path vous pouvez le remplacer par le vôtre (/my-panel), après quoi /admin.php se met à répondre 404. Cela cache le formulaire de login mais ne remplace pas le mot de passe. Si le chemin est oublié :
php /var/www/orbitra/cli/admin_path.php # print the current path
php /var/www/orbitra/cli/admin_path.php reset # вернуть /admin.php
Accès au panneau par IP
Une liste d'IPs et de sous-réseaux (IPv4 et IPv6, un par ligne). Vide — le panneau est accessible de partout. Remplie — la connexion au panneau et les appels api.php autorisés ne fonctionnent que depuis ces adresses. Les en-têtes X-Forwarded-For ne sont crus par le tracker que depuis Cloudflare et les proxys privés. Attention : vous pouvez vous enfermer dehors. Pour lever la restriction depuis le serveur :
sudo -u www-data php -r '$db = new PDO("sqlite:/var/www/orbitra/orbitra_db.sqlite"); $db->exec("UPDATE settings SET value = \x27\x27 WHERE key = \x27admin_ip_access\x27");'
Durées de rétention
Les champs « Log retention period » et « Archive resource retention period » ne fonctionnent que si le cron de nettoyage tourne. L'installateur ne le met pas en place — ajoutez-le à la main :
0 3 * * * php /var/www/orbitra/cli/cleanup_cron.php >> /var/www/orbitra/var/logs/cleanup.log 2>&1
La suppression tourne par lots pour ne pas bloquer la base.
Personnalisation
⚙ → Personalization — logo, nom, thème clair ou sombre et palettes : Cobalt, Canary, Parchment, Indigo (en variantes claire et sombre), Terminal, Aurora. Le thème est appliqué avant la première peinture, donc le thème sombre est sombre dès la première frame.
La langue de l'interface se règle dans le profil : English, Русский, Українська, Español, Deutsch, Français, 中文.
Bases geo
⚙ → Geo Databases. Sans base geo, les filtres par pays et le cloaking par pays ne fonctionnent pas (tous les visiteurs sont Unknown) ; sans base ASN — les couches datacenter et liste d'ISP.
| Base | Clé | Fournit |
|---|---|---|
| Sypex Geo City | pas nécessaire | Pays, région, ville. Installée par l'installateur |
| MaxMind GeoLite2 City / ASN | clé de licence MaxMind | Ville, ASN et fournisseur |
| IP2Location DB11 | token IP2Location | Geo, fuseau horaire |
| IP2Proxy PX12 | token IP2Location | VPN, proxy, TOR, résidentiel, score de fraude |
Les bases se mettent à jour chaque mois par le cron cli/geo_update.php (taggé # orbitra-geo ; MaxMind et IP2 — seulement si les clés sont enregistrées). Une mise à jour du panneau installe Sypex tout seul quand il n'y a aucune base. Un bandeau sur tous les onglets prévient quand il n'y a pas de bases ou seulement Sypex.
⚙ → Geo profiles — des sets de pays tout faits pour les filtres (EU, CIS, etc.) et des personnalisés.
Mise à jour
⚙ → Update — vérifie une nouvelle version sur GitHub et met à jour avec un bouton (git pull en tant qu'utilisateur web). La vérification est mise en cache une heure, 10 minutes en cas d'erreur ; désactivable dans System → Notify about new versions.
Après une mise à jour le panneau, tout seul :
- restaure le cron de la file des postbacks s'il manque ;
- télécharge Sypex Geo quand il n'y a pas de bases geo ;
- avertit si le serveur tourne en PHP inférieur à 8.4 (comment mettre à jour PHP — Déploiement).
Les changements qui exigent root (règles sudo, helpers SSL) ne peuvent pas être faits par le bouton — le panneau montre un bandeau avec la commande cli/server_setup.sh (Déploiement).
Si exec est désactivé sur l'hébergement, la page montre les commandes pour une mise à jour manuelle via Git.
Divers
| Élément de menu | Ce qu'il fait |
|---|---|
| Archive | Campagnes, offres, landings, sources, réseaux d'affiliation supprimés : restaurer ou effacer pour de bon |
| Clear statistics | Supprimer les clics et conversions d'une période, ou tous |
| Migrations | Version du schéma de base, import Keitaro (Migration depuis Keitaro) |
| Status | Disque, CPU, RAM, taille de la base |
| Logs | Trafic, postbacks, S2S, système, audit (Rapports et logs) |
| Gallery | Médiathèque pour PWA, landings et offres (Content Gallery) |
| AI / MCP | Connecter un assistant IA (MCP) |
| Support and feedback | Contacts et bloc partenaires |
Extension Ads Manager
Une extension pour Chrome et les navigateurs antidétection basés sur Chromium montre les métriques Orbitra à côté des lignes campagne, ad group et ad dans Facebook Ads Manager (rafraîchies toutes les 30 secondes), et au clic — une décomposition sur trois jours : historique quotidien, landings et offres, précision de livraison Pixel / CAPI.
- ⚙ → Integrations → Chrome & Antidetect Extension — téléchargez l'archive et décompressez-la.
- Chargez le dossier comme extension non empaquetée (ou un ZIP, là où c'est supporté).
- Dans le popup de l'extension, collez l'URL du tracker et la clé read mise en évidence qu'Orbitra affiche.
L'extension n'a besoin que d'une clé read. Les hits safe sont exclus de la même manière que dans les rapports.
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 →