> 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/manage-advocate-participants/import-advocate-participants-in-bulk.md).
# Importer des participants Advocate en masse
Advocate accepte les imports soumis dans `.csv` ou `.jsonl` les formats de fichier. Veuillez consulter notre [fichier d'import CSV d'exemple](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) et [fichier d'import JSONL d'exemple](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) pour voir la structure de fichier requise pour votre import.
{% hint style="info" %}
**Remarque :** Nous recommandons que chaque import ne dépasse pas 500 000 entrées.
{% endhint %}
#### Importer des participants en masse
1. Dans le menu de navigation de gauche, sélectionnez  **\[Engage] → Participants**.
2. Sélectionnez **Importer des utilisateurs**.
3. Sous *Type d'import*, sélectionnez **Utilisateurs**.
4. Ajoutez votre fichier d'import en sélectionnant **Sélectionner un fichier**.
5. **\[Facultatif]** Pour ajouter ou supprimer les participants importés d'un segment d'utilisateurs spécifique, sélectionnez le segment dans la liste déroulante.
{% hint style="info" %}
**Remarque :** Cette sélection s'applique à *tous* les participants inclus dans ce fichier d'import.
{% endhint %}
6. Sélectionnez **Démarrer l'import**.
Une fois l'import terminé, un e-mail de confirmation est envoyé. Les imports peuvent prendre jusqu'à 30 minutes, selon la file d'attente et la taille du fichier.
#### Champs
Les imports d'utilisateurs en masse prennent en charge à la fois les champs standard et les champs personnalisés dans le fichier téléversé. **La casse des champs est sensible.**
{% tabs %}
{% tab title="Champs standard" %}
Les champs standard sont analysés avec la même validation que notre [appel API User Upsert Open Endpoint](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-open-endpoints):
| Champ | Type | Description |
| ------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| accountId (obligatoire) | chaîne | L'identifiant unique du compte auquel appartient ce participant. |
| id (obligatoire) | chaîne | L'identifiant unique fourni pour ce participant. |
| firstName | chaîne | Le prénom du participant. |
| lastName | chaîne | Le nom du participant. |
| e-mail | chaîne | L'adresse e-mail du participant. |
| referable | booléen | Drapeau utilisé par impact.com pour déterminer si un participant peut être recommandé.
Remarque : Le drapeau doit être orthographié avec un seul un r pour que le statut soit modifié avec succès.
|
| locale | chaîne | La locale du participant, utilisée pour [l'internationalisation](/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). La locale doit être au format `language_COUNTRY` où le code de langue doit être en minuscules et le code pays en majuscules. Le séparateur doit être un underscore. |
| countryCode | chaîne | La locale du participant, utilisée pour [l'internationalisation](/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). Le code pays de l'utilisateur (par ex. CA). |
| referredBy.code | chaîne | Le code de parrainage du défenseur client qui a recommandé ce participant. |
| referralCodes.{programId} | chaîne | Le code de parrainage personnalisé pour que ce participant le partage pour le programme spécifié (généré automatiquement s'il n'est pas inclus). |
| sharelinks.{programId} | chaîne | Le lien de partage personnalisé pour que ce participant le partage pour le programme spécifié (généré automatiquement s'il n'est pas inclus). |
| dateCreated | chaîne | La date à laquelle ce participant a été créé dans votre programme Advocate. |
| imageUrl | chaîne | Utilisé facultativement dans les widgets, les e-mails et les thèmes. Si vous fournissez une URL absolue d'image de profil, la taille minimale de l'image est de 80 px x 80 px. |
| dateUsTaxFormSubmitted | entier | La date à laquelle le formulaire fiscal W-9 d'un participant a été marqué comme collecté. Utilisé pour la conformité W-9 sur votre tenant, si configuré. |
| customFields.{fieldName} | chaîne | Utilisez cette structure pour inclure un champ personnalisé de votre choix. |
| {% endtab %} | | |
{% tab title="Champs personnalisés" %}
[Champs utilisateur personnalisés](/brand/fr/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md) permettent de gérer des données propres à vos participants. Vous pouvez configurer les objectifs de votre programme pour qu'ils se déclenchent en fonction des informations contenues dans un champ utilisateur personnalisé.
{% hint style="info" %}
**Exemple**: Récompensez les participants lorsqu'ils renouvellent leur abonnement. Commencez par inclure le champ personnalisé `customFields.subscriptionPaid` avec la valeur **oui**. Puis, définissez l'objectif de conversion lorsque `customFields.subscriptionPaid` est égal à **oui**.
{% endhint %}
Ajoutez des champs personnalisés à l'en-tête de colonne au format suivant : `customFields.yourCustomFieldName`.
{% hint style="info" %}
**Remarque :** Les champs personnalisés n'acceptent pas de valeurs de tableau ou d'objet.
{% endhint %}
{% endtab %}
{% endtabs %}
**Résultats**
Nous vous avertissons par e-mail lorsque votre import est terminé. Vous pouvez télécharger les résultats de l'import depuis la  **\[Engage] → Rapports → Imports et exports** page de votre programme Advocate.
{% hint style="warning" %}
**Avertissement :** Les liens de téléchargement expireront après 30 jours.
{% endhint %}
{% tabs %}
{% tab title="Téléversement réussi" %}
Si l'import se termine avec succès, un fichier contenant les informations du participant sera généré et vous sera envoyé par e-mail. Les informations incluses dans ces résultats sont les mêmes que celles que l'on trouve dans notre [rapport de détails des utilisateurs](/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).
{% endtab %}
{% tab title="Erreurs" %}
Si des erreurs sont rencontrées pendant l'import, un fichier supplémentaire sera alors généré. Ce fichier d'erreurs inclut une entrée pour chaque erreur survenue, y compris le numéro de ligne de l'enregistrement (provenant du fichier d'import initial) ayant échoué, ainsi que tous les messages d'erreur associés.
| recordNumber | message | apiErrorCode | statusCode |
| ------------ | --------------------------------------------- | ------------ | ---------- |
| 2 | Cette requête nécessite un id valide non vide | BAD\_REQUEST | 400 |
Dans le cas peu probable où une erreur système se produit et que l'import est interrompu, l'import apparaîtra comme **interrompu** et ne pourra pas être récupéré. Veuillez contacter notre équipe d'assistance si vous avez besoin d'aide supplémentaire.
{% endtab %}
{% endtabs %}
---
# 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/manage-advocate-participants/import-advocate-participants-in-bulk.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.