# Importer des participants Advocate en masse

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 ![](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 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 | <p>Indicateur utilisé par impact.com pour déterminer si un participant peut être référé.</p><p><strong>Remarque :</strong> Le drapeau doit être orthographié avec seulement <em>une</em> <code>r</code> pour que le statut puisse être modifié avec succès.</p>                                                                                            |
| locale                    | chaîne  | La locale du participant, utilisée pour [Internationalisation](https://help.impact.com/brand/fr/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/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/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 ![](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** 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/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 %}
