Systeme d’Import/Export

Disponible dans :

• Post Affiliate Pro
• Post Affiliate Pro Ultimate
• Post Affiliate Network

Apercu

Le Systeme d’Import/Export dans Post Affiliate Pro fournit de puissants outils pour les operations de donnees en masse. Que vous migriez depuis une autre plateforme, geriez de grands ensembles de donnees ou synchronisiez des donnees entre systemes, la fonctionnalite d’import/export fait gagner du temps et reduit les erreurs manuelles.

Le systeme supporte l’import et l’export de :

• Affilies - Comptes utilisateurs avec toutes les donnees de profil et options de paiement
• Campagnes - Parametres de campagne, types de commission, groupes et taux
• Bannieres - Definitions de bannieres et materiels promotionnels
• Transactions - Ventes, commissions et enregistrements de transactions
• Themes - Themes de panneau personnalises et modeles

Lancez votre programme d'affiliation aujourd'hui

Configurez le suivi avancé en quelques minutes. Aucune carte de crédit requise.

Demander une démo Démarrer l'essai gratuit de 30 jours

Import/Export d’Affilies

Export d’Affilies

La fonctionnalite d’export d’affilies cree un fichier CSV complet contenant toutes les donnees d’affilies de votre installation. L’export inclut :

Champs d’Affilie de Base :

• ID Utilisateur (identifiant unique)
• ID de Reference (refid)
• Nom d’utilisateur (email)
• Prenom et Nom de famille
• Statut du compte (en attente, approuve, refuse)
• Date d’insertion et Date d’approbation
• ID Utilisateur Parent (pour les structures multi-niveaux)
• Seuil de paiement minimum
• Notes et Photo

Champs de Donnees Personnalises :

• Data1 a Data25 (champs d’affilie personnalises)

Options de Paiement : L’export inclut aussi une section separee pour les options de paiement, contenant :

• ID Utilisateur
• Nom du champ de paiement
• Valeur du champ de paiement

Import d’Affilies

Lors de l’import d’affilies, le systeme traite le fichier CSV et soit cree de nouveaux comptes d’affilies, soit met a jour les existants en fonction de l’ID Utilisateur.

Champs Requis :

• !USERID - L’identifiant unique de l’affilie

Comportements Cles :

• Si un affilie avec l’ID Utilisateur specifie existe, l’enregistrement est mis a jour
• Si l’ID Utilisateur n’existe pas, un nouveau compte d’affilie est cree
• Les champs de statut vides sont definis par defaut sur “Approuve”
• Le systeme gere automatiquement les relations parent-utilisateur pour les structures multi-niveaux
• Les mots de passe peuvent etre importes avec ou sans chiffrement salt

Mapping de Champs : La ligne d’en-tete CSV definit les noms de champs en utilisant le format !NOMDECHAMP. Par exemple :

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS

Exemple de Format CSV

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS,!MINIMUMPAYOUT
abc12345,REF001,jean@exemple.com,Jean,Martin,A,50.00
def67890,REF002,marie@exemple.com,Marie,Dupont,A,100.00

Valeurs de statut :

• A - Approuve
• P - En attente
• D - Refuse

Import/Export de Campagnes

Ce Qui Est Exporte

L’export de campagne cree une sauvegarde complete de votre structure de campagne incluant :

Campagnes :

• ID de Campagne, Nom et Description
• Type et Statut
• Date d’insertion
• Ordre d’affichage
• Duree de vie des cookies et parametres d’ecrasement
• Parametres de geo-ciblage (pays, regles d’affichage)
• Parametres de plage de dates valides
• URL du logo et ID de produit

Types de Commission :

• ID du Type de Commission
• Type (vente, lead, clic, etc.)
• Nom et Code
• Statut et parametres d’approbation
• Parametres de preset de recurrence
• Options de gestion des commissions zero
• Restrictions de pays et de ville

Groupes de Commission :

• ID et Nom du Groupe
• Association a la campagne
• Indicateur de groupe par defaut

Commissions :

• ID de Commission
• Niveau de tier
• Type de commission (pourcentage, fixe)
• Valeur
• Association aux types et groupes de commission

Import de Campagnes

L’import de campagne supporte la creation ou la mise a jour de campagnes avec toutes leurs structures de commission associees.

Champs Requis par Section :

• Campagnes : !CAMPAIGNID
• Types de Commission : !COMMTYPEID
• Groupes de Commission : !COMMISSIONGROUPID
• Commissions : !COMMISSIONID

L’import traite chaque section sequentiellement, assurant des relations appropriees entre les campagnes, les types de commission, les groupes et les taux de commission.

Rejoignez notre newsletter

Soyez le premier à connaître les nouvelles fonctionnalités et mises à jour.

Adresse e-mail

S'abonner

Import/Export de Bannieres

Structure des Donnees de Bannieres

L’import/export de bannieres gere les metadonnees et la configuration de vos materiels promotionnels :

Champs Exportes :

• ID de Banniere
• ID de Compte et ID de Campagne
• Type de Banniere (image, HTML, lien texte, etc.)
• Statut (actif/inactif)
• Nom et Description
• URL de Destination
• Dimensions
• Champs de donnees (Data1-Data4) pour le contenu specifique au type
• Ordre d’affichage
• Chaine SEO
• ID de Wrapper
• Date d’insertion

Note Importante : L’import/export de bannieres gere uniquement les definitions, pas les fichiers d’images physiques ou les assets. Assurez-vous que les images referencees sont disponibles aux URL specifiees apres l’import.

Champ Requis :

• !BANNERID - Identifiant unique de la banniere

Exemple de Format CSV

!BANNERID,!CAMPAIGNID,!TYPE,!NAME,!DESTINATIONURL,!STATUS
ban12345,camp001,I,Banniere Soldes d'Ete,https://exemple.com/soldes,A
ban67890,camp001,T,Lien Texte Promo,https://exemple.com/promo,A

Types de bannieres :

• I - Banniere image
• T - Lien texte
• H - Banniere HTML
• Et autres types supportes

Import de Transactions

Apercu

L’import de transactions est une fonctionnalite puissante pour charger en masse des ventes, commissions et autres enregistrements de transactions. C’est particulierement utile pour :

• Migrer des donnees historiques depuis d’autres plateformes
• Importer des ventes hors ligne
• Traitement par lots des mises a jour de transactions
• Synchronisation avec des systemes externes

Champs Disponibles

L’import de transactions supporte un ensemble complet de champs :

Champs de Transaction de Base :

• ID de Transaction
• ID de Compte
• ID Utilisateur (affilie) - supporte l’ID, le refid ou le nom d’utilisateur
• ID de Banniere et ID de Banniere Parent
• ID de Campagne
• ID de Commande et ID de Produit
• Statut (en attente, approuve, refuse)
• Type (vente, lead, clic, remboursement, retour de paiement)
• Date d’insertion et Date d’approbation
• Montant de commission
• Cout Total et Cout Fixe
• Niveau de tier

Informations de Tracking :

• Code Pays
• Adresse IP
• Navigateur
• URL du Referent
• Methode de Tracking
• Nombre de Clics
• Canal
• ID Visiteur

Donnees Supplementaires :

• Champs de donnees supplementaires (Data1-Data5)
• Note Marchand et Note Systeme
• ID ou Code de Coupon
• Informations de devise (ID, valeur, taux)
• ID de Type de Commission et ID de Groupe
• Frais de Reseau
• ID de Vente et informations de Split

Options d’Import

Correspondance des Transactions : L’import peut faire correspondre les transactions existantes par :

• ID de Commande - Met a jour les transactions avec l’ID de commande correspondant
• ID de Transaction - Met a jour une transaction specifique par ID
• ID de Commande (Tous les Niveaux) - Met a jour toutes les transactions de tier pour une commande

Calcul Automatique des Commissions : Activez le calcul automatique des commissions pour que le systeme calcule les montants de commission en fonction de :

• Parametres de commission de la campagne
• Groupe de commission de l’affilie
• Valeur du cout total
• Regles du type de commission

Generation de Commission Multi-Niveaux : Lorsqu’active, l’import cree automatiquement des commissions de tier basees sur la structure ascendante de l’affilie et les parametres de la campagne.

Gestion des Statuts :

• Definir un statut specifique pour toutes les transactions importees
• Utiliser le statut du fichier (valeur du champ)
• Conserver le statut original lors de la mise a jour des transactions existantes

Presets de Format d’Import

Vous pouvez enregistrer et reutiliser les configurations de format d’import :

• Definir les mappings de colonnes
• Definir les options d’import
• Enregistrer comme presets nommes pour les imports recurrents

Exemple de Format CSV

userid,campaignid,totalcost,orderid,rstatus,dateinserted
aff12345,camp001,99.99,ORD-001,A,2025-01-10 10:30:00
aff67890,camp001,149.99,ORD-002,P,2025-01-10 11:45:00

Gestion des Remboursements et Retours de Paiement

Lors de l’import de remboursements ou retours de paiement :

• Definissez le type de transaction sur remboursement (R) ou retour de paiement (H)
• Fournissez l’ID de transaction parent ou l’ID de commande pour reference
• Les montants de commission sont automatiquement calcules comme valeurs negatives lors de l’utilisation du calcul automatique

Import/Export de Themes

Export de Themes

Exportez vos themes personnalises comme packages complets pour la sauvegarde ou la migration :

Ce Qui Est Exporte :

• Configuration du theme (parametres theme.php)
• Tous les fichiers de modeles (.tpl et .stpl)
• Fichiers CSS personnalises (custom.css, custom_colors.css)
• Assets d’images (JPEG, PNG, GIF, BMP)

L’export cree une archive ZIP contenant la structure complete du theme.

La Configuration du Theme Inclut :

• Nom et description du theme
• Auteur et URL
• Module (panneau marchand/affilie)
• Mode d’affichage (simple/fenetre)
• Parametres de fond d’ecran par defaut
• Image miniature
• Parametres de remplacement CSS
• Reference du theme original

Import de Themes

Importez des themes depuis des packages ZIP pour deployer rapidement des designs personnalises :

Exigences :

• Archive ZIP valide avec configuration theme.php
• Syntaxe de modele correcte (validee pendant l’import)
• Reference de theme original valide
• Image miniature specifiee

Validation : Le processus d’import valide :

• Completude de la configuration du theme
• Syntaxe des modeles Smarty
• Existence du theme original
• Restrictions de type de fichier (uniquement les extensions autorisees)

Types de Fichiers Supportes :

• Modeles : .tpl, .stpl
• Styles : .css (uniquement custom.css, custom_colors.css)
• Images : .jpg, .jpeg, .png, .gif, .bmp

Exigences de Format des Donnees

Structure du Fichier CSV

Exigences Generales :

• Utilisez l’encodage UTF-8 pour une gestion correcte des caracteres
• La premiere ligne doit contenir les en-tetes de colonnes
• Delimiteur coherent dans tout le fichier (virgule, point-virgule ou tabulation)
• Caracteres speciaux correctement echappes

Format des Noms de Champs :

• Les champs requis sont prefixes avec ! (ex. !USERID)
• Les noms de champs sont insensibles a la casse
• Le mapping personnalise permet un ordre flexible des colonnes

Format de Date : Les dates doivent etre dans un format reconnaissable :

• AAAA-MM-JJ HH:MM:SS (recommande)
• Les formats de date standards sont automatiquement analyses

Valeurs Numeriques :

• Utilisez le point (.) comme separateur decimal
• Pas de separateurs de milliers
• Valeurs negatives supportees (ex. pour les remboursements)

Fichiers Multi-Sections

Certains exports (affilies, campagnes) incluent plusieurs sections de donnees :

[[AFFILIATES]]
!USERID,!REFID,!USERNAME
...

[[Payout options]]
!USERID,name,value
...

Chaque section est identifiee par un marqueur d’en-tete et a sa propre structure de colonnes.

Bonnes Pratiques pour les Operations en Masse

Avant l’Import

1. Creez une Sauvegarde Exportez toujours vos donnees actuelles avant d’effectuer des imports en masse, surtout lors de l’utilisation de l’option de suppression.

2. Validez Vos Donnees

   • Verifiez les ID en double
   • Verifiez que les champs requis sont presents
   • Assurez-vous que les formats de date sont coherents
   • Validez les codes de statut et de type

3. Testez avec un Petit Ensemble de Donnees Importez quelques enregistrements d’abord pour verifier le mapping et le comportement avant de traiter de grands fichiers.

4. Verifiez les Dependances

   • Assurez-vous que les campagnes referencees existent avant d’importer des bannieres
   • Verifiez que les comptes d’affilies existent avant d’importer des transactions
   • Confirmez que les types de commission sont configures avant d’importer des commissions

Pendant l’Import

5. Surveillez la Progression L’import s’execute comme une tache en arriere-plan avec suivi de progression. Verifiez les notifications de tache pour les mises a jour de statut et les messages d’erreur.

6. Gerez les Erreurs Gracieusement Le systeme journalise les erreurs pour les enregistrements individuels tout en continuant a traiter les entrees valides. Examinez le journal d’import pour traiter les enregistrements echoues.

Apres l’Import

7. Verifiez les Resultats

   • Verifiez ponctuellement les enregistrements importes
   • Verifiez que les totaux et les comptes correspondent aux attentes
   • Testez les connexions d’affilies si les mots de passe ont ete importes

8. Mettez a Jour les Enregistrements Lies Certains imports peuvent necessiter des actions de suivi :

   • Assigner des affilies aux campagnes
   • Telecharger des images de bannieres
   • Configurer des taux de commission

Considerations de Performance

9. Gestion des Grands Fichiers Le systeme d’import traite les donnees par lots pour eviter les timeouts. Les tres grands fichiers peuvent prendre plusieurs minutes a completer.

10. Planifiez Pendant les Periodes de Faible Activite Pour de meilleures performances, planifiez les grands imports pendant les heures creuses lorsque la charge du systeme est plus faible.

Notes de Securite

11. Donnees Sensibles

    • Les champs de mot de passe sont geres de maniere securisee avec chiffrement salt
    • Evitez d’importer des informations de paiement sensibles via des canaux non securises
    • Examinez les fichiers d’import pour l’exposition de donnees non intentionnelle

12. Controle d’Acces Les fonctions d’import/export necessitent les permissions d’administrateur marchand appropriees.

Cas d’Utilisation Courants

Migration depuis une Autre Plateforme

1. Exportez les donnees depuis votre plateforme existante en format CSV
2. Mappez les colonnes aux noms de champs Post Affiliate Pro
3. Importez d’abord les affilies pour etablir les comptes utilisateurs
4. Importez les campagnes et les structures de commission
5. Importez les transactions historiques
6. Telechargez les bannieres et materiels promotionnels

Synchronisation Mensuelle des Transactions

1. Creez un preset de format d’import pour votre systeme externe
2. Exportez les transactions depuis votre plateforme e-commerce
3. Importez en utilisant la correspondance par ID de Commande pour mettre a jour les transactions existantes
4. Examinez le journal d’import pour toute divergence

Sauvegarde et Deploiement de Themes

1. Personnalisez votre theme dans un environnement de developpement
2. Exportez le theme comme package ZIP
3. Importez dans l’installation de production
4. Verifiez l’apparence et la fonctionnalite du theme

Mises a Jour d’Affilies en Masse

1. Exportez les donnees d’affilies actuelles
2. Modifiez le fichier CSV avec les informations mises a jour
3. Importez avec correspondance par ID Utilisateur
4. Verifiez que les mises a jour ont ete appliquees correctement