L'outil d'importation de RewardsWP vous permet d'importer des membres et des soldes de points à partir d'un fichier CSV. Que vous migriez depuis un autre plugin de fidélité, que vous intégriez une liste de clients existante ou que vous appliquiez un crédit de points en masse, le flux de travail d'importation en trois étapes s'occupe du travail le plus difficile. Après avoir lu ce guide, vous saurez comment préparer votre CSV, mapper les colonnes, traiter l'importation et résoudre les erreurs.
Avant de commencer
L'outil d'importation est disponible sur tous les plans RewardsWP. Pour y accéder, naviguez vers RewardsWP » Outils dans votre administration WordPress. L'onglet Importation est sélectionné par défaut.
Avant de commencer, assurez-vous d'avoir :
- Un fichier CSV avec vos données de membres et de points. Si vous n'en avez pas encore, vous téléchargerez un modèle à l'étape suivante.
- Au moins un identifiant par ligne pour que RewardsWP sache quel membre créditer. Les identifiants valides sont
member_id,user_id, ouemail. - Une valeur de points par ligne. La colonne
pointsest requise pour chaque importation.
Télécharger le modèle et préparer votre CSV
Cliquez sur le bouton Télécharger un exemple de CSV sur l'onglet Importation pour obtenir un fichier CSV pré-formaté. Le fichier téléchargé est nommé rewardswp-points-import-template-{DATE}.csv (où {DATE} est la date du jour) et inclut les 16 colonnes disponibles en tant qu'en-têtes.
Colonnes disponibles
| Colonne | Requis | Description |
|---|---|---|
member_id | Conditionnel | L'ID du membre RewardsWP. Utilisez-le lors de la mise à jour des membres existants. |
user_id | Conditionnel | L'ID de l'utilisateur WordPress. Lie le membre à un compte WordPress existant, ou crée un nouveau membre si aucune correspondance n'est trouvée. |
email | Conditionnel | L'adresse e-mail du membre. Correspond à un membre existant par e-mail, ou en crée un nouveau. |
first_name | Non | Le prénom du membre. Recommandé pour les nouveaux membres. |
last_name | Non | Le nom de famille du membre. Recommandé pour les nouveaux membres. |
code_parrainage | Non | Un code de parrainage personnalisé pour le membre. |
statut | Non | Le statut du membre (par ex. actif, exclu). |
points | Oui | Le nombre de points à ajouter. Chaque ligne crée une entrée de points distincte. |
type | Non | Le type de transaction de points. |
type_source | Non | D'où proviennent les points (par ex. achat, manuel). |
id_source | Non | Un ID reliant les points à une source spécifique (par ex. un ID de commande). |
statut_points | Non | Le statut de l'entrée de points (par ex. approuvé, en attente). |
créé_le | Non | La date de création de l'entrée de points. Recommandé pour les importations historiques. |
expire_le | Non | Quand les points expirent. |
note_publique | Non | Une note visible par le membre dans son journal d'activité. Recommandé pour plus de clarté. |
note_interne | Non | Une note réservée aux administrateurs. Non visible par les membres. |
Au moins une colonne d'identifiant (id_membre, id_utilisateur, ou email) doit être présente aux côtés de la colonne requise points. Vous pouvez inclure n'importe quelle combinaison des colonnes facultatives.
Préparation de vos données
Ouvrez le modèle dans une application tableur et remplissez vos données. Quelques conseils :
- Une ligne par entrée de points. Si vous devez donner 500 points à un membre en tant que solde unique, utilisez une ligne avec
pointsdéfini sur500. Si vous souhaitez importer son historique complet avec plusieurs transactions, utilisez une ligne par transaction. - Utilisez des identifiants cohérents. Choisissez un type d'identifiant (l'e-mail est généralement le plus simple) et utilisez-le de manière cohérente sur toutes les lignes.
- Format de date. Utilisez
AAAA-MM-JJouAAAA-MM-JJ HH:MM:SSpour les colonnescréé_leetexpire_le. - Enregistrer en CSV. Assurez-vous que votre tableur exporte en tant que fichier
.csvstandard (valeurs séparées par des virgules), et non.xlsxou.xls.
Télécharger et mapper les colonnes
De retour dans l'onglet Importation, téléchargez votre fichier CSV en utilisant le sélecteur de fichiers ou la zone de glisser-déposer. RewardsWP valide le fichier (format CSV requis) et lit les en-têtes de colonne.
Mappage des colonnes
Après le téléchargement, une interface de mappage de colonnes apparaît. RewardsWP détecte automatiquement quelles colonnes CSV correspondent à quels champs d'importation à l'aide des en-têtes de colonne. Chaque mappage affiche un niveau de confiance :
| Confiance | Ce que cela signifie |
|---|---|
| Confiance | L'en-tête de colonne correspond exactement ou presque exactement. Aucune action n'est nécessaire. |
| Modérée | L'en-tête correspond partiellement. Vérifiez le mappage pour confirmer qu'il est correct. |
| Faible | RewardsWP n'a pas pu faire correspondre cette colonne avec certitude. Vous devrez la mapper manuellement à l'aide de la liste déroulante. |
Vérifiez chaque mappage et utilisez les listes déroulantes pour corriger ceux qui ont été mal mappés. Les colonnes non mappées sont ignorées lors de l'importation.
Aperçu de vos données
Après le mappage, une fenêtre d'aperçu affiche un échantillon de vos données avec les mappages appliqués. Vérifiez l'aperçu pour confirmer que les valeurs sont arrivées dans les bonnes colonnes avant de continuer.
Vérifier et traiter l'importation
Une fois que vous êtes satisfait du mappage des colonnes et de l'aperçu, cliquez sur le bouton pour démarrer l'importation. RewardsWP traite le fichier par lots de 50 enregistrements par requête, vous verrez donc un indicateur de progression suivre le décompte pendant qu'il traite votre fichier.
Comment RewardsWP gère chaque ligne
La logique d'importation dépend de l'identifiant que vous avez fourni :
| Identifiant fourni | Ce qui se passe |
|---|---|
member_id | Met à jour le membre existant avec cet ID. Si aucun membre n'est trouvé, la ligne est ignorée et enregistrée comme une erreur. |
user_id | Recherche un membre lié à cet utilisateur WordPress. S'il est trouvé, met à jour ce membre. S'il n'est pas trouvé, crée un nouveau membre lié à l'utilisateur. |
email | Recherche un membre avec cette adresse e-mail. S'il est trouvé, met à jour ce membre. S'il n'est pas trouvé, crée un nouveau membre avec cet e-mail. |
Lorsque plusieurs identifiants sont présents sur une seule ligne, member_id a la priorité, suivi de user_id, puis de email.
Chaque ligne du CSV crée une entrée de points distincte dans l'historique du membre. Si une ligne inclut des champs facultatifs tels que first_name, last_name ou referral_code, ces valeurs sont également appliquées à l'enregistrement du membre.
Après l'importation
Lorsque l'importation se termine, vous verrez un résumé indiquant le nombre total d'enregistrements traités, le nombre de succès et le nombre d'échecs.
Si des lignes ont échoué, cliquez sur Télécharger le rapport d'erreurs pour obtenir un fichier CSV listant chaque ligne échouée avec la raison pour laquelle elle a été ignorée. Les raisons courantes incluent :
- Valeur manquante dans la colonne requise
points - Aucun identifiant valide (
member_id,user_idouemail) dans la ligne member_idne correspond à aucun membre existant- Format de date invalide dans
created_atouexpires_at
Vous pouvez corriger les problèmes dans le CSV du rapport d'erreurs et réimporter uniquement les lignes échouées.
Après une importation réussie, accédez à RewardsWP » Membres pour vérifier que vos membres et soldes de points importés apparaissent correctement.
Questions fréquemment posées
Puis-je importer des membres d'un autre plugin de fidélité ?
Oui. Exportez vos données de l'autre plugin au format CSV, puis reformatez les colonnes pour correspondre au modèle RewardsWP. L'exigence clé est d'avoir au moins un identifiant (l'email est généralement le plus facile à faire correspondre) et une valeur de points pour chaque ligne.
Que se passe-t-il si j'importe une ligne avec un e-mail qui existe déjà ?
RewardsWP fait correspondre la ligne au membre existant avec cette adresse e-mail et ajoute les points comme une nouvelle entrée dans son historique. Il ne créera pas de membre en double.
Y a-t-il une taille de fichier maximale pour l'importation ?
La limite de taille de fichier dépend de la configuration PHP de votre serveur (spécifiquement les paramètres upload_max_filesize et post_max_size). La plupart des environnements d'hébergement autorisent au moins 2 Mo, ce qui est suffisant pour des dizaines de milliers de lignes. Si votre fichier est trop volumineux, essayez de le diviser en plus petits lots.
C'est tout ! L'outil d'importation permet d'intégrer facilement les membres et les soldes de points de n'importe quelle source.