Docs

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

OngletCe qu'il y a
GeneralNom, 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
FinanceModèle de coût, unicité, type de rotation des streams
ParametersQuels 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
IntegrationsPixels (Facebook / TikTok etc., voir Facebook / Meta) et connexion de la synchronisation des coûts (Coûts)
TrackingGé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
PopupLe 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 PostbacksPostbacks sortants vers la source de trafic, un tester de postback, le renvoi des conversions manquées — voir Postbacks et conversions
NotesTexte 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é

É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.

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

  1. Intercepting — vérifié en premier. Convient aux bots, aux pages blanches, aux exceptions.
  2. Regular — le trafic principal. Sélectionné par position ou par poids (le type de rotation sur l'onglet « Finance »).
  3. 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

FiltreComment ça marche
CountryUne 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
DeviceDesktop / mobile / tablettes
Operating system, BrowserLes 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 languageen — n'importe quel anglais, en-IN — anglais (Inde) seulement. Tout le Accept-Language est considéré, pas seulement la première langue
BotLe détecteur de bots à sensibilité maximale (le même que celui du cloaking)
IP addressAdresses 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, KeywordComparés à la valeur du clic
URL parameterN'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, TimeSelon 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émaCe qui se passe
Direct redirect to offerUne 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 + OfferMontre une landing depuis laquelle le visiteur poursuit vers l'offre. L'offre est optionnelle
ActionNe rien faire, 404, montrer du texte, montrer du HTML, envoyer vers une autre campagne (le clic est écrit dans les deux)
CloakingRépartit le trafic entre une page safe et une page money — voir Cloaking

Sélection de l'offre dans le schéma « Landing + Offer » :

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.

TypeComportement
HTTP redirect302, le défaut
JS redirectUne page HTML qui navigue via JavaScript
Meta RefreshUne balise <meta http-equiv="refresh">
IframeL'offre dans une iframe plein écran sur votre domaine
Form SubmitUn formulaire POST auto-soumis : les données de tracking dans le corps de la requête
curl proxyLa 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

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.

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.

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

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.

← Précédent
Aperçu des fonctionnalités
Suivant →
Cloaking
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 →