Docs

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é

KeitaroOrbitraCe qui est préservé
Réseaux d'affiliationRéseaux d'affiliationPostback URL, paramètres d'offre
OffresOffresURL, payout, geo
DomainesDomainesParking, HTTPS-only
GroupesGroupes de campagnesNom
CampagnesCampagnesAlias, token Click API, état, source
StreamsStreamsType, 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 campagneS2S PostbacksURL, méthode, statuts
Landing pagesLanding pagesNoms et URLs
SourcesSourcesParamè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) :

  1. Choisissez un fichier .sql.gz ou .sql. Le dump n'est pas exécuté comme du SQL — il est seulement analysé.
  2. 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.
  3. Show preview — un essai à blanc sans écriture : combien d'objets de chaque type seront importés et quels filtres ne passent pas.
  4. 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

Problèmes courants

SymptômeCause et solution
La commande de dump dit no Keitaro tables foundMauvaise base dans inventory.env ou installation Keitaro non standard. Vérifiez MARIADB_KEITARO_DATABASE
no MariaDB client … and no MariaDB container foundPas 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ésL'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 404Le DNS ne pointe pas encore vers le nouveau serveur, ou le domaine n'a pas de campagne Index assignée
← Précédent
Installation et mises à jour
Suivant →
Migrer depuis Binom
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 →