> 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 importations au format `.csv` ou `.jsonl`  . Veuillez consulter notre [fichier d’importation CSV exemple](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) et [fichier d’importation JSONL exemple](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) pour connaître la structure de fichier requise pour votre importation.

{% hint style="info" %}
**Remarque :** Nous recommandons que chaque importation ne dépasse pas 500 000 entrées.
{% endhint %}

#### Importer des participants en masse

1. Dans le menu de navigation de gauche, sélectionnez ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[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 les participants importés à un segment d’utilisateurs spécifique ou les en retirer, 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**.

Une fois l’importation terminée, un e-mail de confirmation est envoyé. Selon la file d’attente et la taille du fichier, l’importation peut prendre jusqu’à 30 minutes.

#### Champs

Les importations groupées d’utilisateurs prennent en charge les champs standard et les champs personnalisés du fichier importé. **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/integration-guides/for-brands/advocate/advocate-api/api-open-endpoints):

| Champ                     | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                              |
| ------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| accountId (obligatoire)   | chaîne  | Identifiant unique du compte auquel appartient ce participant.                                                                                                                                                                                                                                                                                                                                                           |
| id (obligatoire)          | chaîne  | Identifiant unique fourni pour ce participant.                                                                                                                                                                                                                                                                                                                                                                           |
| firstName                 | chaîne  | Prénom du participant.                                                                                                                                                                                                                                                                                                                                                                                                   |
| lastName                  | chaîne  | Nom du participant.                                                                                                                                                                                                                                                                                                                                                                                                      |
| email                     | chaîne  | Adresse e-mail du participant.                                                                                                                                                                                                                                                                                                                                                                                           |
| referable                 | booléen | <p>Indicateur utilisé par impact.com pour déterminer si un participant peut être recommandé.</p><p><strong>Remarque :</strong> L’indicateur doit être orthographié uniquement avec <em>un</em> <code>r</code> pour que le statut soit modifié avec succès.</p>                                                                                                                                                           |
| locale                    | chaîne  | La locale du participant, utilisée pour [l’internationalisation](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). La locale doit respecter le format `language_COUNTRY` où le code de langue doit être en minuscules et le code du pays en majuscules. Le séparateur doit être un trait de soulignement. |
| countryCode               | chaîne  | La locale du participant, utilisée pour [l’internationalisation](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). Le code du pays de l’utilisateur (par ex. CA).                                                                                                                                         |
| referredBy.code           | chaîne  | Le code de parrainage du client ambassadeur qui a recommandé 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 fourni).                                                                                                                                                                                                                                                                           |
| 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 fourni).                                                                                                                                                                                                                                                                              |
| dateCreated               | chaîne  | La date à laquelle ce participant a été créé dans votre programme Advocate.                                                                                                                                                                                                                                                                                                                                              |
| imageUrl                  | chaîne  | Utilisée facultativement dans les widgets, les e-mails et les thèmes. Si vous fournissez une URL absolue vers une image de profil, celle-ci doit mesurer au minimum 80 px × 80 px.                                                                                                                                                                                                                                       |
| dateUsTaxFormSubmitted    | integer | La date à laquelle le formulaire fiscal W-9 d’un participant a été marqué comme collecté. Utilisée pour la conformité W-9 de votre tenant, si cette option est configurée.                                                                                                                                                                                                                                               |
| 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](https://help.impact.com/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’ajouter des données propres à vos participants. Vous pouvez configurer les objectifs de votre programme afin 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. Pour commencer, incluez le champ personnalisé `customFields.subscriptionPaid` avec la valeur **oui**. Définissez ensuite l’objectif pour qu’il soit atteint lorsque `customFields.subscriptionPaid` est égal à **oui**.
{% endhint %}

Ajoutez les champs personnalisés à l’en-tête de colonne sous ce format : `customFields.yourCustomFieldName`.

{% 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 informerons par e-mail lorsque votre importation sera terminée. Vous pouvez télécharger les résultats de l’importation depuis la page ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Reporting → Imports & Exports** de votre programme Advocate.

{% hint style="warning" %}
**Avertissement :** Les liens de téléchargement expirent au bout de 30 jours.
{% endhint %}

{% tabs %}
{% tab title="Importation réussie" %}
Si l’importation aboutit, 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 de notre [rapport sur les détails des utilisateurs](https://help.impact.com/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 surviennent pendant l’importation, un fichier supplémentaire sera généré. Ce fichier répertorie chaque erreur, notamment le numéro de ligne de l’enregistrement (dans le fichier d’importation initial) qui a échoué, ainsi que les messages d’erreur associés.

| recordNumber | message                                                   | apiErrorCode | statusCode |
| ------------ | --------------------------------------------------------- | ------------ | ---------- |
| 2            | Cette requête nécessite un identifiant valide et non vide | BAD\_REQUEST | 400        |

Dans le cas peu probable où une erreur système se produirait et interromprait l’importation, celle-ci apparaîtra comme **interrompue** et ne reprendra pas. Si vous avez besoin d’aide supplémentaire, veuillez contacter notre équipe d’assistance.
{% 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=<question>&goal=<user_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.
