# Importer des participants Advocate en masse
Advocate accepte les imports soumis au format `.csv` ou `.jsonl` . 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 groupés d’utilisateurs prennent en charge à la fois les champs standard et les champs personnalisés dans le fichier téléversé. **Les champs sont sensibles à la casse.**
{% tabs %}
{% tab title="Champs standard" %}
Les champs standard sont analysés avec la même validation que notre [appel API Open Endpoint User Upsert](https://integrations.impact.com/impact-brand/docs/api-open-endpoints):
| Champ | Type | Description |
| ------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId (obligatoire) | chaîne de caractères | L’identifiant unique du compte auquel appartient ce participant. |
| id (obligatoire) | chaîne de caractères | L’identifiant unique fourni pour ce participant. |
| firstName | chaîne de caractères | Le prénom du participant. |
| lastName | chaîne de caractères | Le nom du participant. |
| email | chaîne de caractères | L’adresse e-mail du participant. |
| referable | booléen | Indicateur utilisé par impact.com pour déterminer si un participant peut être recommandé.
Remarque : L’indicateur doit être orthographié avec seulement un r pour que le statut soit modifié avec succès.
|
| locale | chaîne de caractères | La langue et la région 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 valeur locale doit être au format `langue_PAYS` où le code de langue doit être en minuscules et le code pays en majuscules. Le séparateur doit être un tiret bas. |
| countryCode | chaîne de caractères | La langue et la région 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 de caractères | Le code de parrainage du client advocate qui a recommandé ce participant. |
| referralCodes.{programId} | chaîne de caractères | Le code de parrainage personnalisé de ce participant à partager pour le programme spécifié (généré automatiquement s’il n’est pas inclus). |
| sharelinks.{programId} | chaîne de caractères | Le lien de partage personnalisé de ce participant à partager pour le programme spécifié (généré automatiquement s’il n’est pas inclus). |
| dateCreated | chaîne de caractères | La date à laquelle ce participant a été créé dans votre programme Advocate. |
| imageUrl | chaîne de caractères | Utilisé éventuellement dans les widgets, e-mails et 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 de caractères | Utilisez cette structure pour inclure un champ personnalisé de votre choix. |
| {% endtab %} | | |
{% tab title="Champs personnalisés" %}
[Les 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 définir vos objectifs de programme pour déclencher des actions 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 **yes**. Ensuite, définissez l’objectif de conversion lorsque `customFields.subscriptionPaid` est égal à **yes**.
{% endhint %}
Ajoutez des champs personnalisés à l’en-tête de colonne dans ce format : `customFields.votreNomDeChampPersonnalisé`.
{% hint style="info" %}
**Remarque :** Les champs personnalisés n’acceptent pas les valeurs de tableau ou d’objet.
{% endhint %}
{% endtab %}
{% endtabs %}
**Résultats**
Nous vous informons par e-mail lorsque votre import est terminé. Vous pouvez télécharger les résultats de l’import depuis la page  **\[Engage] → Rapports → Importations et exports** dans 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 des participants sera généré et vous sera envoyé par e-mail. Les informations incluses dans ces résultats sont les mêmes que celles figurant dans notre [rapport de détails utilisateur](/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 généré. Ce fichier d’erreurs inclut des entrées pour chaque erreur survenue, y compris le numéro de ligne de l’enregistrement (à partir du fichier d’import initial) qui a échoué, ainsi que tous les messages d’erreur associés.
| numéroEnregistrement | message | codeErreurApi | codeStatut |
| -------------------- | ------------------------------------------------ | ------------- | ---------- |
| 2 | Cette requête nécessite un id valide et non vide | BAD\_REQUEST | 400 |
Dans le cas peu probable où une erreur système se produirait et interromprait l’import, celui-ci apparaîtra comme **abandonné** 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: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
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=
```
The question should be specific, self-contained, and written in natural language.
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.