Campaigns et streams
Une campagne est l'URL sur laquelle arrive le trafic, plus un ensemble de streams qui décident où va chaque visiteur. La section Campaigns est dans le menu du haut.
L'éditeur de campagne
L'éditeur s'ouvre en plein écran. Sur un écran large (1280px et plus) il est scindé en deux panneaux : réglages de campagne à gauche, streams à droite ; sur un écran plus étroit il devient une seule colonne.
Onglets de réglages
| Onglet | Ce qu'il y a |
|---|---|
| General | Nom, alias (6 caractères, générés automatiquement), URL de campagne, domaine, groupe, source de trafic, état, test link ; plus bas sur l'onglet — la carte social link preview et la règle Zone Killer |
| Finance | Modèle de coût, unicité, type de rotation des streams |
| Parameters | Quels paramètres de lien le tracker enregistre dans le clic (keyword, cost, external_id, creative_id, ad_campaign_id, source, sub_id_1 … sub_id_30) et depuis quels paramètres de source les prendre |
| Integrations | Pixels (Facebook / TikTok etc., voir Facebook / Meta) et connexion de la synchronisation des coûts (Coûts) |
| Tracking | Générateur de code d'intégration : le script de tracking, kclient.js, kclient.php, le pixel, les bannières (script / iframe), le plugin WordPress, les widgets (compteur à rebours, « back button », exit-intent). Disponible après le premier enregistrement — le code contient le token de campagne |
| Popup | Le popup de conversion propre à la campagne : on/off (un point sur l'onglet tant qu'il est actif), une preview en direct, quatre étapes et une section Advanced |
| S2S Postbacks | Postbacks sortants vers la source de trafic, un tester de postback, le renvoi des conversions manquées — voir Postbacks et conversions |
| Notes | Texte libre |
Modèles de coût
CPC, CPV, CPuC (par clic unique), CPM, CPA, CPS, RevShare. Le coût manuel est écrasé par l'import des coûts s'il est connecté (Coûts).
Unicité
- Méthode : IP, IP + User-Agent, ou Cookies.
- Période : en heures.
- L'unicité est calculée dans trois périmètres — par campagne, par stream et globalement ; les trois sont visibles dans les rapports.
État de la campagne
Une campagne arrêtée (paused / disabled) répond 503, une archivée répond 404. Cela vaut pour l'URL d'alias, click.php et la Click API.
Social link preview
Une carte sur l'onglet General de l'éditeur. Quand c'est activé, un bot de preview social ou messagerie qui frappe l'URL de campagne — facebookexternalhit, telegrambot, whatsapp, twitterbot et les autres fetchers de preview de lien — reçoit une carte og:* minimale avec votre titre, votre description et votre image au lieu du flux de clics. Chaque humain est routé exactement comme toujours : pas de délai, pas de page différente.
Les crawlers des moteurs de recherche (googlebot & co) continuent délibérément de voir la vraie réponse de la campagne — il ne s'agit que des fetchers de preview des messageries ; la gestion complète des bots est le travail du cloaking. L'avertissement unique enregistre que les règles des plateformes sur les previews personnalisées relèvent de la responsabilité de l'opérateur.
Streams
Un stream est une règle de routage : des filtres (à qui il correspond) + un schéma (quoi montrer).
Types et ordre
- Intercepting — vérifié en premier. Convient aux bots, aux pages blanches, aux exceptions.
- Regular — le trafic principal. Sélectionné par position ou par poids (le type de rotation sur l'onglet « Finance »).
- Default — quand rien au-dessus n'a correspondu.
L'enregistrement d'une campagne ne recrée pas ses streams : chaque stream garde un ID stable, pour que l'historique des clics ne se disperse pas entre de vieux numéros. Les nouveaux streams s'appellent « Stream 1 », « Stream 2 »… Le chevron d'une carte replie le stream ; l'état est mémorisé par campagne.
Chaque carte de stream montre les visites, les uniques, les bots et la part du trafic de campagne pour aujourd'hui / hier / 7 / 30 jours. On voit ainsi facilement combien de trafic est allé au stream blanc et combien au stream money.
Filtres
| Filtre | Comment ça marche |
|---|---|
| Country | Une liste de pays ou un profil geo (EU, CIS…). Si le pays ne peut être déterminé et que le mode « include » est actif, le filtre ne laisse pas passer le visiteur — mais seulement quand une base geo est installée ; sans elle, le filtre s'abstient |
| Device | Desktop / mobile / tablettes |
| Operating system, Browser | Les valeurs sont choisies dans la liste que le tracker reconnaît réellement, y compris les in-app browsers (TikTok, Facebook, Instagram, Telegram, WebView). Vous pouvez saisir votre propre valeur et appuyer sur Enter |
| Browser language | en — n'importe quel anglais, en-IN — anglais (Inde) seulement. Tout le Accept-Language est considéré, pas seulement la première langue |
| Bot | Le détecteur de bots à sensibilité maximale (le même que celui du cloaking) |
| IP address | Adresses et CIDR, IPv4 et IPv6 |
| Provider (ISP) | Comparé à l'ISP et à l'ASN du visiteur (nécessite la base ASN) |
| Connection type | À partir des données de la base geo |
| Referer, Keyword | Comparés à la valeur du clic |
| URL parameter | N'importe quel paramètre de lien par nom. Correspondance exacte insensible à la casse, * — n'importe quels caractères, « Empty » — le paramètre est absent ou vide |
| Day of week, Time | Selon l'heure locale du visiteur (fuseau horaire issu de la base geo ; sans elle, heure du serveur) |
Les filtres d'un stream sont combinés en AND (tous doivent correspondre) ou OR (un seul suffit). Un filtre qui ne peut pas trancher (pas de base geo, pas de données ISP) ne vote pas : en « AND » il ne bloque pas le stream, en « OR » il ne l'ouvre pas.
Une astuce contre la modération TikTok via « URL parameter » : ajoutez xxx=__PLACEMENT__ à l'URL de campagne ; sur un stream intercepting avec une page blanche, mettez un filtre « URL parameter » sur xxx avec les valeurs __PLACEMENT__ et « Empty ». Dans un vrai clic, le réseau substitue la valeur de la macro, tandis qu'un modérateur qui ouvre le lien nu arrive avec __PLACEMENT__ ou sans le paramètre.
Schémas
| Schéma | Ce qui se passe |
|---|---|
| Direct redirect to offer | Une redirection vers une offre du catalogue (plusieurs offres en rotation par poids) ou vers une URL directe. Chaque transition de ce genre est un clic |
| Landing + Offer | Montre une landing depuis laquelle le visiteur poursuit vers l'offre. L'offre est optionnelle |
| Action | Ne rien faire, 404, montrer du texte, montrer du HTML, envoyer vers une autre campagne (le clic est écrit dans les deux) |
| Cloaking | Répartit le trafic entre une page safe et une page money — voir Cloaking |
Sélection de l'offre dans le schéma « Landing + Offer » :
- After the click (le défaut pour les nouveaux streams) — l'offre est choisie quand le visiteur quitte réellement la landing. Les clics LP, le CTR LP et le temps jusqu'à l'offre sont honnêtes.
- Before the click — chaque vue de landing compte comme un clic vers l'offre (comportement historique, CTR LP autour de 100 %).
Comment construire le lien d'offre sur la landing elle-même ({offer}, /?_lp=1, passage de sub_id_N à l'offre) est couvert dans Landing pages.
Types de redirection d'offre
Se règlent sur l'offre. Macros et vérification SSRF sont les mêmes pour tous les types.
| Type | Comportement |
|---|---|
| HTTP redirect | 302, le défaut |
| JS redirect | Une page HTML qui navigue via JavaScript |
| Meta Refresh | Une balise <meta http-equiv="refresh"> |
| Iframe | L'offre dans une iframe plein écran sur votre domaine |
| Form Submit | Un formulaire POST auto-soumis : les données de tracking dans le corps de la requête |
| curl proxy | La page de l'offre servie à travers votre serveur avec une balise <base> |
Rotation avec auto-optimisation
L'interrupteur Auto à côté de la liste d'offres ou de landings d'un stream active le recalcul automatique des poids selon une métrique : ventes confirmées, CR, EPV, EPC ou ROI (le ROI exige les coûts). Configurable : la fenêtre en jours, le nombre minimal de ventes avant de participer au split, les bornes basse et haute de la part, et l'intervalle de recalcul. Le recalcul est fait par le cron rotation_optimiser_cron.php ; le journal des décisions est visible dans la carte du stream. Tant que « Auto » est actif, la saisie manuelle des poids est verrouillée.
Autres réglages de stream
- Collect clicks — quand désactivé, le visiteur reçoit quand même une direction, mais le clic n'est pas écrit (rien à quoi attacher une conversion).
Bot Challenge est un réglage de campagne, pas de stream : une vérification humaine (reCAPTCHA v2/v3 ou votre propre code) avant qu'un stream soit choisi.
Test link
La ligne Test link de l'onglet « General » produit une URL de campagne signée avec ?_t=<id>:<hmac>. Le routage réel fonctionne le long d'elle — streams, filtres, rotation, landings, offres — mais le clic n'est pas enregistré, donc les statistiques restent propres.
&_geo=DE— override du pays du visiteur : testez des streams geo sans VPN.&_dbg=1— au lieu d'une redirection, une page de trace : chaque stream avec son type, son schéma et le vote de chaque filtre (correspondu / non correspondu / abstention et pourquoi), le stream sélectionné, et l'URL finale avec les macros substituées.
La signature est dérivée de la clé de postback de l'installation, donc elle survit à un changement de token de campagne ; changer la clé de postback révoque tous les test links. Une signature invalide ou étrangère transforme la requête en clic ordinaire.
Simulation de trafic
⚙ → Traffic simulation : réglez une IP, un User-Agent, un pays, un appareil, une langue et des paramètres d'URL — le panneau montrera quel stream a tiré et pourquoi, sans rien enregistrer.
Click API et tokens de campagne
Chaque campagne a un token (32 caractères hexadécimaux). Les scripts d'intégration (click.php, kclient.php, tracking.js, Click API v3 /click_api/v3) adressent la campagne par token, pas par ID. Les tokens sont transférés à l'import depuis Keitaro, pour que les scripts déjà installés continuent de fonctionner. Le token peut être réémis dans l'éditeur. Pour le détail du client PHP, voir Tracking Client (PHP).
Protection anti-doublons
- Un clic répété du même visiteur (campagne + IP + User-Agent) dans les 2 secondes n'est pas écrit comme une seconde ligne ; la redirection reçoit l'ID du clic déjà enregistré.
- Les requêtes de prefetch/prerender du navigateur sont servies mais non écrites.
- Si la base est occupée (
database is locked), le clic va dansvar/spool/clicks.log, et le croncli/click_spool_cron.phpl'écrit dans la minute.
Opérations en masse
Copie de campagne, suppression en masse, import, déplacement d'un groupe de campagnes vers un autre domaine (bulk_set_campaign_domain, aussi dans MCP), renommage des groupes directement dans la liste.
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 →