# Importer en masse des participants Advocate
Advocate accepte les importations soumises au format `.csv` ou `.jsonl` Veuillez vous référer à notre [fichier d'exemple CSV pour l'import](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) et [fichier d'exemple JSONL pour l'import](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) pour voir la structure de fichier requise pour votre importation.
{% hint style="info" %}
**Remarque :** Nous recommandons que chaque importation n'excède pas 500 000 entrées.
{% endhint %}
#### Importer des participants en masse
1. Dans le menu de navigation gauche, sélectionnez  **\[Engage] → Participants**.
2. Sélectionnez **Importer des utilisateurs**.
3. Sous *Type d'importation*, sélectionnez **Utilisateurs**.
4. Ajoutez votre fichier d'importation 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'importation.
{% endhint %}
6. Sélectionnez **Démarrer l'importation**.
Lorsque l'importation est terminée, un courriel de confirmation est envoyé. Les importations peuvent prendre jusqu'à 30 minutes, en fonction de la file d'attente et de la taille du fichier.
#### Champs
Les importations massives 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 (Requis) | chaîne | L'identifiant unique du compte auquel ce participant appartient. |
| id (Requis) | chaîne | L'identifiant unique fourni pour ce participant. |
| firstName | chaîne | Le prénom du participant. |
| lastName | chaîne | Le nom de famille du participant. |
| email | chaîne | L'adresse e-mail du participant. |
| referable | booléen | Indicateur utilisé par impact.com pour déterminer si un participant peut être référé.
Remarque : Le drapeau doit être orthographié avec seulement une r pour que le statut puisse être modifié avec succès.
|
| locale | chaîne | La locale du participant, utilisée pour [Internationalisation](https://help.impact.com/brand/fr/que-souhaitez-vous-apprendre/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program). La locale doit être au format `language_COUNTRY` où le code 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 [Internationalisation](https://help.impact.com/brand/fr/que-souhaitez-vous-apprendre/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program). Le code pays de l'utilisateur (ex. CA). |
| referredBy.code | chaîne | Le code de parrainage de l'avocat client qui a parrainé 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é optionnellement dans les widgets, les e-mails et les thèmes. Si vous fournissez une URL d'image de profil absolue, la taille d'image minimale est de 80px x 80px. |
| 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 locataire, si configuré. |
| customFields.{fieldName} | chaîne | Utilisez cette structure pour inclure un champ personnalisé de votre choix. |
| {% endtab %} | | |
{% tab title="Champs personnalisés" %}
[Les champs utilisateur personnalisés](https://help.impact.com/brand/fr/que-souhaitez-vous-apprendre/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained) permettent des données propres à vos participants. Vous pouvez définir les objectifs de votre programme pour se déclencher en fonction des informations contenues dans un champ utilisateur personnalisé.
{% hint style="info" %}
**Exemple**: Récompenser les participants lorsqu'ils renouvellent leur abonnement. Tout d'abord, incluez le champ personnalisé `customFields.subscriptionPaid` avec la valeur **oui**. Ensuite, définissez l'objectif pour qu'il se convertisse lorsque `customFields.subscriptionPaid` est égal à **oui**.
{% endhint %}
Ajoutez des champs personnalisés à l'en-tête de colonne dans ce format : `customFields.votreNomDeChampPersonnalise`.
{% hint style="info" %}
**Remarque :** Les champs personnalisés ne peuvent pas accepter de valeurs de type tableau ou objet.
{% endhint %}
{% endtab %}
{% endtabs %}
**Résultats**
Nous vous informons par e-mail lorsque votre importation est terminée. Vous pouvez télécharger les résultats d'importation depuis la  **\[Engage] → Reporting → Imports & Exports** page au sein 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'importation se termine avec succès, un fichier contenant les informations des participants sera généré et 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](https://help.impact.com/brand/fr/que-souhaitez-vous-apprendre/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained).
{% endtab %}
{% tab title="Erreurs" %}
Si des erreurs sont rencontrées pendant l'importation, 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'importation initial) qui a échoué, et les messages d'erreur associés.
| recordNumber | message | apiErrorCode | statusCode |
| ------------ | --------------------------------------------- | ----------------- | ---------- |
| 2 | Cette requête nécessite un id valide non vide | MAUVAISE\_REQUÊTE | 400 |
Dans l'éventualité peu probable où une erreur système se produirait et que l'importation soit interrompue, l'importation apparaîtra comme **abandonnée** et ne se rétablira pas. Veuillez contacter notre équipe Support si vous avez besoin d'une assistance supplémentaire.
{% endtab %}
{% endtabs %}