Migrer depuis Keitaro
Orbitra transfère les réglages depuis Keitaro — réseaux d'affiliation, offres, domaines, campagnes avec leurs tokens Click API, streams avec leurs filtres, postbacks de campagne, landing pages et sources. Les statistiques de clics ne sont pas transférées : c'est un nouveau départ.
Ce qui est transféré
| Keitaro | Orbitra | Ce qui est préservé |
|---|---|---|
| Réseaux d'affiliation | Réseaux d'affiliation | Postback URL, paramètres d'offre |
| Offres | Offres | URL, payout, geo |
| Domaines | Domaines | Parking, HTTPS-only |
| Groupes | Groupes de campagnes | Nom |
| Campagnes | Campagnes | Alias, token Click API, état, source |
| Streams | Streams | Type, position, poids, schéma, action, filtres (y compris sub_id_N et les filtres de paramètres), modes « allow / deny », associations avec offres et landing pages |
| Postbacks de campagne | S2S Postbacks | URL, méthode, statuts |
| Landing pages | Landing pages | Noms et URLs |
| Sources | Sources | Paramètres |
Non transférés : clics et conversions, utilisateurs, fichiers des landings locales (seulement les enregistrements les concernant). Les filtres non transférables sont listés dans le rapport d'import.
Les templates de sources et de réseaux d'affiliation de Keitaro sont déjà intégrés à Orbitra — pas besoin de les transférer (Sources de trafic et réseaux d'affiliation).
1. Dump sur le serveur Keitaro
Connectez-vous au serveur Keitaro en SSH en root et lancez la commande dans son intégralité. Elle prend les identifiants de la base dans /etc/keitaro/env/inventory.env, fonctionne aussi bien avec un client MariaDB sur l'hôte qu'avec MariaDB dans un conteneur Docker Keitaro, ne dump que les tables de réglages (pas les journaux de clics) et refuse de s'exécuter si les tables sont introuvables — donc vous ne dumperez jamais accidentellement toute la base.
bash <<'ORBITRA_DUMP'
set -eo pipefail
# Sourced before set -u: the env file is Keitaro's, not ours.
source /etc/keitaro/env/inventory.env
set -u
# Password goes through the environment, never through argv or a file left on disk.
export MYSQL_PWD="$MARIADB_KEITARO_PASSWORD"
DB="$MARIADB_KEITARO_DATABASE"
# MariaDB client on the host, or inside the Keitaro MariaDB container.
if CLI=$(command -v mariadb || command -v mysql) && DUMP=$(command -v mariadb-dump || command -v mysqldump); then
sql() { "$CLI" -u"$MARIADB_KEITARO_USER" -h127.0.0.1 -P3306 --protocol=tcp "$@" </dev/null; }
dump() { "$DUMP" -u"$MARIADB_KEITARO_USER" -h127.0.0.1 -P3306 --protocol=tcp "$@" </dev/null; }
else
CT=$(docker ps --format '{{.Names}}' 2>/dev/null | grep -i -m1 -E 'mariadb|mysql' || true)
if [ -z "$CT" ]; then
echo "ERROR: no MariaDB client on this server and no MariaDB container found" >&2
exit 1
fi
echo "Using MariaDB inside container: $CT"
sql() { docker exec -e MYSQL_PWD "$CT" sh -c 'exec $(command -v mariadb || command -v mysql) "$@"' sh -u"$MARIADB_KEITARO_USER" "$@" </dev/null; }
dump() { docker exec -e MYSQL_PWD "$CT" sh -c 'exec $(command -v mariadb-dump || command -v mysqldump) "$@"' sh -u"$MARIADB_KEITARO_USER" "$@" </dev/null; }
fi
# Settings tables only: campaigns, offers, domains, streams... - no click logs.
TABLES=$(sql -N "$DB" -e "
SELECT table_name FROM information_schema.tables
WHERE table_schema = DATABASE()
AND table_name IN (
'keitaro_affiliate_networks', 'keitaro_groups', 'keitaro_offers',
'keitaro_domains', 'keitaro_campaigns', 'keitaro_campaign_postbacks',
'keitaro_landings', 'keitaro_streams', 'keitaro_stream_filters',
'keitaro_stream_offer_associations', 'keitaro_stream_landing_associations',
'keitaro_traffic_sources', 'keitaro_ref_sources')
ORDER BY table_name" | tr '\n' ' ')
# Without a table list mysqldump would dump the WHOLE database, click logs included.
if [ -z "$(echo $TABLES)" ]; then
echo "ERROR: no Keitaro tables found in database $DB" >&2
exit 1
fi
OUT=/root/keitaro_orbitra_full.sql.gz
echo "Dumping tables: $TABLES"
dump --single-transaction --quick --skip-lock-tables "$DB" $TABLES | gzip -1 > "$OUT"
ls -lah "$OUT"
echo "DONE: $OUT"
ORBITRA_DUMP
À la fin vous verrez DONE: /root/keitaro_orbitra_full.sql.gz. Le fichier fait habituellement 1–5 Mo.
2. Télécharger le fichier
Sur la page ⚙ → Migrations, saisissez l'IP du serveur Keitaro — le panneau la remplira dans des commandes toutes prêtes. Exécutez la commande sur votre ordinateur, pas sur le serveur :
# macOS / Linux
scp root@IP_KEITARO:/root/keitaro_orbitra_full.sql.gz ~/Downloads/
# Windows (PowerShell)
scp root@IP_KEITARO:/root/keitaro_orbitra_full.sql.gz $env:USERPROFILE\Downloads\
3. Importer dans Orbitra
⚙ → Migrations → Import from Keitaro (SQL dump) :
- Choisissez un fichier
.sql.gzou.sql. Le dump n'est pas exécuté comme du SQL — il est seulement analysé. - Cochez quoi importer. Keep campaign IDs (ID Orbitra = ID Keitaro) ne fonctionne que sur une installation propre où la table des campagnes est vide, archive comprise.
- Show preview — un essai à blanc sans écriture : combien d'objets de chaque type seront importés et quels filtres ne passent pas.
- Import into Orbitra.
Pour des imports répétés sur un serveur de test, il y a un bloc Cleanup : il supprime toute la configuration du tracker (domaines, offres, réseaux d'affiliation, campagnes, streams, postbacks, pixels, sources, landing pages, groupes) sans toucher aux statistiques ni aux utilisateurs. Vous devez taper DELETE pour confirmer.
4. Après l'import
- Tokens. Ouvrez quelques campagnes — le token Click API devrait correspondre à celui de Keitaro. Les scripts d'intégration sur vos sites (
click.php, KClient) continuent alors de fonctionner ; il vous suffit d'y changer l'adresse du tracker. - Domaines. Pointez les enregistrements A des domaines vers le nouveau serveur (ou connectez Cloudflare / Namecheap / Dynadot — les enregistrements seront posés automatiquement) et attendez les certificats (Domains et SSL).
- Postbacks des réseaux. La Postback URL dans Orbitra est différente :
https://your-domain/<postback_key>/postback?…. Mettez-la à jour dans les dashboards des réseaux (Postbacks). - Base geo. Sans elle, les filtres par pays ne fonctionnent pas — vérifiez ⚙ → Geo databases.
- Vérification du routage. Le test link de campagne avec
&_dbg=1montre quel stream est sélectionné et pourquoi, sans enregistrer de clic (Campaigns et streams).
Problèmes courants
| Symptôme | Cause et solution |
|---|---|
La commande de dump dit no Keitaro tables found | Mauvaise base dans inventory.env ou installation Keitaro non standard. Vérifiez MARIADB_KEITARO_DATABASE |
no MariaDB client … and no MariaDB container found | Pas de client MariaDB et pas de conteneur MariaDB en cours d'exécution — démarrez Keitaro ou installez le client |
| L'import n'a rien trouvé | Le dump est vide ou provient de la mauvaise base — vérifiez la taille du fichier et la ligne Dumping tables: dans la sortie de la commande |
| Les streams n'ont pas été transférés | L'option « Import streams » n'était pas cochée, ou le dump n'a pas keitaro_streams ni les tables d'association |
| Le domaine répond 404 | Le DNS ne pointe pas encore vers le nouveau serveur, ou le domaine n'a pas de campagne Index assignée |
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 →