> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/import-your-referral-program-data.md). # 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 grâce à un suivi performant, des expériences personnalisables et l’assistance d’experts. 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 ? Migrer votre programme de parrainage n’est pas seulement une tâche technique — c’est l’occasion d’améliorer la façon dont vous engagez et récompensez vos clients. Une migration bien planifiée permet de : * Réduire au minimum les perturbations de votre expérience de parrainage * Préserver les données historiques et assurer la continuité des récompenses ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) * Prendre un nouveau départ avec les systèmes hérités * Relancer votre programme de parrainage avec enthousiasme et clarté ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) La migration des parrainages et des récompenses dépend de votre capacité à exporter les données de votre système actuel. Votre équipe Advocate peut vous indiquer ce qui est possible en fonction des données exportées que vous fournissez. Votre équipe Advocate travaillera avec vous pour examiner vos fichiers d’exportation, déterminer ce qui est réalisable et créer un plan adapté aux besoins et aux objectifs de votre programme. #### Ce que vous devrez faire * Exportez les *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’exportation intégré s’il est fourni. * Téléchargez chacun des 3 rapports de données dans un fichier CSV distinct, par exemple, `user_data.CSV`, `referral_data.CSV`, et `reward_data.CSV`. * Consultez les exemples ci-dessous pour voir à quoi pourraient ressembler le contenu de chaque fichier .csv, ou consultez la référence complète du champ Destination. Cela inclut les e-mails, les codes de parrainage, les liens de partage ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media), et les champs personnalisés. Les affiliés doivent être exclus pour éviter les doubles récompenses. ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) Dépend du format du lien de partage et de l’utilisation d’un sous-domaine personnalisé. Le fichier de 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 leurs codes de parrainage. Les champs suivants sont **obligatoires**: * ID utilisateur * ID de compte Utilisez l’adresse e-mail de l’utilisateur comme *ID utilisateur* et *ID de compte*. Les dates doivent être formatées en [millisecondes depuis l’epoch Unix](https://currentmillis.com/). Téléchargez un [exemple des champs requis](https://res.cloudinary.com/product-enablement/raw/upload/v1750169976/CSVs/Migration_User_Import_examples_-_User_Data.csv) ou utilisez l’exemple ci-dessous dans `.csv` . ```programlisting id,accountId,email,firstName,lastName,dateCreated,locale,countryCode,segments User1@example.com,User1@example.com,User1@example.com,First,Last,1741051242000,en_US,US, User2@example.com,User2@example.com,User2@example.com,First,Last,,,,"vip,newuser" User3@example.com,User3@example.com,User3@example.com,First,Last,,en_CA,, User4@example.com,User4@example.com,User4@example.com,First,Last,,,,newuser ``` Cela inclut les dates de début et de conversion, ainsi que les relations parrain/parrainé. Cela permet de conserver une cartographie des performances historiques du parrainage. Le fichier de données de parrainage fournit un enregistrement du statut de chaque lien de parrainage créé dans votre programme de parrainage. Les champs suivants sont **obligatoires**: * ID utilisateur Advocate * ID de compte Advocate * ID utilisateur parrainé * ID de compte parrainé Utilisez l’adresse e-mail de l’utilisateur comme *ID utilisateur* et *ID de compte*. Les dates doivent être formatées en [millisecondes depuis l’epoch Unix](https://currentmillis.com/). Téléchargez un [exemple des champs requis](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Referral_Data_-_Referral_Data.csv) ou utilisez l’exemple ci-dessous dans `.csv` . ```programlisting parrainUser,parrainAccount,parrainéUser,parrainéAccount,dateReferralStarted,dateConverted,programId User2@example.com,User2@example.com,User12@example.com,User12@example.com,1740824979000,1740824979000,33435 User1@example.com,User1@example.com,User13@example.com,User13@example.com,1741051242000,1741051242000,33435 User1@example.com,User1@example.com,User17@example.com,User17@example.com,,,33435 User1@example.com,User1@example.com,User18@example.com,User18@example.com,,,33435 ``` Cela inclut les montants, les dates d’attribution/de remboursement, les types de récompenses et les statuts. Cela permet de préserver la crédibilité et l’équité pour les utilisateurs. Le fichier de données de récompense fournit un enregistrement de l’historique des récompenses des participants, y compris leur valeur et le montant utilisé générés par votre programme de parrainage. Les champs suivants sont **obligatoires**: * 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 d’échange * Montant échangé Utilisez l’adresse e-mail de l’utilisateur comme *ID utilisateur* et *ID de compte*. Les dates doivent être formatées en [millisecondes depuis l’epoch Unix](https://currentmillis.com/). La valeur de la récompense est la valeur numérique de la récompense dans son plus petit unité de mesure (par exemple, pour une récompense en espèces de 1,00 $, la valeur serait de 100 cents). Si l’unité de récompense est en espèces, elle doit inclure le code de devise au format suivant `/` (Ex. : Cash/USD). {% hint style="warning" %} **Important**: Si les *Date d’échange* et *Montant échangé* champs ne sont pas définis correctement — c’est-à-dire s’ils sont laissés vides ou contiennent des valeurs incorrectes (par exemple, une date future ou un montant échangé inexact) — la récompense pourrait redevenir disponible pour être réclamée par l’utilisateur. {% endhint %} Téléchargez un [exemple des champs requis](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Reward_Data_-_Reward_Data.csv) ou utilisez l’exemple ci-dessous dans `.csv` . ```programlisting User ID,Acccount ID,Referred User ID,Referred Account ID,Reward Name,Reward Unit,Reward Value,Redeemed Amount,Date Created,Date Given,Date Redeemed User1@example.com,User1@example.com,User2@example.com,User2@example.com,Dollars,CASH/USD,1000,1000,1709712158000,1709712158000,1709712158000 User1@example.com,User1@example.com,User3@example.com,User3@example.com,Points,POINT,100,100,1726164909682,1726164909682,1726164909682 User1@example.com,User1@example.com,User4@example.com,User4@example.com,Points,POINT,100,100,1726164887075,1726164887075,1726164887075 User1@example.com,User1@example.com,User5@example.com,User5@example.com,Points,POINT,100,100,1726164875888,1726164875888,1726164875888 User1@example.com,User1@example.com,User6@example.com,User6@example.com,Points,POINT,10,10,1726164828986,1726164828986,1726164828986 User1@example.com,User1@example.com,User7@example.com,User7@example.com,Account Credit,USD,8000,8000,1726164289997,1726164289997,1726164289997 User1@example.com,User1@example.com,,,Gift Card,USD,10000,10000,1726163864871,1726163864871,1726163864871 User1@example.com,User1@example.com,,,Points,POINT,800,800,1726095906392,1726095906392,1726095906392 User1@example.com,User1@example.com,,,Gift Card,USD,30000,30000,1726163769157,1726163769157,1726163769157 User1@example.com,User1@example.com,,,20 Off,%,20,20,1726180309034,1726180309034,1726180309034 ``` {% hint style="warning" %} **Important :** Les 3 fichiers d’exportation doivent contenir les données d’un seul programme uniquement. Si les fichiers contiennent des données provenant de plusieurs programmes, l’importation les consolidera en un seul programme. {% endhint %}
Un exemple de plan de migration Chaque migration est unique, mais les plus réussies suivent une structure similaire qui équilibre préparation, communication et exécution. Voici un plan de migration qui garantit la continuité et une expérience fluide pour votre équipe et vos ambassadeurs. Les délais et les phases peuvent varier selon la configuration de votre programme. **Phase 1 : Planification et préparation (1 à 2 semaines)** C’est votre étape de fondation, qui prépare le terrain pour une transition en douceur. | | | | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Objectifs |

• Aligner les parties prenantes.

• Configuration technique.

• Confirmer le périmètre de la migration.

• Planifier la communication aux utilisateurs.

| | Tâches |

• Sécuriser un échantillon de vos données historiques (utilisateurs, parrainages, récompenses) et le partager avec l’équipe Advocate pour examen et cartographie des champs .

• Exporter l’ensemble des données une fois l’échantillon validé. Les données exportées devront très probablement être modifiées (par exemple, ajustement des en-têtes, des noms de champs ou de la structure du fichier) pour correspondre aux exigences d’importation.

• Définir une date de mise en production et une fenêtre de retour arrière.

• Ajouter les widgets Advocate en mode masqué (environnement de test ou pages non liées).

• Mettre en place les intégrations nécessaires (par exemple, Shopify, HubSpot, Segment).

• Terminer la configuration du programme dans Advocate (par exemple, configuration des récompenses, règles du programme, modèles d’e-mail, segmentation).

• Tester la fonctionnalité du programme de bout en bout — vérifier que les partages, les conversions et les récompenses sont correctement suivis dans un environnement de test avant la mise en production.

• Rédiger les messages pour communiquer la transition aux ambassadeurs.

La migration des parrainages et des récompenses dépend de votre capacité à exporter les données de votre système actuel. Votre équipe Advocate peut vous indiquer ce qui est possible en fonction des données exportées que vous fournissez.

| | Conseils |

• Si vous superposez plusieurs plateformes, assurez-vous qu’une seule attribue des récompenses.

• Identifiez les utilisateurs avancés qui pourraient nécessiter un traitement spécial (VIP, influenceurs).

| **Phase 2 : Basculement et mise en production (1 à 2 jours)** C’est votre moment de transition. Prévoyez une courte pause dans le suivi entre les systèmes et programmez-la si possible pendant les heures de faible trafic. | | | | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Objectifs |

• Passer en toute fluidité de votre plateforme héritée à Advocate.

• S’assurer que les utilisateurs peuvent accéder immédiatement à la nouvelle expérience.

• Éviter toute 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 ligne.

• Importer les données finales des utilisateurs, des parrainages et des récompenses.

• Suivre/signaler manuellement toute conversion entre l’arrêt du système et le lancement.

• Surveiller le tableau de bord Advocate pour l’activité.

• Envoyer la communication de lancement à vos ambassadeurs. Informez les utilisateurs que leurs liens de parrainage ont été mis à jour et, idéalement, incluez directement les nouveaux liens dans l’e-mail pour qu’ils puissent commencer à les partager immédiatement.

| | Conseils |

• Inclure si nécessaire une courte période de suspension des récompenses (par exemple, « Les parrainages effectués le 15 mai seront examinés et ajoutés après le lancement. »).

• Utiliser une communication à destination des ambassadeurs pour créer de l’enthousiasme (par exemple, « Nous avons amélioré votre expérience de parrainage ! »).

| **Phase 3 : Après la migration et nettoyage (1 à 2 jours)** Maintenant que vous êtes en ligne, assurez-vous que votre programme fonctionne comme prévu et traitez les derniers points en suspens. | | | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Objectifs |

• Vérifier l’intégrité des données et le suivi des récompenses.

• Récupérer les conversions manquées.

• Aider et former les utilisateurs.

| | Tâches |

• Valider que les relations parrains/parrainés fonctionnent en mode live.

• Importer les conversions manquées survenues entre le basculement.

• Effectuer un test QA (vous parrainer vous-même, confirmer le suivi et la logique des récompenses).

• Fournir des FAQ ou des documents d’aide internes et externes.

• Surveiller la boîte de réception de support pour les problèmes liés aux anciens utilisateurs.

| | Conseils |

• Si vous mettez fin à un compte de financement de récompenses hérité, accordez aux utilisateurs un délai de grâce pour utiliser leurs récompenses.

• Utiliser des e-mails ou des rappels intégrés à l’application pour encourager les premières activités de parrainage dans le nouveau programme.

|
#### Importez les données de votre programme 1. Dans le menu de navigation de gauche, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Rapports → Importations et exportations**. 2. Dans le coin supérieur droit, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ec3276f07285180fbb2167a40e148d3e43e8681c%2F05aa88f72076df5a744d4620574f19cc187b7154fe1f3bb73ad7a892b7d23002.svg?alt=media) **Importer**. 3. Sélectionnez le *Type d’importation* à partir des options disponibles : | Type d’importation | Description | | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Utilisateurs | Sélectionnez cette option pour téléverser 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écompenses des utilisateurs | Sélectionnez cette option pour mettre à jour et échanger les soldes de récompenses des utilisateurs. | | Événements utilisateur | Sélectionnez cette option pour téléverser des données d’événements utilisateur. | | Supprimer des utilisateurs |

Sélectionnez cette option si vous souhaitez supprimer en masse les utilisateurs existants de votre programme.

Vous pouvez également supprimer la gestion des utilisateurs et choisir de :

• Conserver les comptes vides

• Empêcher que les utilisateurs supprimés soient recréés

| | Historique des récompenses | Sélectionnez cette option pour téléverser un enregistrement de toutes les informations relatives aux récompenses. 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éverser un enregistrement de toutes les relations de parrainage. Vous pouvez également choisir d’importer ces données depuis un autre compte ou une autre plateforme. | 4. Sélectionnez **Choisir un fichier** ou faites glisser et déposez le fichier que vous souhaitez importer. 5. 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 obtenir 3 types d’erreurs de validation : 1. **Message d’erreur intégré :** ils apparaissent dans le tableau d’aperçu de validation et font ressortir les lignes en erreur en rouge : * `INVALID_FIELD` — par exemple, le *Date de création* champ n’était pas formaté en [millisecondes depuis l’epoch Unix](https://currentmillis.com/) . * `MISSING_FIELD` — par exemple, un champ obligatoire tel que *ID utilisateur* ou *ID de compte* est manquant.
2. **Message d’alerte d’erreur :** ils apparaissent à la place du tableau d’aperçu de validation sous forme de messages d’avertissement rouges : * `MISSING_HEADER` — par exemple, un en-tête de colonne obligatoire tel que *ID de compte* ou *Valeur de la récompense* est manquant. * `CSV_PARSING` — par exemple, le fichier CSV contient des caractères spéciaux mal formatés. * `FILE_REF_IO` — par exemple, le fichier est corrompu et ne peut pas être lu.
3. **Erreurs répertoriées :** elles apparaissent sous forme de liste des nombres d’erreurs sur l’écran *Imports et exports* dans la *Rapports* section lorsque le type d’importation ne dispose pas d’un tableau d’aperçu de validation. Les erreurs de ligne et les erreurs de fichier s’afficheront ensemble :
#### Assistance Vous n’avez pas à gérer la migration seul. Notre équipe d’onboarding Advocate est prête à vous aider avec : * Assistance à la cartographie des champs * Conseils sur le formatage des données * Stratégie de migration des récompenses * Tests et QA Contactez votre [équipe d’assistance Advocate](mailto:support-advocate@impact.com). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/import-your-referral-program-data.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.