Importer les données de votre programme de parrainage
Lorsque vous passez d’une autre plateforme de parrainage à Advocate, vous n’importez pas seulement des données — vous améliorez le potentiel de votre programme avec un suivi puissant, des expériences personnalisables et un support expert. Cet article vous guide à travers :
Pourquoi la migration est importante
À quoi ressemble un plan de migration stratégique
Quelles données peuvent être importées
Comment préparer vos fichiers
Erreurs de validation courantes et comment les éviter
Pourquoi planifier une migration stratégique ?
La migration de votre programme de parrainage n’est pas seulement une tâche technique — c’est une occasion d’améliorer la façon dont vous engagez et récompensez vos clients. Une migration bien planifiée aide à :
Minimiser les perturbations de votre expérience de parrainage
Préserver les données historiques et assurer la continuité des récompenses
Permettre une rupture propre avec les systèmes hérités
Réintroduire votre programme de parrainage avec enthousiasme et clarté
La migration des parrainages et des récompenses dépend de votre capacité à exporter les données depuis votre système actuel. Votre équipe Advocate peut vous indiquer ce qui est possible en fonction des données d’export que vous fournissez.
Votre équipe Advocate travaillera avec vous pour examiner vos fichiers d’export, identifier ce qui est faisable et créer un plan qui correspond aux besoins et aux objectifs de votre programme.
Ce que vous devrez faire
Exportez le données utilisateur, données de parrainage, et données de récompense. Contactez soit votre CSM sur votre ancienne plateforme de parrainage pour obtenir de l’aide, soit utilisez un outil d’export intégré à la plateforme si l’un est fourni.
Téléchargez chacun des 3 rapports de données dans un fichier CSV séparé, par ex.,
user_data.CSV,referral_data.CSV, etreward_data.CSV.Voir les exemples ci-dessous pour ce à quoi le contenu de chaque fichier .csv pourrait ressembler, ou consultez la référence complète du champ Destination.
Cela inclut les e-mails, les codes de parrainage, les liens de partage , et les champs personnalisés. Les affiliés doivent être filtrés pour éviter les récompenses en double.
Dépend du format du lien de partage et de l’utilisation d’un sous-domaine personnalisé.
Le fichier Données utilisateur contiendra des informations détaillées sur chaque participant de votre programme. Exportez une liste de tous les participants pour maintenir votre programme à jour avec leurs liens de partage et codes de parrainage.
Les champs suivants sont requis:
ID utilisateur
ID de compte
Utilisez l’e-mail de l’utilisateur comme ID utilisateur et ID de compte. Les dates doivent être formatées en millisecondes depuis l’époque unix. Téléchargez un exemple des champs requis ou utilisez l’exemple ci‑dessous au .csv format.
Ceci inclut les dates de début et de conversion, ainsi que les relations parrain/parrainé. Il permet de cartographier les performances historiques des parrainages.
Le fichier de données de parrainage fournit un enregistrement du statut de chaque connexion de parrainage effectuée dans votre programme de parrainage.
Les champs suivants sont requis:
ID utilisateur Advocate
ID de compte Advocate
ID utilisateur parrainé
ID de compte parrainé
Utilisez l’e-mail de l’utilisateur comme ID utilisateur et ID de compte. Les dates doivent être formatées en millisecondes depuis l’époque unix. Téléchargez un exemple des champs requis ou utilisez l’exemple ci‑dessous au .csv format.
Ceci inclut les valeurs, les dates d’attribution/rédemption, les types de récompense et les statuts. Il permet de préserver la crédibilité et l’équité envers les utilisateurs.
Le fichier Données de récompense fournit un enregistrement de l’historique des récompenses des participants, y compris leur valeur et le montant racheté généré par votre programme de parrainage.
Les champs suivants sont requis:
ID utilisateur Advocate
ID de compte Advocate
Nom de la récompense
Unité de récompense
Valeur de la récompense
Date de création
Date d’attribution
Date de rachat
Montant racheté
Utilisez l’e-mail de l’utilisateur comme ID utilisateur et ID de compte. Les dates doivent être formatées en millisecondes depuis l’époque unix.
La valeur de la récompense est la valeur numérique de la récompense dans son unité de mesure la plus petite (par ex., pour une récompense en espèces de 1,00 $, la valeur serait 100 cents). Si l’unité de récompense est en espèces, elle doit inclure le code monétaire dans le format suivant <unitName>/<Currency> (Par ex., Cash/USD).
Important: Si les Date de rachat et Montant racheté champs ne sont pas définis de manière appropriée — c’est‑à‑dire qu’ils sont soit laissés vides soit contiennent des valeurs incorrectes (par ex., une date future ou un montant racheté inexact) — la récompense peut redevenir disponible pour que l’utilisateur la rachète.
Téléchargez un exemple des champs requis ou utilisez l’exemple ci‑dessous au .csv format.
Important : Les 3 fichiers d’export doivent contenir des données d’un seul et même programme. Si les fichiers contiennent des données de plusieurs programmes, l’import les consolidera en un seul programme.
Un plan de migration exemple
Chaque migration est unique, mais les migrations réussies suivent une structure similaire qui équilibre préparation, communication et exécution. Ci‑dessous un plan de migration qui assure la continuité et une expérience fluide pour votre équipe et vos advocates. Les délais et phases peuvent varier en fonction de la configuration de votre programme.
Phase 1 : Planification et préparation (1–2 semaines)
C’est votre étape de pose des fondations, qui prépare le terrain pour une transition en douceur.
Objectifs
• Aligner les parties prenantes.
• Configuration technique.
• Confirmer la portée de la migration.
• Planifier la communication aux utilisateurs.
Tâches
• Sécuriser un jeu d’exemples de vos données historiques (utilisateurs, parrainages, récompenses) et les partager avec l’équipe Advocate pour examen et mappage des champs .
• Exporter les ensembles de données complets une fois que l’exemple a été validé. Les données d’export devront très probablement être manipulées (par ex., ajustement des en‑têtes, noms de champs ou structure de fichier) pour correspondre aux exigences d’import.
• Définir une date de mise en service et une fenêtre de retour en arrière.
• Ajouter les widgets Advocate en mode caché (environnement de test ou pages non liées).
• Configurer les intégrations nécessaires (par ex., Shopify, HubSpot, Segment).
• Compléter la configuration du programme dans Advocate (par ex., configuration des récompenses, règles du programme, modèles d’e‑mail, segmentation).
• Tester la fonctionnalité du programme de bout en bout — confirmer que les partages, conversions et récompenses sont correctement suivis dans un environnement de test avant la mise en service.
• Rédiger les messages pour communiquer la transition aux advocates.
La migration des parrainages et des récompenses dépend de votre capacité à exporter les données depuis votre système actuel. Votre équipe Advocate peut vous indiquer ce qui est possible en fonction des données d’export que vous fournissez.
Conseils
• Si vous superposez des plateformes, assurez‑vous qu’une seule émet des récompenses.
• Identifier les utilisateurs influents qui peuvent nécessiter un traitement spécial (VIP, influenceurs).
Phase 2 : Basculement et mise en service (1–2 jours)
C’est votre moment de transition. Prévoyez une brève pause dans le suivi entre les systèmes et planifiez pendant les heures de faible trafic si possible.
Objectifs
• Passer sans heurt de votre plateforme héritée à Advocate.
• Veiller à ce que les utilisateurs puissent accéder immédiatement à la nouvelle expérience.
• Éviter la perte de données de parrainage ou de récompenses.
Tâches
• Supprimer les scripts/widgets de l’ancienne plateforme de votre site.
• Mettre les widgets Advocate en production.
• Importer les données utilisateur, de parrainage et de récompense finales.
• Suivre/identifier manuellement toutes les conversions entre l’arrêt du système et le lancement.
• Surveiller le tableau de bord Advocate pour l’activité.
• Envoyer une communication de lancement à vos advocates. Informez les utilisateurs que leurs liens de parrainage ont été mis à jour et incluez idéalement les nouveaux liens directement dans l’e‑mail pour leur faciliter le partage immédiat.
Conseils
• Inclure une courte période de gel des récompenses si nécessaire (par ex., « Les parrainages effectués le 15 mai seront examinés et ajoutés après le lancement. »).
• Utiliser la communication destinée aux advocates pour créer de l’enthousiasme (par ex., « Nous avons amélioré votre expérience de parrainage ! »).
Phase 3 : Post‑migration et nettoyage (1–2 jours)
Maintenant que vous êtes en production, assurez‑vous que votre programme fonctionne comme prévu et réglez les derniers détails.
Objectifs
• Vérifier l’intégrité des données et le suivi des récompenses.
• Capturer les conversions manquées.
• Assurer le support et former les utilisateurs.
Tâches
• Valider que les relations parrain/parrainé fonctionnent en mode production.
• Importer toute conversion manquée survenue entre le basculement.
• Effectuer un test QA (parrainez vous-même, confirmez le suivi et la logique des récompenses).
• Fournir des FAQ internes et externes ou des documents d’aide.
• Surveiller la boîte de support pour les problèmes liés aux utilisateurs hérités.
Conseils
• Si vous mettez hors service un compte de financement de récompenses hérité, accordez aux utilisateurs une période de grâce pour racheter.
• Utiliser des e‑mails ou des rappels in‑app pour stimuler l’activité de parrainage initiale dans le nouveau programme.
Importer les données de votre programme
Dans le menu de navigation de gauche, sélectionnez
[Engage] → Reporting → Imports & Exports.Dans le coin supérieur droit, sélectionnez
Importer.Sélectionnez le Type d'importation à partir des options disponibles :
Type d'importationDescriptionUtilisateurs
Sélectionnez cette option pour télécharger de nouveaux utilisateurs ou des données d’utilisateurs existants. Vous pouvez également choisir d’importer ces données depuis un autre compte ou une autre plateforme.
Mettre à jour les soldes de récompense des utilisateurs
Sélectionnez cette option pour mettre à jour et racheter les soldes de récompense des utilisateurs.
Événements utilisateur
Sélectionnez cette option pour télécharger des données d’événements utilisateur.
Supprimer des utilisateurs
Sélectionnez cette option si vous souhaitez supprimer en masse des utilisateurs existants de votre programme.
Vous pouvez également gérer la suppression des utilisateurs et choisir de :
• Préserver les comptes vides
• Empêcher que les utilisateurs supprimés soient recréés
Historique des récompenses
Sélectionnez cette option pour télécharger un enregistrement de toutes les informations de récompense. Vous pouvez également choisir d’importer ces données depuis un autre compte ou une autre plateforme.
Historique des parrainages
Sélectionnez cette option pour télécharger un enregistrement de toutes les connexions de parrainage. Vous pouvez également choisir d’importer ces données depuis un autre compte ou une autre plateforme.
Sélectionnez Choisir le fichier ou glissez‑déposez le fichier que vous souhaitez importer.
Sélectionnez Importer pour téléverser vos données.
Si vous supprimez en masse des utilisateurs existants, sélectionnez Suppression en masse.
Référence des erreurs de validation
Vous pouvez rencontrer 3 types d’erreurs de validation :
Message d’erreur en ligne : ils apparaissent dans le tableau de validation d’aperçu et provoquent la mise en évidence des lignes en erreur en rouge :
CHAMP_INVALIDE— par ex., le Date de création champ n’était pas formaté en millisecondes depuis l’époque unix .CHAMP_MANQUANT— par ex., un champ requis tel que ID utilisateur ou ID de compte est manquant.
Alerte d’erreur : elles apparaissent à la place du tableau de validation d’aperçu sous forme de messages d’avertissement rouges :
EN_TÊTE_MANQUANTE— par ex., un en‑tête de colonne requis tel que ID de compte ou Valeur de la récompense est manquant.ERREUR_ANALYSE_CSV— par ex., le fichier CSV contient des caractères spéciaux mal formatés.REF_FICHIER_IO— par ex., le fichier est corrompu et ne peut pas être lu.
Erreurs listées : elles apparaissent comme une liste de comptes d’erreurs sur l’écran Importations & Exportations au sein de la section Rapports lorsque le type d’import n’a pas de tableau de validation d’aperçu. Les erreurs de ligne et les erreurs de fichier s’afficheront ensemble :
Support
Vous n’avez pas à gérer la migration seul. Notre équipe d’onboarding Advocate est prête à aider avec :
Assistance pour le mappage des champs
Conseils sur le formatage des données
Stratégie de migration des récompenses
Tests et QA
Contactez votre équipe de support Advocate.
Mis à jour
Ce contenu vous a-t-il été utile ?