> 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 en `.csv` ou `.jsonl` formats de fichier. Veuillez consulter notre [exemple de fichier d’import CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) et [exemple de fichier d’import JSONL](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 **Lancer l’import**.
Lorsque l’import est 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 de téléversement. **Les champs respectent la casse.**
{% tabs %}
{% tab title="Champs standard" %}
Les champs standard sont analysés avec la même validation que notre [appel API User Upsert de l’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 attribué à ce participant. |
| firstName | chaîne | Le prénom du participant. |
| lastName | chaîne | Le nom de famille du participant. |
| e-mail | chaîne | L’adresse e-mail du participant. |
| parrainable | booléen | Indicateur utilisé par impact.com pour déterminer si un participant peut être parrainé.
Remarque : L’indicateur doit s’écrire avec seulement 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 (p. ex. CA). |
| referredBy.code | chaîne | Le code de parrainage de l’ambassadeur client qui a parrainé ce participant. |
| referralCodes.{programId} | chaîne | Le code de parrainage personnalisé que ce participant peut partager pour le programme spécifié (généré automatiquement s’il n’est pas inclus). |
| sharelinks.{programId} | chaîne | Le lien de partage personnalisé que ce participant peut partager 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é en option 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 × 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 d’inclure 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**. Ensuite, définissez l’objectif pour convertir lorsque `customFields.subscriptionPaid` est égal à **oui**.
{% endhint %}
Ajoutez des champs personnalisés à l’en-tête de colonne dans ce format : `customFields.yourCustomFieldName`.
{% hint style="info" %}
**Remarque :** Les champs personnalisés n’acceptent pas les valeurs de tableau ni 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 exportations** 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 figurant dans notre [rapport de détails de l’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 une entrée pour chaque erreur survenue, y compris le numéro de ligne de l’enregistrement (provenant du fichier d’import initial) qui a échoué, ainsi que tous les messages d’erreur associés.
| recordNumber | message | apiErrorCode | statusCode |
| ------------ | ------------------------------------------------ | ------------ | ---------- |
| 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 où l’import serait interrompu, l’import apparaîtra comme **interrompu** et ne pourra pas être repris. 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` 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=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.