MDH GROUP · BLOG

Checklist de migration : Bonnes pratiques pour le passage à Affilentra (tracking, mapping des données, préservation des liens)

Une migration technique depuis des plateformes tierces comporte des risques pour le tracking, les paiements et les liens partenaires. Affilentra, solution d’affiliation self-hosted, centralise rôles, suivi, calcul des commissions et paiements sur une seule plateforme.

← Tous les articles

Checklist de migration : Bonnes pratiques pour le passage à Affilentra (tracking, mapping des données, préservation des liens)

Pourquoi planifier la migration vers Affilentra plutôt qu’improviser

Une migration technique depuis des plateformes tierces comporte des risques pour le tracking, les paiements et les liens partenaires. Affilentra offre, en tant que logiciel d’affiliation self-hosted, des rôles clairs (opérateur du logiciel, commerçant, partenaire), le suivi, le calcul des commissions et les paiements sur une seule plateforme. Pour que la transition se déroule sans heurts, vous avez besoin d’une approche basée sur les données : export des données, mapping des champs, préservation des liens, tests et un basculement sécurisé. Cette checklist guide les commerçants et opérateurs de réseau de manière pragmatique à travers le processus.

1. Audit pré-migration : état des lieux

Réalisez avant l’export un inventaire complet de tous les éléments pertinents. Documentez :

  • Comptes marchands, IDs de produits ou d’offres et conditions associées
  • Partenaires (affiliés) avec IDs, coordonnées, commissions standard
  • Formats de liens de tracking, paramètres utilisés (p. ex. affiliate_id, partner_id, subid, click_id)
  • Événements de conversion, URLs de postback, intégrations S2S et pixels
  • Supports créatifs, pages de destination, domaines vanity ou de shortlink

Cet audit constitue la base pour un mapping propre dans Affilentra et évite les lacunes en matière de suivi et de reporting.

2. Export des données : structure et formats

Exportez depuis la base de données du système ancien ou le backend les données suivantes en fichiers CSV/JSON :

  • Merchants/Offers : Offer-ID, nom, commission par défaut, logique de paiement
  • Partners : Partner-ID, nom, e‑mail, tracking-ID, statut (actif/paused)
  • Campaigns/Creatives : Creative-ID, template de lien, URL de landing, fichiers média
  • Clicks & Conversions (historiques) : Click-ID, horodatage, Partner-ID, Offer-ID, statut de conversion, Order-ID

Veillez à une encodage de caractères propre (UTF-8) et à des séparateurs de champs identiques pour éviter les erreurs d’import.

3. Mapping des données : champs et règles

Définissez les correspondances de champs entre le format source et le schéma Affilentra. Points importants :

  • Partner-ID → Affilentra partner_id (pas de double attribution)
  • Offer-ID → Affilentra merchant_offer_id
  • Paramètres de tracking : notez les anciens noms de paramètres et associez-les au nouveau template (p. ex. affiliate= → aff_id=)
  • Règles de commissions : assurez-vous que les règles par palier, fixes ou CPA sont reproduites exactement
  • Conversions historiques : n’importez que les conversions vérifiées et clôturées ; marquez les incertitudes

Créez un tableau de mapping (CSV) pour la réutilisabilité et comme documentation pour des audits ultérieurs.

4. Préservation des liens de tracking : comment garder les liens partenaires valides

Objectif central : les liens partenaires existants doivent continuer à convertir après la transition, sans que les partenaires aient à modifier leurs liens. Procédure :

  • Analyse de la structure de liens existante : noms d'hôtes, motifs de chemins, paramètres de requête
  • Stratégie de redirection : Mettez en place des redirections 301 des anciennes URL de clic vers les URL de tracking Affilentra. Pour les déploiements auto-hébergés, vous pouvez implémenter les redirections au niveau du serveur web (Nginx/Apache) ou via un service de shortlink.
  • Mapping des paramètres : Assurez-vous que tous les paramètres pertinents (Partner-ID, SubID, Campaign) soient transférés dans le nouveau modèle.
  • Domaines vanity : Si les partenaires utilisent des domaines propres, vous devriez les rediriger ou enregistrer des CNAME/hôtes de tracking dans Affilentra afin de conserver les vanity-links.

Important : Utilisez des redirections permanentes (301) afin de ne pas perturber les caches existants et les moteurs de recherche.

5. Validation des conversions : Tester avant de basculer en production

Réalisez des tests approfondis pour valider le tracking du clic à la conversion et le calcul des commissions :

  • Clics de test : Générez des clics de test avec différents paramètres (différents partenaires, SubIDs, campagnes).
  • Commandes bout en bout : Simulez des commandes et vérifiez si les événements de conversion arrivent correctement dans Affilentra.
  • S2S-Postbacks : Validez les postbacks serveur-à-serveur avec des données signées, si votre boutique prend en charge le S2S.
  • Réconciliation : Confrontez les conversions historiques importées avec les anciennes données ; marquez les différences et clarifiez leur origine.

6. Import dans Affilentra : Rôles, outils et étapes

Affilentra distingue clairement l'opérateur logiciel, le commerçant et les partenaires — profitez de cette séparation lors de l'import :

  • Opérateur logiciel : Installez/configurez l'instance auto-hébergée (PRO ou NETWORK édition) et paramétrez les réglages de base.
  • Import commerçant : Créez des comptes Merchant, importez les offres et les paramètres de commission.
  • Import partenaires : Importez les profils des partenaires avec les IDs de tracking ; informez les partenaires actifs parallèlement des tests à venir.
  • Import des conversions : Chargez les jeux de données de conversions vérifiés uniquement dans la section historique, pas dans le pipeline de paiements en production.

Utilisez les fonctions d'import CSV existantes ou les APIs de la plateforme pour des étapes d'import automatisées et reproductibles.

7. Plan de bascule et checklist

Planifiez une période de bascule claire et suivez cette checklist :

  • Définir une fenêtre de maintenance (trafic le plus faible)
  • Effectuer la dernière synchronisation des anciennes données
  • Activer les redirections (301) et les vérifier par échantillonnage
  • Suivi en direct : vérifier les URL, déclencher des conversions de test
  • Informer les partenaires : modèle de communication avec statut et contact support
  • Mettre en place le monitoring pour les premières 72 heures (logs, taux d'erreur, taux de conversion)
  • Définir des déclencheurs de rollback (par ex. écart significatif du volume de conversions sur une période définie)

8. Post-basculement : surveillance et rapprochement

Directement après le basculement, les activités les plus importantes sont :

  • Contrôle continu des logs de clics et de conversions
  • Rapprochement avec les données Shop/CRM pour détecter rapidement les pertes de chiffre d'affaires
  • Vérifier le calcul des commissions : les données de référence et les règles sont-elles correctement appliquées ?
  • Prioriser et documenter la file de support pour les demandes des partenaires

Réalisez au bout d'une semaine un rapport de réconciliation détaillé et traitez les différences restantes selon un processus défini.

9. Communication avec les partenaires

Une communication claire et concise réduit la charge du support et l'incertitude :

  • Annoncer à l'avance la date et les changements attendus (si les liens partenaires doivent être ajustés)
  • Fournir des instructions techniques aux partenaires si leurs vanity-links doivent être reconfigurés
  • FAQ et un canal de support dédié pour les premiers jours après le basculement

10. Sécurisation : rollback et enseignements

Un plan de rollback éprouvé est obligatoire. Définissez :

  • Les critères déclenchant un rollback (par ex. >X% de baisse des commandes converties pendant Y heures)
  • Comment rétablir rapidement les redirections et le DNS
  • Qui prend la décision et qui exécute quelles étapes

Documentez, après la migration, les leçons apprises et adaptez les processus opérationnels pour éviter la répétition des mêmes problèmes.

Conclusion

Une migration réussie vers Affilentra nécessite une préparation structurée : mapping des données propre, conservation des liens de tracking via des redirections, tests approfondis et un basculement sécurisé avec surveillance. L'architecture self-hosted et la séparation des rôles chez Affilentra vous donnent le contrôle sur les produits, les conditions et l'historique des paiements — sans partage de revenus dans les modèles de licence.

Agissez maintenant : Choisissez votre point d'entrée et planifiez votre migration avec des étapes claires d'export, de mapping et de test. Choisir un point d'entrée : https://affilentra.de

Prochaine étape

Essayer Affilentra vous-même

Plateforme unifiée qui réunit de manière transparente la mise à disposition des produits, le suivi, la validation des conversions, le calcul des commissions et le paiement selon des rôles clairement séparés ; option d'installation self‑hosted avec licence perpétuelle sans participation au chiffre d'affaires ; les commerçants conservent le contrôle sur les produits, les conditions et les supports publicitaires ; les partenaires reçoivent des liens de suivi personnalisés et un historique des paiements consultable.

Commencer