Introduction
Le passage d'une plateforme d'affiliation SaaS à une solution auto‑hébergée comme Affilentra (PRO/NETWORK) apporte contrôle et flexibilité : les commerçants conservent la maîtrise des produits et des conditions, les partenaires reçoivent des liens de suivi transparents et des historiques de paiements, et il n'y a pas de partage du chiffre d'affaires. Cet article propose une checklist de migration pragmatique et basée sur les rôles pour les commerçants et les opérateurs de réseau qui souhaitent reprendre en toute sécurité les données produits, les liens de suivi, les paramètres de cookies, les webhooks, les lots de paiements et les comptes partenaires.
Vue d'ensemble : phases de la migration
- Phase 0 – Préparation & inventaire : identifier les sources de données, définir les parties prenantes et les fenêtres de downtime.
- Phase 1 – Export & mapping : exporter les données depuis la plateforme SaaS et les mapper vers le schéma Affilentra.
- Phase 2 – Staging & tests : importer dans un système de staging, tests end‑to‑end (tracking, conversions, webhooks).
- Phase 3 – Production & cutover : migrer les données de production, basculer les DNS/endpoints, downtime minimal.
- Phase 4 – Post‑migration & monitoring : réconciliations, surveillance en direct, support pour les partenaires et options de rollback.
Phase 0 – Préparation & inventaire
Créez une liste d'inventaire complète de tous les objets pertinents dans votre plateforme SaaS :
- Produits/SKUs incluant prix, variantes et disponibilités
- Comptes partenaires (IDs affiliés, préférences de tracking, comptes de paiement)
- Liens de suivi et formats de liens (paramètres, URL courtes)
- Paramètres de cookies : durée, règle de domaine, attribution first/last click
- Configurations de webhooks et intégrations externes (ERP, facturation, CRM)
- Lots de paiements ouverts et paiements historiques
Définissez également les responsabilités : qui exporte, qui transforme, qui teste, qui décide du go‑live.
Phase 1 – Export & mapping
Exportez des données structurées (CSV/JSON/SQL). Élaborez un document de mapping qui associe les champs source aux champs Affilentra. Exemples de champs de mapping :
- Produit : source_product_id → product_id
- SKU : sku → sku
- Titre/Description : title, description → name, description
- Prix : price → price_net / price_gross (selon le besoin)
- Modèle de commission : commission_type (fixed/percent) → commission_model + rate
- Partenaire : source_aff_id → affiliate_id
- Lien de tracking : deeplink_template → tracking_template
- Cookie : cookie_lifetime, cookie_domain → cookie_duration, cookie_scope
Vérifiez les particularités : plusieurs taux de commission par produit, prix spécifiques par pays, gestion des coupons ou des SubID. Recensez les validations de champs d'Affilentra (par ex. champs obligatoires, caractères autorisés).
Phase 2 – Staging & tests
Configurez un environnement de staging sur votre installation Affilentra self-hosted. Objectifs : valider la structure des données, tester toutes les intégrations et réaliser des scénarios de bout en bout sans impact sur les partenaires en production.
Importation et validation des données
- Importez d’abord un sous-ensemble représentatif (10–20 %), incluant des produits, 50–100 comptes partenaires et quelques lots de paiements.
- Validez l’intégrité des données : recherchez les champs obligatoires manquants, les prix mal formatés ou les identifiants invalides.
Tests de tracking et de conversion
- Générez des liens de tracking de test dans Affilentra, munis de Test-SubIDs.
- Effectuez des commandes de test (boutique de staging ou transactions de test) et vérifiez que les conversions sont correctement trackées et vérifiées.
- Simulez le comportement des cookies : expiration, scénarios cross-domain et attribution First-/Last-Click.
Tests de webhooks et d’intégrations
- Configurez des endpoints de webhook et utilisez des payloads signés ou des secrets pour l’authentification.
- Envoyez des payloads de test et vérifiez la réception, le parsing et les processus de traitement (p. ex. ERP/billing).
- Pour les dépendances externes : déployez un proxy de logging temporaire pour inspecter les requêtes et réponses.
Phase 3 – Production et basculement
Planifiez une fenêtre de basculement restreinte avec une charge utilisateur minimale. Ordre typique :
- Dernière synchronisation des données depuis le SaaS (export delta depuis le dernier snapshot).
- Importations de données dans Affilentra en production.
- Vérification finale des KPI importants : montant des paiements ouverts, nombre de partenaires actifs, tracking en production.
- Basculer les DNS/endpoints pour les URLs de tracking et de webhook. Alternative : réduire au préalable les TTL.
Minimiser les interruptions : utilisez un traitement en parallèle (le SaaS reste opérationnel jusqu’au basculement), réduisez à l’avance les TTL des domaines/VHosts concernés et planifiez le cutover à des heures de faible taux de conversion.
Lots de paiements et comptes partenaires
Processus pour les paiements :
- Exportez les lots de paiements ouverts avec les détails de paiement et les statuts.
- Mappez les comptes de paiement (p. ex. identifiants bancaires/PayPal) sur les profils partenaires dans Affilentra.
- Importez les lots de paiements en tant que « lots importés » et effectuez une réconciliation entre l’export SaaS et l’import Affilentra.
- Vérifiez l’historique des paiements : les partenaires doivent pouvoir consulter sans rupture les paiements historiques après la migration.
Comptes et accès :
- Créez ou importez les comptes partenaires incluant le hash de connexion et l’adresse e-mail de communication.
- Communiquez rapidement les informations d’accès et les modifications des liens de tracking aux partenaires avec un chemin de support clair.
Stratégie de retour arrière
Préparez un plan de rollback clair :
- Snapshot/Sauvegarde : Effectuez des snapshots complets de la base de données et du système de fichiers avant de lancer les imports en production.
- Exploitation SaaS en parallèle : Maintenez la plateforme SaaS active comme sauvegarde pendant au moins une fenêtre temporelle convenue (par ex. 48–72 heures).
- Étapes de rollback : (1) réinitialiser DNS/endpoints, (2) désactiver les modifications Affilentra, (3) vérifier la synchronisation de suivi.
- Communication : Informez immédiatement les partenaires et les parties prenantes internes du retour en arrière et prévoyez une interruption de service limitée.
Validation, monitoring et travaux postérieurs
Après un cutover réussi :
- Réalisez une validation officielle avec checklist (suivi des conversions, webhooks, réconciliation des paiements, accès partenaires).
- Mettez en place du monitoring : logs d'erreurs, webhooks échoués, anomalies de tracking et latence du calcul des commissions.
- Planifiez une fenêtre de support pour les questions des partenaires et les ajustements correctifs de données.
Exemples pratiques et pièges typiques
Problèmes fréquents et prévention :
- Tables de mapping incomplètes : des imports d'échantillons en préproduction évitent les surprises.
- Paramètres de tracking perdus lors des redirections : vérifiez la logique de redirection et conservez les SubIDs.
- Conflits de domaine de cookie sur les sous-domaines : définissez consciemment cookie_scope et testez les cas cross-domain.
- Erreurs d'authentification des webhooks : signez les payloads et testez avec des scénarios de replay.
Conclusion et recommandations opérationnelles
Une migration structurée vers Affilentra en self-hosted réduit les risques opérationnels et renforce le contrôle sur les produits, les commissions et les paiements. Travaillez en phases clairement définies, utilisez des environnements de staging, effectuez des tests end-to-end complets et planifiez un cutover réversible. Affilentra offre la possibilité de regrouper de manière transparente le tracking, la validation des conversions, le calcul des commissions et les paiements selon des rôles séparés — idéal pour les commerçants qui souhaitent rester indépendants et évolutifs.
Prochaine étape : Choisissez votre point d'entrée et examinez les éditions adaptées (PRO / NETWORK) pour vos besoins : Choisir un point d'entrée
Prochaine étape
Essayer Affilentra soi-même
Plateforme unifiée qui regroupe de manière transparente la mise à disposition des produits, le tracking, la validation des conversions, le calcul des commissions et les paiements selon des rôles clairement séparés ; option d'installation en self-hosted avec licence perpétuelle sans participation au chiffre d'affaires ; les commerçants gardent le contrôle sur les produits, les conditions et les supports publicitaires ; les partenaires reçoivent des liens de tracking personnels et un historique de paiements consultable.